IDWriteFontFile_Analyze

ファイルを解析し、それがフォントを表しているか、またそのフォント種別がフォントシステムでサポートされているかを返す。

IDWriteFontFile_Analyze this, isSupportedFontType, fontFileType, fontFaceType, numberOfFaces

this : [comobj] IDWriteFontFile インターフェースの COM オブジェクト変数
isSupportedFontType : [var] 型: BOOL* フォントの種類がフォントシステムでサポートされている場合は TRUE、そうでない場合は FALSE。
fontFileType : [var] 型: DWRITE_FONT_FILE_TYPE* このメソッドが返るとき、フォントファイルの種類を示す値を格納する。たとえ isSupportedFontType が FALSE であっても、fontFileType の値は DWRITE_FONT_FILE_TYPE_UNKNOWN と異なる場合があることに注意。
fontFaceType : [var] 型: DWRITE_FONT_FACE_TYPE* このメソッドが返るとき、フォントフェイスの種類を示す値を格納する。fontFileType が DWRITE_FONT_FILE_TYPE_UNKNOWN と等しくない場合、その値からフォントファイルからフォントフェイスを構築できる。
numberOfFaces : [int] 型: UINT32* このメソッドが返るとき、フォントファイルに含まれるフォントフェイスの数を格納する。

(プラグイン / モジュール : com_misc.dll)

解説

ファイルを解析し、それがフォントを表しているか、またそのフォント種別がフォントシステムでサポートされているかを返す。

[戻り値]
型: HRESULT このメソッドが成功した場合は S_OK を返す。それ以外の場合は HRESULT エラーコードを返す。

[備考]
重要 一部のフォントファイル種別は認識はされるがフォントシステムではサポートされない。たとえばフォントシステムはファイルを Type 1
フォントファイルとして認識できるが、それからフォントフェイスオブジェクトを構築することはできない。このような状況では Analyze
は出力パラメータ isSupportedFontType を FALSE に設定する。

情報