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
 文字插入將會發生， 而 pacpStart 和 pacpEnd 參數將包含文字插入的結果。 TS_TEXTCHANGE 結構必須填入這個旗標。
TF_IAS_NOQUERY
 插入文字、 pacpStart 和 pacpEnd 參數的值可以是 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
 呼叫端沒有文件的鎖定。

備註

pacpStart 和 pacpEnd 參數的值取決於用戶端應用程式如何將物件插入檔中。 例如，如果應用程式在物件插入後於對象的開頭設定游標，則 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