(msctf.h) ITfContext::SetSelection 方法
設定檔中的選取範圍。
語法
HRESULT SetSelection(
[in] TfEditCookie ec,
[in] ULONG ulCount,
[in] const TF_SELECTION *pSelection
);
參數
[in] ec
包含可識別編輯會話的編輯 Cookie。 這是傳遞至 ITfEditSession::D oEditSession 的值。
[in] ulCount
指定 pSelection 陣列中的選取項目數目。
[in] pSelection
TF_SELECTION 結構的陣列,其中包含每個選取範圍的資訊。
傳回值
這個方法可以傳回下列其中一個值。
值 | 描述 |
---|---|
|
此方法成功。 |
|
檔沒有選取範圍。 |
|
ec 中的 Cookie 無效。 |
備註
選取範圍是醒目提示文字的範圍,如果範圍是空的,則為插入點,可識別檔內的使用者焦點區域。 有些文件能夠有多個選取專案。 pSelection 中只能有一個長度為零的選取範圍,因為它代表檔插入號的位置。
如果應用程式必須調整選取範圍所涵蓋的文字,它應該等到呼叫端放開鎖定為止。 不過,應用程式可以調整TF_SELECTION結構的任何樣式成員,同時仍傳回S_OK。
只有在設定了一個選取範圍時,呼叫端才能設定 fInterimChar 旗標。 在此情況下,選取範圍應該只會跨越一個字元,且TF_SELECTION結構的 ase 成員設定為TFAE_NONE。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | msctf.h |
Dll | Msctf.dll |
可轉散發套件 | Windows 2000 專業版上的 TSF 1.0 |
另請參閱
ITfContext 介面、 ITfEditSession::D oEditSession、 TF_SELECTION結構、 ITfContext::GetSelection