Функция EnumFontFamilies

Функция EnumFontFamilies перечисляет шрифты в заданном семействе шрифта, которые являются доступными на заданном устройстве.

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

Синтаксис

int EnumFontFamilies(
  HDC hdc,                        // дескриптор DC
  LPCTSTR lpszFamily,             // семейство шрифта
  FONTENUMPROC lpEnumFontFamProc, // функция повторного вызова
  LPARAM lParam                   // дополнительные данные
);

Параметры

hdc

[in] Дескриптор контекста устройства.

lpszFamily

[in] Указатель на символьную строку с нулем в конце, которая определяет имя семейства требуемых шрифтов. Если параметр lpszFamily имеет значение ПУСТО (NULL), функция EnumFontFamilies выбирает и перечисляет один шрифт каждого доступного типа семейства.

lpEnumFontFamProc

[in] Указывает на определяемую приложением функцию повторного вызова. Для информации, см. функцию EnumFontFamProc.

lParam

[in] Указатель на предоставляемые приложением данные. Данные передаются в функцию повторного вызова наряду с информацией о шрифте.

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

Возвращаемое значение - последнее значение, возвращенное функцией повторного вызова. Его значение - конкретная реализация.

Замечания

Для каждого шрифта, имеющего название гарнитуры заданное параметром lpszFamily, функция EnumFontFamilies извлекает информацию об этом шрифте и передает ее в функцию, указанную параметром lpEnumFontFamProc . Определяемая приложением функция повторного вызова может обрабатывать информацию о шрифте как требуется. Перечисление продолжается до тех пор, пока не закончатся шрифты, или пока функция повторного вызова не возвратит нуль.

Шрифты для многих восточно-азиатских языков имеют два названия гарнитуры шрифта: английское и местное название. Функции EnumFonts, EnumFontFamilies и EnumFontFamiliesEx возвращают английское название гарнитуры шрифта, если язык конкретной страны в системе не соответствует языку шрифта.

Windows 95/98/Me: EnumFontFamiliesW поддерживается подпрограммой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в требованиях этой подпрограммы для систем.

Код примера

Пример смотри в статье Перечисление установленных шрифтов.

Смотри также

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

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

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

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

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