共用方式為

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
 文字插入將會發生，而 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 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 textstor.h
Dll Msctf.dll

另請參閱

IDataObject

ITextStoreACP2

TF_IAS_* 常數

TS_TEXTCHANGE