共用方式為


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旗標。

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

使用此旗標來檢視文字插入的結果,而不實際插入文字,例如,預測折疊的結果或調整選取範圍的結果。 您不需要以此旗標填入 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 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 textstor.h
Dll Msctf.dll
可轉散發套件 Windows 2000 專業版上的 TSF 1.0

另請參閱

IDataObject

ITextStoreACP

TF_IAS_* 常數

TS_TEXTCHANGE