Функция EnumFontsProc

Функция EnumFontsProc - определяемая программой функция повторного вызова, которая обрабатывает данные о шрифте от функции EnumFonts. Тип FONTENUMPROC определяет указатель на эту функцию повторного вызова. EnumFontsProc - метка - заполнитель для имени определяемой приложением - функции.

Обратите внимание! на то, что функция предусматривается только для совместимости с 16-битовыми версиями Windows. Приложения должны вызывать функцию EnumFontFamiliesEx.

Синтаксис

int CALLBACK EnumFontsProc(
  CONST LOGFONT *lplf,     // данные о логическом шрифте
  CONST TEXTMETRIC *lptm,  // данные о физическом шрифте
  DWORD dwType,            // тип шрифта
  LPARAM lpData            // данные определяемые приложением
);

Параметры

lplf

[in] Указатель на структуру LOGFONT, которая содержит информацию об атрибутах логического шрифта.

Windows 2000/XP: Здесь это может быть структура ENUMLOGFONTEXDV.

lptm

[in] Указатель на структуру TEXTMETRIC, которая содержит информацию об атрибутах физического шрифта.

Windows 2000/XP: Здесь это может быть структура ENUMTEXTMETRIC.

dwType

[in] Устанавливает тип шрифта. Этим параметром может быть комбинация нижеследующих значений:

DEVICE_FONTTYPE
RASTER_FONTTYPE
TRUETYPE_FONTTYPE

lpData

[in] Указатель на определяемые программой данные переданные при помощи EnumFonts.

Возвращаемые значения

Возвращаемое значение должно быть не нуль, чтобы продолжить перечисление; чтобы остановить перечисление, оно должно равняться нулю.

Замечания

Оператор AND (&) может быть использован с константами RASTER_FONTTYPE и DEVICE_FONTTYPE, чтобы выяснить тип шрифта. Если в параметре FontType установлен бит RASTER_FONTTYPE , то шрифт либо растровый, либо векторный шрифт. Если этот бит единица, шрифт - растровый шрифт. Если этот бит - нуль, это - векторный шрифт.

Бит DEVICE_FONTTYPE параметра FontType устанавливает, является ли шрифт или базовым для устройства или базовым для GDI. Если бит равен единице, шрифт - шрифт встроенный в устройство; если он нуль, это - основной шрифт GDI.

Если устройство способно к преобразованиям текста (масштабирование, набор курсивом, и так далее), перечисляется только основной шрифт. Пользователь должен проверить способности устройства преобразовывать текст, чтобы определить, какие дополнительные шрифты являются доступными непосредственно из устройства.

Приложение должно зарегистрировать функцию EnumFontsProc, передавая ее адрес в функцию EnumFonts.

Смотри также

Обзор шрифты и текст, Функции, используемые шрифтами и текстом, EnumFonts, ENUMLOGFONTEXDV, ENUMTEXTMETRIC, LOGFONT, TEXTMETRIC

Размещение и совместимость EnumFontsProc
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Используемая библиотека	-
Заголовочный файл
- объявлено в	Wingdi.h
- включено в	Windows.h
Unicode	Прототипы объявляются как версии Unicode и ANSI.
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки