iTfInsertAtSelection：：InsertTextAtSelection 方法 (msctf.h)

發行項
02/29/2024

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

語法

HRESULT InsertTextAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  const WCHAR  *pchText,
  [in]  LONG         cch,
  [out] ITfRange     **ppRange
);

參數

[in] ec

識別編輯內容。這是從 ITfDocumentMgr：：CreateContext 或 ITfEditSession：:D oEditSession 取得。

[in] dwFlags

具有下列其中一個值的位欄位。

值	意義
TF_IAS_NOQUERY	ppRange 為 NULL。此旗標無法與TF_IAS_QUERYONLY旗標結合。
TF_IAS_QUERYONLY	內容不會修改，但 ppRange 會設定為如同發生插入一樣。唯讀存取已足夠。如果未設定此旗標， ec 必須具有讀取/寫入許可權。此旗標無法與TF_IAS_NOQUERY旗標結合。
TF_IAS_NO_DEFAULT_COMPOSITION	如果需要組合，管理員將不會建立預設組合。呼叫端必須建立一個組合物件，該對象涵蓋插入的文字，再釋放內容鎖定。

[in] pchText

指定要插入的文字。

[in] cch

指定 pchText 中文字的字元計數。

[out] ppRange

接收插入物件的位置。

傳回值

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

值	描述
S_OK	此方法成功。
TF_E_NOLOCK	文字服務沒有文件鎖定
TF_E_DISCONNECTED	內容物件不在檔堆疊上。
TS_E_NOSELECTION	內容沒有選取範圍。
TS_E_READONLY	選取範圍是唯讀的。

備註

若要插入 IDataObject 物件而非文字，請使用 ITfInsertAtSelection：：InsertEmbeddedAtSelection。

規格需求

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