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

Описания RDS

Приложения

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

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

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

А.5.19.22. rdsXGSetFont – установить шрифт

# Приложения

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

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

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

##### А.5.19.22. rdsXGSetFont – установить шрифт

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

      void RDSCALL rdsXGSetFontA(
        int Mask,       // Маска установки (RDS_GF*) или 0
        RDSCSTR Name,   // Имя шрифта (UTF8)
        int SizeHeight, // Высота или размер
        COLORREF Color, // Цвет
        int Charset,    // Набор символов
        int Escapement, // Угол поворота
        BOOL Bold,      // Жирность
        BOOL Italic,    // Курсив
        BOOL Underline, // Подчеркивание
        BOOL StrikeOut  // Перечеркивание
      );
      void RDSCALL rdsXGSetFontW(
        int Mask,       // Маска установки (RDS_GF*) или 0
        RDSWCSTR Name,  // Имя шрифта (UTF16)
        int SizeHeight, // Высота или размер
        COLORREF Color, // Цвет
        int Charset,    // Набор символов
        int Escapement, // Угол поворота
        BOOL Bold,      // Жирность
        BOOL Italic,    // Курсив
        BOOL Underline, // Подчеркивание
        BOOL StrikeOut  // Перечеркивание
      );
      // Функция-псевдоним
      void RDSCALL rdsXGSetFont(
        int Mask,       // Маска установки (RDS_GF*) или 0
        RDSXCSTR Name,  // Имя шрифта (кодировка по умолчанию)
        int SizeHeight, // Высота или размер
        COLORREF Color, // Цвет
        int Charset,    // Набор символов
        int Escapement, // Угол поворота
        BOOL Bold,      // Жирность
        BOOL Italic,    // Курсив
        BOOL Underline, // Подчеркивание
        BOOL StrikeOut  // Перечеркивание
      );

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

RDS_VISICrIIBBBB (для UTF8) или RDS_VIWsICrIIBBBB (для UTF16)

Параметры

Mask(int)
  Набор битовых флагов, указывающих, какие параметры шрифта нужно установить, или 0, если нужно установить все параметры сразу. Можно использовать следующие флаги:

  RDS_GFNAME | Установить имя шрифта, переданное в параметре Name.
  RDS_GFSIZE | Установить размер шрифта в типографских точках (points), переданный в параметре SizeHeight. Не может использоваться одновременно с флагом RDS_GFHEIGHT.
  RDS_GFHEIGHT | Установить высоту шрифта в точках экрана, переданную в параметре SizeHeight. Не может использоваться одновременно с флагом RDS_GFSIZE.
  RDS_GFCHARSET | Установить набор символов шрифта, переданный в параметре Charset.
  RDS_GFESCAPEMENT | Установить угол поворота шрифта в градусах, переданный в параметре Escapement.
  RDS_GFCOLOR | Установить цвет шрифта, переданный в параметре Color.
  RDS_GFBOLD | Установить жирность шрифта согласно параметру Bold.
  RDS_GFITALIC | Установить курсив шрифта согласно параметру Italic.
  RDS_GFUNDERLINE | Установить подчеркивание шрифта согласно параметру Underline.
  RDS_GFSTRIKEOUT | Установить зачеркивание шрифта согласно параметру StrikeOut.

  Все эти флаги совпадают с флагами, используемыми функцией rdsWriteFontText. Кроме приведенных выше флагов, в параметре Mask можно указывать следующие константы, объединяющие несколько флагов вместе:

  RDS_GFFONTALLHEIGHT | Все указанные выше флаги, кроме RDS_GFSIZE (размер шрифта задается высотой в точках экрана).
  RDS_GFFONTBASIC | Все указанные выше флаги, кроме RDS_GFSIZE (размер шрифта задается высотой в точках экрана) и RDS_GFESCAPEMENT (угол поворота не устанавливается).
  RDS_GFFONTSTYLES | Жирность, курсив, зачеркивание и подчеркивание (флаги RDS_GFBOLD, RDS_GFITALIC, RDS_GFUNDERLINE и RDS_GFSTRIKEOUT).

Name(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Указатель на строку с именем шрифта.
SizeHeight(int)
  Размер шрифта в типографских точках (при указанном в Mask флаге RDS_GFSIZE) или в точках экрана (при указанном флаге RDS_GFHEIGHT).
Сolor(COLORREF)
  Цвет шрифта.
Charset(int)
  Стандартная константа Windows API, определяющая набор символов (язык) шрифта. Чаще всего употребляются следующие константы:

  ANSI_CHARSET | Шрифт ANSI.
  DEFAULT_CHARSET | Символы определяется названием и размером шрифта.
  RUSSIAN_CHARSET | Русские символы.
  SYMBOL_CHARSET | Различные символические обозначения.

  Полный список возможных наборов символов приведен в описании Windows API.
Escapement(int)
  Угол поворота шрифта в градусах относительно горизонтали.
Bold(BOOL)
  Шрифт жирный (TRUE) или обычный (FALSE).
Italic(BOOL)
  Курсив (TRUE) или обычный шрифт (FALSE).
Underline(BOOL)
  Шрифт подчеркнут (TRUE) или нет (FALSE).
StrikeOut(BOOL)
  Шрифт перечеркнут (TRUE) или нет (FALSE).

Примечания

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

Пример

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

См. также

rdsXGSetFontByParStr, rdsXGSetLogFont, rdsWriteFontText.