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

  • [アーティクル]

ITfInsertAtSelection::InsertEmbeddedAtSelection メソッドは、選択範囲またはカーソル位置に IDataObject オブジェクトを挿入します。

構文

HRESULT InsertEmbeddedAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  IDataObject  *pDataObject,
  [out] ITfRange     **ppRange
);

パラメーター

[in] ec

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

[in] dwFlags

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

TF_IAS_NOQUERY

ppRange パラメーターは終了時に NULL です。

TF_IAS_QUERYONLY

コンテキストは変更されませんが、挿入が発生した場合と同様に ppRange パラメーターが設定されます。 読み取り専用アクセスで十分です。 このフラグが設定されていない場合、 ec パラメーターには読み取り/書き込みアクセス権が必要です。

TF_IAS_NO_DEFAULT_COMPOSITION

コンポジションが必要な場合、TSF マネージャーは既定のコンポジションを作成しません。 呼び出し元は、コンテキスト ロックを解放する前に、挿入されたテキストをカバーするコンポジション オブジェクトを作成する必要があります。

[in] pDataObject

挿入するオブジェクトへのポインター。

[out] ppRange

挿入されたオブジェクトの位置。 省略可能。

戻り値

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

値 説明
S_OK
 メソッドは正常に実行されました。
TF_E_NOLOCK
 ec パラメーターが無効な編集 Cookie です。
TF_E_DISCONNECTED
 コンテキスト オブジェクトがドキュメント スタック上にありません。
TS_E_NOSELECTION
 コンテキストには選択がありません。
TS_E_READONLY
 選択は読み取り専用です。
TF_E_FORMAT
 コンテキスト所有者は、 pDataObject パラメーターによって提供される型のオブジェクトを処理できません。

解説

呼び出し元は 、ITfQueryEmbedded::QueryInsertEmbedded メソッドを使用して、特定のオブジェクト型がこのメソッドで受け入れられる可能性があるかどうかを判断できます。

IDataObject オブジェクトの代わりにテキストを挿入するには、ITfInsertAtSelection::InsertTextAtSelection メソッドを使用します。

要件

   
サポートされている最小のクライアント 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::InsertTextAtSelection

ITfQueryEmbedded::QueryInsertEmbedded