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

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

Синтаксис

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

Параметры

fontFile

Тип: IDWriteFontFile*

Предоставленный пользователем файл шрифта, представляющий лицо шрифта.

faceIndex

Тип: UINT32

Отсчитываемый от нуля индекс лица шрифта в случаях, когда файл шрифта содержит коллекцию лиц шрифта. Если файл шрифта содержит одно лицо, присвойте этому значению значение нулю.

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