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

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

Синтаксис

HRESULT GetMatchingFonts(
  DWRITE_FONT_PROPERTY const   *fontProperty,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  IDWriteFontSet1              **matchingFonts
);

Параметры

fontProperty

Тип: DWRITE_FONT_PROPERTY const *

Свойство шрифта, интересующее вас, например типографическое семейство или типографическое семейство или семейство стрейч/стилей.

fontAxisValues

Тип: DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

Тип: UINT32

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

matchingFonts

Тип: IDWriteFontSet1**

Адрес указателя на интерфейс IDWriteFontSet 1. При успешном завершении функция задает указатель на приоритетный список шрифтов, соответствующих свойствам, в противном случае он задает указатель на nullptr.

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

Тип: HRESULT

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

Замечания

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

Требования