Приложения

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

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

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

А.5.19.24. rdsXGSetLogFont – установить шрифт по структуре LOGFONT

Функция rdsXGSetLogFont устанавливает параметры шрифта согласно переданной структуре LOGFONT, если модель блока вызвана для рисования. Этот шрифт будет использоваться при выводе всех последующих текстов.

  void RDSCALL rdsXGSetLogFontA(
    LOGFONTA *pLogFont, // Структура описания (ANSI)
    COLORREF Color      // Цвет шрифта
  );
  void RDSCALL rdsXGSetLogFontW(
    LOGFONTW *pLogFont, // Структура описания (UTF16)
    COLORREF Color      // Цвет шрифта
  );
  // Функция-псевдоним
  void RDSCALL rdsXGSetLogFont(
    LOGFONT *pLogFont,  // Структура описания (кодировка по умолчанию)
    COLORREF Color      // Цвет шрифта
  );

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

RDS_VpLfCr (для ANSI) или RDS_VpLfwCr (для UTF16)

Параметры

pFont (LOGFONTA*, LOGFONTW*, LOGFONT*)

Указатель на структуру описания шрифта Windows LOGFONTA или LOGFONTW.

Color (COLORREF)

Цвет шрифта.

Примечания

Эта функция устанавливает параметры шрифта, читая их из полей структуры Windows API LOGFONT, переданной в параметре pPar. Этим шрифтом будут выводиться все текстовые строки во всех последующих вызовах. Поскольку в структуре LOGFONT не предусмотрено поле для описания цвета, цвет шрифта передается в параметре Color.

Следует обратить внимание на то, что функция с суффиксом «A», использующая структуру LOGFONTA, ожидает, что в поле названия гарнитуры шрифта (поле lfFaceName) записана строка в кодировке ANSI, а не UTF8, поскольку в Windows API отсутствует похожая структура для кодировки UTF8.

См. также

rdsXGSetFontByParStr, rdsXGSetFont.