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

Статья
08/27/2023

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

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

Синтаксис

int EnumFontsA(
  [in] HDC           hdc,
  [in] LPCSTR        lpLogfont,
  [in] FONTENUMPROCA lpProc,
  [in] LPARAM        lParam
);

Параметры

[in] hdc

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

[in] lpLogfont

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

[in] lpProc

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

[in] lParam

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

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

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

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

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

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll