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

Статья
11/20/2024

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

Синтаксис

HRESULT CreateFontFaceReference(
        DWRITE_FONT_SIMULATIONS      fontSimulations,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontFaceReference1    **fontFaceReference
);

Параметры

fontSimulations

Тип: DWRITE_FONT_SIMULATIONS

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

fontAxisValues

Тип: DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

Тип: UINT32

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

[out] fontFaceReference

Тип: IDWriteFontFaceReference1**

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

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

Тип: HRESULT

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

Замечания

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

Требования

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

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