共用方式為


IDWriteFontFile::Analyze 方法 (dwrite.h)

分析檔案並傳回它是否代表字型,以及字型系統是否支援字型類型。

語法

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*

當這個方法傳回時,會包含指出字型檔案類型的值。 請注意,即使 isSupportedFontTypeFALSEfontFileType 值可能與 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 字型檔案,但無法從中建構字型臉部物件。 在這種情況下, Analyze 會將 isSupportedFontType 輸出參數設定為 FALSE
 

需求

   
最低支援的用戶端 適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 dwrite.h
程式庫 Dwrite.lib
Dll Dwrite.dll

另請參閱

IDWriteFontFile