Метод IDWriteFontFile::Analyze (dwrite.h)

Статья
08/23/2023

Анализирует файл и возвращает, представляет ли он шрифт и поддерживается ли тип шрифта системой шрифтов.

Синтаксис

HRESULT Analyze(
  [out]           BOOL                  *isSupportedFontType,
  [out]           DWRITE_FONT_FILE_TYPE *fontFileType,
  [out, optional] DWRITE_FONT_FACE_TYPE *fontFaceType,
  [out]           UINT32                *numberOfFaces
);

Параметры

[out] isSupportedFontType

Тип: BOOL*

Значение TRUE , если тип шрифта поддерживается системой шрифтов; в противном случае — FALSE.

[out] fontFileType

Тип: DWRITE_FONT_FILE_TYPE*

При возврате этого метода содержит значение, указывающее тип файла шрифта. Обратите внимание, что даже если параметр isSupportedFontType имеет значение FALSE, значение fontFileType может отличаться от DWRITE_FONT_FILE_TYPE_UNKNOWN.

[out, optional] fontFaceType

Тип: DWRITE_FONT_FACE_TYPE*

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

[out] numberOfFaces

Тип: UINT32*

При возврате этого метода содержит количество лиц шрифтов, содержащихся в файле шрифта.

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

Тип: HRESULT

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

Важно Некоторые типы файлов шрифтов распознаются, но не поддерживаются системой шрифтов. Например, система шрифтов распознает файл как файл шрифта типа 1, но не сможет создать из него объект распознавания шрифта. В таких ситуациях анализ установит для выходного параметра isSupportedFontTypeзначение FALSE.

Требования


Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	dwrite.h
Библиотека	Dwrite.lib
DLL	Dwrite.dll

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

IDWriteFontFile

Share via