Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.19. Графические функции

А.5.19.10. rdsXGGetTextSize – получить размеры строки текста

Функция rdsXGGetTextSize возвращает ширину и высоту указанной строки текста в точках экрана, если вывести ее текущим установленным шрифтом. На момент вызова этой функции модель блока должна быть вызвана для рисования чего-либо.

  void RDSCALL rdsXGGetTextSizeA(
    RDSCSTR Text,  // Строка (UTF8)
    int *pWidth,   // Возвращаемая ширина
    int *pHeight   // Возвращаемая высота
  );
  void RDSCALL rdsXGGetTextSizeW(
    RDSWCSTR Text, // Строка (UTF16)
    int *pWidth,   // Возвращаемая ширина
    int *pHeight   // Возвращаемая высота
  );
  // Функция-псевдоним
  void RDSCALL rdsXGGetTextSize(
    RDSXCSTR Text, // Строка (кодировка по умолчанию)
    int *pWidth,   // Возвращаемая ширина
    int *pHeight   // Возвращаемая высота
  );

Тип указателя на эту функцию

RDS_VSpIpI (для UTF8) или RDS_VWspIpI (для UTF16)

Параметры

Text (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку текста, размеры которой определяются.

pWidth (int*)

Указатель на целую переменную, в которую функция должна записать ширину строки в точках экрана. Если вызывающей программе не нужна ширина строки, в этом параметре можно передать NULL.

pHeight (int*)

Указатель на целую переменную, в которую функция должна записать высоту строки в точках экрана. Если вызывающей программе не нужна высота строки, в этом параметре можно передать NULL.

Примечания

Эта функция возвращает размеры строки, если ее вывести текущим установленным шрифтом. Чаще всего она применяется для выравнивания выводимой строки относительно других графических объектов: сначала определяются размеры строки, затем вычисляются координаты ее левого верхнего угла, после чего строка выводится функциями rdsXGTextOut или rdsXGTextRect.

Пример

Пример использования функции rdsXGGetTextSize приведен в §2.10.1 руководства программиста.

См. также

rdsXGSetFont, rdsXGSetFontByParStr, rdsXGSetLogFont, rdsXGTextOut, rdsXGTextRect.