ITextStoreACP::InsertEmbeddedAtSelection メソッド (textstor.h)
ITextStoreACP::InsertEmbeddedAtSelection メソッドは、挿入ポイントまたは選択範囲に IDataObject オブジェクトを挿入します。 このメソッドを呼び出すクライアントは、 IDataObject オブジェクトをドキュメントに挿入する前に、読み取り/書き込みロックが必要です。
構文
HRESULT InsertEmbeddedAtSelection(
[in] DWORD dwFlags,
[in] IDataObject *pDataObject,
[out] LONG *pacpStart,
[out] LONG *pacpEnd,
[out] TS_TEXTCHANGE *pChange
);
パラメーター
[in] dwFlags
pacpStart パラメーターと pacpEnd パラメーター、および TS_TEXTCHANGE 構造体にオブジェクト挿入の結果を含めるかどうかを指定します。
TF_IAS_NOQUERYフラグとTF_IAS_QUERYONLY フラグを組み合わせることはできません。
[in] pDataObject
挿入する IDataObject オブジェクトへのポインター。
[out] pacpStart
オブジェクトの挿入が行われる開始アプリケーション文字位置へのポインター。
[out] pacpEnd
オブジェクトの挿入が行われる終了アプリケーション文字位置へのポインター。 このパラメーター値は、挿入ポイントの pacpStart パラメーターの値と同じになります。
[out] pChange
次のメンバーを 持つTS_TEXTCHANGE 構造体へのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
値 | 説明 |
---|---|
|
メソッドは正常に実行されました。 |
|
pchText パラメーターが無効です。 |
|
呼び出し元には、ドキュメントに対するロックがありません。 |
注釈
pacpStart パラメーターと pacpEnd パラメーターの値は、クライアント アプリケーションがドキュメントにオブジェクトを挿入する方法によって異なります。 たとえば、アプリケーションがオブジェクトの挿入後にオブジェクトの先頭にカーソルを設定した場合、pacpStart パラメーターと pacpEnd パラメーターの値は、TS_TEXTCHANGE構造体の acpStart メンバーと同じです。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | textstor.h |
[DLL] | Msctf.dll |
再頒布可能パッケージ | Windows 2000 Professional の TSF 1.0 |