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

Статья
11/20/2024

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

Синтаксис

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**

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

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

Тип: HRESULT

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

Замечания

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Сборка Windows 10 16299
минимальный поддерживаемый сервер	Сборка Windows 10 16299
целевая платформа	Виндоус
заголовка	dwrite_3.h
библиотеки	Dwrite.lib

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