ITextStoreAnchor：：InsertEmbeddedAtSelection 方法 (textstor.h)

發行項
03/05/2024

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 錨點包含文字插入的結果。這些參數的值取決於應用程式如何實作檔中的文字插入。使用此旗標來檢視文字插入的結果，而不實際插入文字，例如，預測折疊的結果或調整選取範圍的結果。

[in] pDataObject

要插入之 IDataObject 物件的指標。

[out] ppaStart

插入物件開頭之錨點物件的指標。

[out] ppaEnd

插入物件結尾之錨點物件的指標。對於插入點，此參數值會與 ppaStart 參數的值相同。

傳回值

這個方法可以傳回下列其中一個值。

值	描述
S_OK	此方法成功。
E_FAIL	方法無法具現化其中一個錨點 paStart 或 paEnd。
E_INVALIDARG	pchText 參數無效。
E_OUTOFMEMORY	方法無法具現化其中一個錨點 paStart 或 paEnd。
TS_E_NOLOCK	呼叫端沒有文件的鎖定。

備註

客戶端必須使用此方法將物件插入文字數據流，因為無法將TS_CHAR_EMBEDDED 常數傳遞至 ITextStoreAnchor：：SetText。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	textstor.h
Dll	Msctf.dll
可轉散發套件	Windows 2000 專業版上的 TSF 1.0