Метод IDWriteFactory3::CreateFontFaceReference(WCHARconst*,FILETIMEconst*,UINT32,DWRITE_FONT_SIMULATIONS,IDWriteFontFaceReference**) (dwrite_3.h)

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

Синтаксис

HRESULT CreateFontFaceReference(
  WCHAR const              *filePath,
  FILETIME const           *lastWriteTime,
  UINT32                   faceIndex,
  DWRITE_FONT_SIMULATIONS  fontSimulations,
  IDWriteFontFaceReference **fontFaceReference
);

Параметры

filePath

Тип: [in] WCHAR

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

lastWriteTime

Тип: [in, необязательно] FILETIME

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

faceIndex

Тип: UINT32

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

fontSimulations

Тип: DWRITE_FONT_SIMULATIONS

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

fontFaceReference

Тип: [out] IDWriteFontFaceReference**

Содержит вновь созданный объект ссылки на лицо шрифта или nullptr в случае сбоя.

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

Тип: HRESULT

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

Требования

Минимальная версия клиента	Windows 10 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Целевая платформа	Windows
Header	dwrite_3.h
Библиотека	Dwrite.lib
DLL	Dwrite.dll

См. также раздел

IDWriteFactory3