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

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

Синтаксис

HRESULT GetMatchingFonts(
        WCHAR const                  *familyName,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontList2             **fontList
);

Параметры

familyName

Тип: WCHAR const *

Имя семейства шрифтов. Имя не учитывает регистр, но в противном случае должно точно соответствовать имени семейства в коллекции.

fontAxisValues

Тип: DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

Тип: UINT32

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

[out] fontList

Тип: IDWriteFontList2**

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

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

Тип: HRESULT

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

Комментарии

Если шрифты не совпадают, возвращается пустой объект списка (вызов IDWriteFontList::GetFontCount возвращает значение 0), но функция не возвращает ошибку.

Требования

Требование	Значение
Минимальная версия клиента	сборка Windows 10 20348
Минимальная версия сервера	сборка Windows 10 20348
Целевая платформа	Windows
Header	dwrite_3.h
Библиотека	Dwrite.lib