ITextRange::SetFont メソッド (tom.h)
この範囲の文字属性を、指定した ITextFont オブジェクトの文字属性に設定します。
構文
HRESULT SetFont(
[in] ITextFont *pFont
);
パラメーター
[in] pFont
種類: ITextFont*
目的の文字形式を持つフォント オブジェクト。
戻り値
種類: HRESULT
メソッドは HRESULT 値を返します。 メソッドが成功すると、 S_OKが返されます。 メソッドが失敗した場合は、次のいずれかのエラー コードが返されます。 COM エラー コードの詳細については、「COM でのエラー処理」を参照してください。
リターン コード | 説明 |
---|---|
|
意味 |
|
テキストは保護されています。 |
|
pFont が null です。 |
|
メモリが不足しています。 |
注釈
形式を変更する場合は、 ITextRange::SetFont メソッドを使用します。 ただし、多数の文字書式を変更するには、フォントの複製を使用する方が効率的です。 これは、 などの range.font.bold = tomTrue
ステートメントを実行するたびに、フォント オブジェクトが割り当てられ、解放されるためです。 ただし、重複するフォントは 1 回割り当てることができ、何度も使用できます。 さらに、フォントの複製を保存し、 Reset メソッドを使用して既定または未定義の状態にリセットし、リッチ テキスト処理に必要に応じて値を指定できます。 フォントの重複を使用する方法を示すサンプル コードについては、「フォント重複 の使用」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | tom.h |
[DLL] | Msftedit.dll |
関連項目
概念
リファレンス