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

Описания RDS

Приложения

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

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

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

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

Навигация:
<< >> Оглавление Указатель

Приложения

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

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

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

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

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

  void  rdsXGSetFontA(
    int Mask,       // Маска установки (RDS_GF*) или 0
     Name,   // Имя шрифта (UTF8)
    int SizeHeight, // Высота или размер
     Color, // Цвет
    int Charset,    // Набор символов
    int Escapement, // Угол поворота
     Bold,      // Жирность
     Italic,    // Курсив
     Underline, // Подчеркивание
     StrikeOut  // Перечеркивание
  );
  void  rdsXGSetFontW(
    int Mask,       // Маска установки (RDS_GF*) или 0
     Name,  // Имя шрифта (UTF16)
    int SizeHeight, // Высота или размер
     Color, // Цвет
    int Charset,    // Набор символов
    int Escapement, // Угол поворота
     Bold,      // Жирность
     Italic,    // Курсив
     Underline, // Подчеркивание
     StrikeOut  // Перечеркивание
  );
  // 
  void  rdsXGSetFont(
    int Mask,       // Маска установки (RDS_GF*) или 0
     Name,  // Имя шрифта (кодировка по умолчанию)
    int SizeHeight, // Высота или размер
     Color, // Цвет
    int Charset,    // Набор символов
    int Escapement, // Угол поворота
     Bold,      // Жирность
     Italic,    // Курсив
     Underline, // Подчеркивание
     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.

<< >> Оглавление Указатель