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


Метод IDWriteFontSet::GetMatchingFonts(DWRITE_FONT_PROPERTYconst*,UINT32,IDWriteFontSet**) (dwrite_3.h)

Возвращает подмножество шрифтов, отфильтрованных по заданным свойствам.

Синтаксис

HRESULT GetMatchingFonts(
  DWRITE_FONT_PROPERTY const *properties,
  UINT32                     propertyCount,
  IDWriteFontSet             **filteredSet
);

Параметры

properties

Тип: [in] const DWRITE_FONT_PROPERTY*

Список свойств для фильтрации.

propertyCount

Тип: UINT32

Количество свойств для фильтрации.

filteredSet

Тип: [out] IDWriteFontSet**

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

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

Тип: HRESULT

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

Комментарии

Если ни один из шрифтов не соответствует фильтру, подмножество будет пустым (GetFontCount возвращает 0), но функция не возвращает ошибку. Подмножество всегда будет равно или меньше исходного набора. Если требуется отфильтровать только удаленные шрифты, можно передать значение NULL в свойствах и ноль в propertyCount.

Требования

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

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

IDWriteFontSet