共用方式為


ITextStoreAnchor::InsertEmbeddedAtSelection 方法 (textstor.h)

ITextStoreAnchor::InsertEmbeddedAtSelection 方法會在插入點或選取範圍插入 IDataObject 物件。 呼叫這個方法的客戶端必須具有讀取/寫入鎖定,才能將 IDataObject 插入文字數據流。

語法

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

參數

[in] dwFlags

指定 paStartpaEnd 參數是否將包含物件插入的結果。

無法合併 TF_IAS_NOQUERY 和TF_IAS_QUERYONLY旗標。

意義
TF_IAS_NOQUERY
插入文字, ppaStartppaEnd 參數的值可以是 NULL。 如果不需要文字插入的結果,請使用這個旗標。
TF_IAS_QUERYONLY
不會插入文字,而且 ppaStartppaEnd 錨點包含文字插入的結果。 這些參數的值取決於應用程式如何實作檔中的文字插入。

使用此旗標來檢視文字插入的結果,而不實際插入文字,例如,預測折疊的結果或調整選取範圍的結果。

[in] pDataObject

要插入之 IDataObject 物件的指標。

[out] ppaStart

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

[out] ppaEnd

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

傳回值

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

描述
S_OK
此方法成功。
E_FAIL
方法無法具現化其中一個錨點 paStartpaEnd
E_INVALIDARG
pchText 參數無效。
E_OUTOFMEMORY
方法無法具現化其中一個錨點 paStartpaEnd
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

另請參閱

IDataObject

ITextStoreAnchor

ITextStoreAnchor::QueryInsertEmbedded

ITextStoreAnchor::SetText

TF_IAS_* 常數

TS_CHAR_EMBEDDED