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
挿入されたオブジェクトの位置。 省略可能。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| 値 | 説明 |
|---|---|
|
メソッドは正常に実行されました。 |
|
ec パラメーターが無効な編集 Cookie です。 |
|
コンテキスト オブジェクトがドキュメント スタック上にありません。 |
|
コンテキストには選択がありません。 |
|
選択は読み取り専用です。 |
|
コンテキスト所有者は、 pDataObject パラメーターによって提供される型のオブジェクトを処理できません。 |
解説
呼び出し元は 、ITfQueryEmbedded::QueryInsertEmbedded メソッドを使用して、特定のオブジェクト型がこのメソッドで受け入れられる可能性があるかどうかを判断できます。
IDataObject オブジェクトの代わりにテキストを挿入するには、ITfInsertAtSelection::InsertTextAtSelection メソッドを使用します。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | msctf.h |
| [DLL] | Msctf.dll |
| 再頒布可能パッケージ | Windows 2000 Professional の TSF 1.0 |
関連項目
ITfEditSession::D oEditSession