ITextRange::SetText メソッド (tom.h)
この範囲内のテキストを設定します。
構文
HRESULT SetText(
[in] BSTR bstr
);
パラメーター
[in] bstr
種類: BSTR
この範囲内の現在のテキストを置き換えるテキスト。 null の場合、現在のテキストは削除されます。
戻り値
種類: HRESULT
メソッドは HRESULT 値を返します。 メソッドが成功すると、 S_OKが返されます。 メソッドが失敗した場合は、次のいずれかのエラー コードが返されます。 COM エラー コードの詳細については、「COM でのエラー処理」を参照してください。
| リターン コード | 説明 |
|---|---|
|
テキストは書き込み保護されています。 |
|
bstr が null です。 |
|
メモリが不足しています。 |
解説
ITextRange::SetText は、範囲内のテキストを新しいテキストに置き換えます。 これに対し、 TypeText は選択範囲を テキスト bstr に置き換え、テキストを入力した場合と同様に、挿入されたテキストの直後に選択範囲を挿入ポイントとして残します。 UI の選択動作については、「 TypeText」を参照してください。
ITextRange::SetText を呼び出した後に ITextRange::GetText を呼び出すと、ITextRange::SetText メソッドで設定したテキストと同じテキストが返されます (他の範囲で呼び出しの間にそのテキストが変更されていない限り)。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | tom.h |
| [DLL] | Msftedit.dll |
関連項目
概念
リファレンス