共用方式為


(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 結構的陣列,其中包含每個選取範圍的資訊。

傳回值

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

描述
S_OK
此方法成功。
TF_E_NOSELECTION
檔沒有選取範圍。
TF_E_NOLOCK
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 oEditSessionTF_SELECTION結構ITfContext::GetSelection