共用方式為


IDWriteFontFace::GetFiles 方法 (dwrite.h)

取得代表字型臉部的字型檔案。

語法

HRESULT GetFiles(
  [in, out]       UINT32          *numberOfFiles,
  [out, optional] IDWriteFontFile **fontFiles
);

參數

[in, out] numberOfFiles

類型: UINT32*

如果 fontFilesNull,則會收到代表字型臉部的檔案數目。 否則,應該傳遞所要求的字型檔案數目。 如需詳細資訊,請參閱下面的一節。

[out, optional] fontFiles

類型: IDWriteFontFile**

當這個方法傳回時,會包含使用者提供的陣列指標,此陣列會儲存代表字型臉部之字型檔案的指標。 如果使用者只想要代表字型的檔案數目,這個參數可以是 Null 。 此 API 會遞增根據 COM 慣例傳回的字型檔案指標參考計數,而且用戶端應該在完成時釋出這些指標。

傳回值

類型: HRESULT

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

備註

IDWriteFontFace::GetFiles方法應該呼叫兩次。 第一次呼叫 GetFilesfontFiles 應該是 Null。 當方法傳回時, numberOfFiles 會收到代表字型臉部的字型檔案數目。

然後,再次呼叫 方法,傳遞輸出第一次呼叫 的 numberOfFiles 值,以及正確大小的非 Null 緩衝區,以儲存 IDWriteFontFile 指標。

需求

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

另請參閱

IDWriteFontFace