Метод IDWriteFontSet4::GetMatchingFonts (dwrite_3.h)

Статья
07/16/2024

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

Синтаксис

HRESULT GetMatchingFonts(
  WCHAR const                  *familyName,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_SIMULATIONS      allowedSimulations,
  IDWriteFontSet4              **matchingFonts
);

Параметры

familyName

Тип: _In_z_ WCHAR const*

Имя семейства шрифтов. Это может быть: типографическое семейное имя, вес/растяжение или имя семейства стилей, имя семейства GDI (RBIZ) или полное имя.

fontAxisValues

Тип: _In_reads_(fontAxisValueCount) DWRITE_FONT_AXIS_VALUE const*

Массив значений осей шрифта.

fontAxisValueCount

Тип: UINT32

Количество значений оси шрифта.

allowedSimulations

Тип: DWRITE_FONT_SIMULATIONS

Указывает, какие имитации (т. е. алгоритмическая эмболия и/или косая черта) могут применяться к соответствующим шрифтам, чтобы лучше соответствовать указанным значениям оси. Если аргумент DWRITE_FONT_SIMULATIONS_NONE (0), то имитации не применяются.

matchingFonts

Тип: _COM_Outptr_ IDWriteFontSet4**

Получает указатель на только что созданный набор шрифтов, содержащий приоритетный список шрифтов, которые соответствуют указанным входным данным.

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

Тип: HRESULT

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

Замечания

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Сборка Windows 11 22621
заголовка	dwrite_3.h
библиотеки	Dwrite.lib
DLL	Dwrite.dll

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