共用方式為


ITfCandidateList::SetResult 方法 (ctffunc.h)

指定特定候選字串的重新復原作業結果。

語法

HRESULT SetResult(
  [in] ULONG             nIndex,
  [in] TfCandidateResult imcr
);

參數

[in] nIndex

指定要設定結果之候選字串的以零起始的索引。 如果 imcr 包含CAND_CANCELED,則會忽略此參數。

[in] imcr

包含其中一個 TfCandidateResult 值,指定重新復原作業的結果。

傳回值

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

描述
S_OK
此方法成功。
E_FAIL
發生未指定的錯誤。

備註

典型的重新復原作業會包含下列作業。

  1. 系統會取得候選項目清單,並在對話框中向用戶顯示。
  2. 當使用者選取候選專案,但在關閉對話方塊之前,會以新選取候選專案的索引呼叫 ITfCandidateList::SetResult ,並CAND_SELECTED。
  3. 如果選取了不同的候選專案,則會使用新選取候選專案的索引再次呼叫 ITfCandidateList::SetResult ,並CAND_SELECTED。
  4. 如果用戶選擇接受新的候選專案,則會使用目前所選候選專案的索引來呼叫 ITfCandidateList::SetResult ,並CAND_FINALIZED。
  5. 如果使用者取消對話框,則會使用索引為零且CAND_CANCELED呼叫 ITfCandidateList::SetResult

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 ctffunc.h
Dll Tiptsf.dll
可轉散發套件 Windows 2000 專業版上的 TSF 1.0

另請參閱

ITfCandidateList

TfCandidateResult