ITextRange::SetFont メソッド (tom.h)

  • [アーティクル]

この範囲の文字属性を、指定した ITextFont オブジェクトの文字属性に設定します。

構文

HRESULT SetFont(
  [in] ITextFont *pFont
);

パラメーター

[in] pFont

種類: ITextFont*

目的の文字形式を持つフォント オブジェクト。

戻り値

種類: HRESULT

メソッドは HRESULT 値を返します。 メソッドが成功すると、 S_OKが返されます。 メソッドが失敗した場合は、次のいずれかのエラー コードが返されます。 COM エラー コードの詳細については、「COM でのエラー処理」を参照してください。

リターン コード 説明
Value
 意味
E_ACCESSDENIED
 テキストは保護されています。
E_INVALIDARG
 pFont が null です。
E_OUTOFMEMORY
 メモリが不足しています。

注釈

形式を変更する場合は、 ITextRange::SetFont メソッドを使用します。 ただし、多数の文字書式を変更するには、フォントの複製を使用する方が効率的です。 これは、 などの range.font.bold = tomTrueステートメントを実行するたびに、フォント オブジェクトが割り当てられ、解放されるためです。 ただし、重複するフォントは 1 回割り当てることができ、何度も使用できます。 さらに、フォントの複製を保存し、 Reset メソッドを使用して既定または未定義の状態にリセットし、リッチ テキスト処理に必要に応じて値を指定できます。 フォントの重複を使用する方法を示すサンプル コードについては、「フォント重複 の使用」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー tom.h
[DLL] Msftedit.dll

関連項目

概念

ITextRange

リファレンス

リセット

Text オブジェクト モデル