Функция EnumFonts

Функция EnumFonts перечисляет шрифты, доступные на заданном устройстве. Для каждого шрифта с заданным названием гарнитуры шрифта, функция EnumFonts извлекает информацию об этом шрифте и передает ее в определяемую приложением функцию повторного вызова. Эта функция повторного вызова может обрабатывать информацию о шрифте как требуется. Перечисление продолжается до тех пор, пока не закончатся шрифты, или пока функция повторного вызова не возвратит нуль.

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

Синтаксис

int EnumFonts(
  HDC hdc,                  // дескриптор DC
  LPCTSTR lpFaceName,       // название гарнитуры шрифта
  FONTENUMPROC lpFontFunc,  // функция повторного вызова
  LPARAM lParam             // данные, предоставляемые приложением
);

Параметры

hdc

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

lpFaceName

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

lpFontFunc

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

lParam

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

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

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

Замечания

Используйте функцию EnumFontFamiliesEx вместо EnumFonts. Функция EnumFontFamiliesEx отличается от функции EnumFonts, тем, что она извлекает названия стиля, связанного с шрифтом TrueType. С EnumFontFamiliesEx, Вы можете извлекать информацию о стилях шрифта, которые не могут перечисляться, при использовании функции EnumFonts.

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

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

Смотри также

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

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

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

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

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