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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] unnamedParam1

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

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

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

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

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

Замечания

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

Если шрифт больше не нужен, вызовите функцию deleteObject .

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

Заметка

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

Требования

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