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

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

Не имеется

 

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

Hosted by uCoz