ITfInsertAtSelection::InsertTextAtSelection メソッド (msctf.h)

  • [アーティクル]

選択範囲または挿入ポイントにテキストを挿入します。

構文

HRESULT InsertTextAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  const WCHAR  *pchText,
  [in]  LONG         cch,
  [out] ITfRange     **ppRange
);

パラメーター

[in] ec

編集コンテキストを識別します。 これは、 ITfDocumentMgr::CreateContext または ITfEditSession::D oEditSession から取得されます。

[in] dwFlags

次のいずれかの値を持つビット フィールド。

値 意味
TF_IAS_NOQUERY
 ppRange は NULL です。 このフラグを TF_IAS_QUERYONLY フラグと組み合わせることはできません。
TF_IAS_QUERYONLY
 コンテキストは変更されませんが、挿入が発生したかのように ppRange が設定されます。 読み取り専用アクセスで十分です。 このフラグが設定されていない場合、 ec には読み取り/書き込みアクセス権が必要です。 このフラグを TF_IAS_NOQUERY フラグと組み合わせることはできません。
TF_IAS_NO_DEFAULT_COMPOSITION
 コンポジションが必要な場合、マネージャーは既定のコンポジションを作成しません。 呼び出し元は、コンテキスト ロックを解放する前に、挿入されたテキストをカバーするコンポジション オブジェクトを作成する必要があります。

[in] pchText

挿入するテキストを指定します。

[in] cch

pchText 内のテキストの文字数を指定します。

[out] ppRange

挿入されたオブジェクトの位置を受け取ります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 説明
S_OK
 メソッドは正常に実行されました。
TF_E_NOLOCK
 テキスト サービスにドキュメント ロックがない
TF_E_DISCONNECTED
 コンテキスト オブジェクトがドキュメント スタック上にありません。
TS_E_NOSELECTION
 コンテキストには選択がありません。
TS_E_READONLY
 選択は読み取り専用です。

注釈

テキストではなく IDataObject オブジェクトを挿入するには、 ITfInsertAtSelection::InsertEmbeddedAtSelection を使用します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー msctf.h
[DLL] Msctf.dll
再頒布可能パッケージ Windows 2000 Professional 上の TSF 1.0

こちらもご覧ください

Idataobject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfInsertAtSelection

ITfInsertAtSelection::InsertEmbeddedAtSelection