共用方式為

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*

當這個方法傳回時，會包含指出字型檔案類型的值。 請注意，即使 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 字型檔案，但無法從中建構字型臉部物件。 在這種情況下， 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