ITextStoreAnchor::InsertEmbeddedAtSelection メソッド (textstor.h)

[アーティクル]
08/26/2023

ITextStoreAnchor::InsertEmbeddedAtSelection メソッドは、IDataObject オブジェクトを挿入ポイントまたは選択範囲に挿入します。このメソッドを呼び出すクライアントでは、 IDataObject をテキストストリームに挿入する前に、読み取り/書き込みロックが必要です。

構文

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD       dwFlags,
  [in]  IDataObject *pDataObject,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

パラメーター

[in] dwFlags

paStart パラメーターと paEnd パラメーターにオブジェクト挿入の結果を含めるかどうかを指定します。

TF_IAS_NOQUERYフラグとTF_IAS_QUERYONLY フラグを組み合わせることはできません。

値	意味
TF_IAS_NOQUERY	テキストが挿入され、 ppaStart パラメーターと ppaEnd パラメーターの値は NULL にすることができます。テキストの挿入結果が不要な場合は、このフラグを使用します。
TF_IAS_QUERYONLY	テキストは挿入されず、 ppaStart アンカーと ppaEnd アンカーにはテキスト挿入の結果が含まれます。これらのパラメーターの値は、アプリケーションがドキュメントへのテキスト挿入をどのように実装するかによって異なります。このフラグを使用して、テキストを実際に挿入せずにテキスト挿入の結果を表示します。たとえば、折りたたみの結果を予測したり、選択範囲を調整したりします。

値

意味

TF_IAS_NOQUERY

テキストが挿入され、 ppaStart パラメーターと ppaEnd パラメーターの 値は NULL にすることができます。テキストの挿入結果が不要な場合は、このフラグを使用します。

TF_IAS_QUERYONLY

テキストは挿入されず、 ppaStart アンカーと ppaEnd アンカーにはテキスト挿入の結果が含まれます。これらのパラメーターの値は、アプリケーションがドキュメントへのテキスト挿入をどのように実装するかによって異なります。

このフラグを使用して、テキストを実際に挿入せずにテキスト挿入の結果を表示します。たとえば、折りたたみの結果を予測したり、選択範囲を調整したりします。

[in] pDataObject

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

[out] ppaStart

オブジェクト挿入の開始時のアンカーオブジェクトへのポインター。

[out] ppaEnd

オブジェクト挿入の最後にあるアンカーオブジェクトへのポインター。挿入ポイントの場合、このパラメーター値は ppaStart パラメーターの値と同じになります。

戻り値

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

値	説明
S_OK	メソッドは正常に実行されました。
E_FAIL	メソッドは、アンカー paStart または paEnd の 1 つをインスタンス化できませんでした。
E_INVALIDARG	pchText パラメーターが無効です。
E_OUTOFMEMORY	メソッドは、アンカー paStart または paEnd の 1 つをインスタンス化できませんでした。
TS_E_NOLOCK	呼び出し元は、ドキュメントに対するロックを持っていません。

注釈

TS_CHAR_EMBEDDED定数を ITextStoreAnchor::SetText に渡すことができないため、クライアントはこのメソッドを使用してオブジェクトをテキストストリームに挿入する必要があります。

要件

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