Функция 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

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz