ITextRange：：SetFont 方法 (tom.h)

將此範圍的字元屬性設定為指定 之 ITextFont 物件的字元屬性。

語法

HRESULT SetFont(
  [in] ITextFont *pFont
);

參數

[in] pFont

類型： ITextFont*

具有所需字元格式的字型物件。

傳回值

類型： HRESULT

方法會傳回 HRESULT 值。 如果方法成功，它會 傳回S_OK。 如果方法失敗，它會傳回下列其中一個錯誤碼。 如需 COM 錯誤碼的詳細資訊，請參閱 COM 中的錯誤處理。

傳回碼	Description
值	意義
E_ACCESSDENIED	文字受到保護。
E_INVALIDARG	pFont 為 null。
E_OUTOFMEMORY	記憶體不足。

備註

針對偶爾的格式變更，請使用 ITextRange：：SetFont 方法。 不過，若要進行一些字元格式設定變更，使用字型重複會更有效率。 這是因為每次執行 類似 range.font.bold = tomTrue的語句時，都會配置並釋放字型物件。 不過，字型重複專案可以配置一次，並多次使用。 此外，您可以使用 Reset 方法儲存字型重複專案、將它重設為預設或未定義的狀態，並視需要提供 RTF 處理的值。 如需示範如何使用字型重複專案的範例程式代碼，請參閱 使用字型重複。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	tom.h
Dll	Msftedit.dll

另請參閱

概念

ITextRange

參考

重設

文字物件模型