ITextStoreACP2::InsertEmbeddedAtSelection 方法 (textstor.h)

在插入點或選取範圍插入 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旗標。

意義
0
文字插入將會發生,而 pacpStartpacpEnd 參數將包含文字插入的結果。 TS_TEXTCHANGE 結構必須填入此旗標。
TF_IAS_NOQUERY
插入文字、 pacpStartpacpEnd 參數的值可以是 Null,而且必須填入 TS_TEXTCHANGE 結構。 如果不需要插入文字的結果,請使用此旗標。
TF_IAS_QUERYONLY
不會插入文字,而且 pacpStart 和 pacpEnd參數的值包含文字插入的結果。 這些參數的值取決於應用程式如何在檔中實作文字插入。 如需詳細資訊,請參閱<備註>一節。

使用此旗標來檢視文字插入的結果,而不實際插入文字,例如,預測折迭的結果或調整選取範圍的結果。 您不需要以這個旗標填入 TS_TEXTCHANGE 結構。

[in] pDataObject

要插入之 IDataObject 物件的指標。

[out] pacpStart

開始應用程式字元位置的指標,插入物件的位置。

[out] pacpEnd

結束應用程式字元位置的指標,插入物件的位置。 此參數值會與插入點的 pacpStart 參數值相同。

[out] pChange

具有下列成員 之TS_TEXTCHANGE 結構的指標。

意義
acpStart
物件插入檔之前起始的應用程式字元位置。
acpOldEnd
物件插入檔之前結束的應用程式字元位置。 此值與插入點 的 acpStart 相同。 如果此值與 acpStart不同,則會在插入物件之前選取文字。
acpNewEnd
物件插入之後的結束應用程式字元位置。

傳回值

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

說明
S_OK
此方法成功。
E_INVALIDARG
pchText參數無效。
TS_E_NOLOCK
呼叫端沒有檔的鎖定。

備註

pacpStartpacpEnd參數的值取決於用戶端應用程式如何將物件插入檔中。 例如,如果應用程式在物件插入之後于物件開頭設定資料指標,則 pacpStart 和 pacpEnd參數的值與TS_TEXTCHANGE結構的acpStart成員相同。

規格需求

   
最低支援的用戶端 Windows 8 [傳統型應用程式|UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式|UWP 應用程式]
目標平臺 Windows
標頭 textstor.h
DLL Msctf.dll

另請參閱

IDataObject

ITextStoreACP2

TF_IAS_* 常數

TS_TEXTCHANGE