Приложения

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

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

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

А.5.19.28. rdsXGTextRect – строка текста с отсечением

Функция rdsXGTextRect выводит по указанным координатам указанную строку, ограничивая ее прямоугольной областью. Модель блока при этом должна быть вызвана для рисования.

  void RDSCALL rdsXGTextRectA(
    int X,int Y,   // Координаты
    RDSCSTR Text,  // Строка (UTF8)
    RECT *pRect    // Область отсечения
  );
  void RDSCALL rdsXGTextRectW(
    int X,int Y,   // Координаты
    RDSWCSTR Text, // Строка (UTF16)
    RECT *pRect    // Область отсечения
  );
  // Функция-псевдоним
  void RDSCALL rdsXGTextRect(
    int X,int Y,   // Координаты
    RDSXCSTR Text, // Строка (кодировка по умолчанию)
    RECT *pRect    // Область отсечения
  );

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

RDS_VIISpR (для UTF8) или RDS_VIIWspR (для UTF16)

Параметры

X, Y (int)

Горизонтальная (X) и вертикальная (Y) координаты левого верхнего угла выводимой строки.

Text (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на выводимую строку.

pRect (RECT*)

Указатель на структуру описания прямоугольника RECT Windows API, который будет использован для ограничения вывода строки.

Примечания

Эта функция выводит строку, переданную в параметре Text, располагая левый верхний угол занимаемой ей области в точке (X,Y). Часть строки, вышедшая за пределы прямоугольной области pRect, выведена не будет. Строка выводится текущим шрифтом, прямоугольная область заполняется текущим цветом заливки. Функция выводит только одну строку, многострочные тексты не поддерживаются. Функция изменяет текущую точку рисования, поэтому rdsXGTextRect нельзя использовать внутри циклов, строящих ломаные линии функцией rdsXGLineTo.

См. также

rdsXGSetFont, rdsXGSetBrushStyle, rdsXGTextOut.