Share via

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