Метод IDWriteFontResource::CreateFontFace (dwrite_3.h)

Статья
07/16/2024

Создает экземпляр лица шрифта с определенными значениями оси.

Синтаксис

HRESULT CreateFontFace(
        DWRITE_FONT_SIMULATIONS      fontSimulations,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontFace5             **fontFace
);

Параметры

fontSimulations

Тип: DWRITE_FONT_SIMULATIONS

Флаги моделирования лиц шрифта для алгоритмического эмболизации и курсивизации.

fontAxisValues

Тип: DWRITE_FONT_AXIS_VALUE const *

Указатель на массив, содержащий список значений осей шрифта. Массив должен быть размером (число элементов), указанным аргументом fontAxisValueCount.

fontAxisValueCount

Тип: UINT32

Количество значений оси шрифта, содержащихся в массиве fontAxisValues.

[out] fontFace

Тип: IDWriteFontFace5**

Адрес указателя на интерфейс IDWriteFontFace5. При успешном завершении функция задает указатель на только что созданный объект распознавания шрифта, в противном случае он задает указатель на nullptr.

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

Тип: HRESULT

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

Возвращаемое значение	Описание
DWRITE_E_REMOTEFONT	Шрифт не является локальным.

Замечания

Указанные значения оси могут быть подмножеством или супермножеством всех, которые фактически поддерживаются шрифтом. Любые неопределенные оси используют значения по умолчанию: значения за пределами диапазонов зажаты, а любые не изменяющиеся оси не имеют эффекта.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Сборка Windows 10 16299
минимальный поддерживаемый сервер	Сборка Windows 10 16299
целевая платформа	Виндоус
заголовка	dwrite_3.h
библиотеки	Dwrite.lib

Поделиться через