IDWriteFactory：：CreateFontFace 方法 (dwrite.h)

建立代表字型臉部的 物件。

語法

HRESULT CreateFontFace(
        DWRITE_FONT_FACE_TYPE   fontFaceType,
        UINT32                  numberOfFiles,
  [in]  IDWriteFontFile         * const *fontFiles,
        UINT32                  faceIndex,
        DWRITE_FONT_SIMULATIONS fontFaceSimulationFlags,
  [out] IDWriteFontFace         **fontFace
);

參數

fontFaceType

類型： DWRITE_FONT_FACE_TYPE

值，表示字型臉部的檔案格式類型。

numberOfFiles

類型： UINT32

表示字型臉部所需的字型檔案數目，以元素計數表示。

[in] fontFiles

類型：const IDWriteFontFile*

代表字型臉部的字型檔案物件。 由於 IDWriteFontFace 會維護對輸入字型檔案物件本身的參考，因此您可以在此呼叫之後釋出它們。

faceIndex

類型： UINT32

字型檔案包含字型臉部集合時，字型臉部的以零起始的索引。 如果字型檔案包含單一臉部，這個值應該是零。

fontFaceSimulationFlags

類型： DWRITE_FONT_SIMULATIONS

值，指出如果有任何字型臉部模擬旗標用於讓文字變成粗體或斜體，則會套用至目前的字型臉部。

[out] fontFace

類型： IDWriteFontFace**

當這個方法傳回時，會包含新建立字型臉部物件的指標位址，或發生失敗時為 Null 。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

需求

最低支援的用戶端	適用于 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

另請參閱

IDWriteFactory