Share via

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

  • [アーティクル]

この範囲内のテキストを設定します。

構文

HRESULT SetText(
  [in] BSTR bstr
);

パラメーター

[in] bstr

種類: BSTR

この範囲内の現在のテキストを置き換えるテキスト。 null の場合、現在のテキストは削除されます。

戻り値

種類: HRESULT

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

リターン コード 説明
E_ACCESSDENIED
 テキストは書き込み保護されています。
E_INVALIDARG
 bstr が null です。
E_OUTOFMEMORY
 メモリが不足しています。

解説

ITextRange::SetText は、範囲内のテキストを新しいテキストに置き換えます。 これに対し、 TypeText は選択範囲を テキスト bstr に置き換え、テキストを入力した場合と同様に、挿入されたテキストの直後に選択範囲を挿入ポイントとして残します。 UI の選択動作については、「 TypeText」を参照してください。

ITextRange::SetText を呼び出した後に ITextRange::GetText を呼び出すと、ITextRange::SetText メソッドで設定したテキストと同じテキストが返されます (他の範囲で呼び出しの間にそのテキストが変更されていない限り)。

要件

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

関連項目

概念

GetText

ITextRange

リファレンス

Text オブジェクト モデル

TypeText