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

Статья
03/13/2024

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

Синтаксис

HFONT CreateFontIndirectExA(
  [in] const ENUMLOGFONTEXDVA *unnamedParam1
);

Параметры

[in] unnamedParam1

Указатель на структуру ENUMLOGFONTEXDV, которая определяет характеристики нескольких master шрифта.

Обратите внимание, что эта функция игнорирует член elfDesignVector в ENUMLOGFONTEXDV.

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

Если функция выполняется успешно, возвращается дескриптор новой структуры ENUMLOGFONTEXDV .

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке недоступны.

Функция CreateFontIndirectEx создает логический шрифт с характеристиками, указанными в структуре ENUMLOGFONTEXDV . При выборе этого шрифта с помощью функции SelectObject функция сопоставления шрифтов GDI пытается сопоставить логический шрифт с существующим физическим шрифтом. Если не удается найти точное совпадение, он предоставляет альтернативу, характеристики которой соответствуют как можно большему набору требуемых характеристик.

Если шрифт больше не нужен, вызовите функцию DeleteObject , чтобы удалить его.

Сопоставление шрифтов для CreateFont, CreateFontIndirect и CreateFontIndirectEx распознает как английский, так и локализованное имя шрифта независимо от языкового стандарта.

Примечание

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

Требования

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