Текущий раздел:

Описания RDS

Приложения

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

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

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

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

# Приложения

## Приложение А. Функции, константы и структуры 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.