ITextStoreACP：：InsertTextAtSelection 方法 (textstor.h)

  • 發行項

ITextStoreACP：：InsertTextAtSelection 方法會在插入點或選取範圍插入文字。 呼叫端必須有檔的讀取/寫入鎖定，才能插入文字。

語法

HRESULT InsertTextAtSelection(
  [in]  DWORD         dwFlags,
  [in]  const WCHAR   *pchText,
  [in]  ULONG         cch,
  [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] pchText

要插入檔中之字串的指標。 字串可以是 NULL 終止。

[in] cch

指定文字長度。

[out] pacpStart

開始應用程式字元位置的指標，其中會插入文字。

[out] pacpEnd

結束應用程式字元位置的指標，其中會插入文字。 此參數值與插入點的 pacpStart 參數值相同。

[out] pChange

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

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

傳回值

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

值 描述
S_OK
 此方法成功。
TS_E_NOLOCK
 呼叫端沒有文件的鎖定。
E_INVALIDARG
 pchText 參數無效。

備註

pacpStart 和 pacpEnd 參數的值取決於用戶端應用程式如何將文字插入檔中。 例如，如果應用程式在插入文字之後，在插入的文字開頭設定游標，則 pacpStart 和 pacpEnd 參數的值與TS_TEXTCHANGE 結構的 acpStart 成員相同。

應用程式不應該呼叫 ITextStoreACPSink：：OnTextChange 方法，以回應此方法。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 textstor.h
Dll Msctf.dll
可轉散發套件 Windows 2000 專業版上的 TSF 1.0

另請參閱

成分

ITextStoreACP

ITextStoreACPSink：：OnTextChange

TF_IAS_* 常數

TS_TEXTCHANGE