(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 oEditSession、 TF_SELECTION結構、 ITfContext：：GetSelection