Функция EnumFontsW (wingdi.h)

Статья
11/20/2024

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

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

Синтаксис

int EnumFontsW(
  [in] HDC           hdc,
  [in] LPCWSTR       lpLogfont,
  [in] FONTENUMPROCW lpProc,
  [in] LPARAM        lParam
);

Параметры

[in] hdc

Дескриптор контекста устройства, из которого перечисляются шрифты.

[in] lpLogfont

Указатель на строку, завершающуюся значением NULL, которая указывает имя шрифта, требуемого шрифта. Если lpFaceName имеет значение NULL , EnumFonts случайным образом выбирает и перечисляет один шрифт каждого доступного шрифта.

[in] lpProc

Указатель на определяемую приложением функциюallback. Дополнительные сведения см. в разделе EnumFontsProc.

[in] lParam

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

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

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

Замечания

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

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

Заметка

Заголовок wingdi.h определяет EnumFonts в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll