ITextStoreAnchor：：InsertTextAtSelection 方法 (textstor.h)

在插入點或選取範圍插入文字。

語法

HRESULT InsertTextAtSelection(
  [in]  DWORD       dwFlags,
  [in]  const WCHAR *pchText,
  [in]  ULONG       cch,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

參數

[in] dwFlags

指定 paStart 和 paEnd 參數是否包含文字插入的結果。

無法合併 TF_IAS_NOQUERY 和TF_IAS_QUERYONLY旗標。

值	意義
TF_IAS_NOQUERY	插入文字， ppaStart 和 ppaEnd 參數的值可以是 Null。 如果不需要插入文字的結果，請使用此旗標。
TF_IAS_QUERYONLY	不會插入文字，而且 ppaStart 和 ppaEnd 錨點包含文字插入的結果。 這些參數的值取決於應用程式如何在檔中實作文字插入。 使用此旗標來檢視文字插入的結果，而不實際插入文字。 可以插入長度為零的文字。

[in] pchText

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

[in] cch

指定文字長度。

[out] ppaStart

插入文字開頭之錨點物件的指標。

[out] ppaEnd

插入文字結尾之錨點物件的指標。 針對插入點，此參數值會與 ppaStart 參數的值相同。

傳回值

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

值	描述
S_OK	此方法成功。
E_FAIL	方法無法具現化其中一個錨點 paStart 或 paEnd。
E_INVALIDARG	pchText參數無效。
TS_E_NOLOCK	呼叫端沒有檔的鎖定。

規格需求

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

另請參閱

成分

ITextStoreAnchor

ITextStoreAnchorSink：：OnTextChange

TF_IAS_* 常數

TS_TEXTCHANGE