ITextServices::TxSetText メソッド (textserv.h)

コントロール内のすべてのテキストを設定します。

構文

HRESULT TxSetText(
  [in] LPCWSTR pszText
);

[in] pszText

型: LPCTSTR

現在のテキストを置き換える文字列。

種類: HRESULT

メソッドが成功した場合、戻り値は S_OK。

メソッドが失敗した場合、戻り値は次の HRESULT コードです。 COM エラーコードの詳細については、「COM でのエラー処理」を参照してください。

リターンコード	説明
E_FAIL	テキストを更新できませんでした。

このメソッドは注意して使用する必要があります。基本的には、テキストサービスオブジェクトを新しいデータで再初期化します。元に戻す情報を含め、以前のデータと書式設定情報は失われます。

以前のデータがクリップボードにコピーされている場合、そのデータは破棄される前に ( OleFlushClipboard を介して) クリップボードに完全にレンダリングされます。

このメソッドでは、元に戻すことはできません。

テキストを設定するための 2 つの代替方法は、WM_SETTEXT と SetText です。