ITfCandidateList：：SetResult 方法 (ctffunc.h)

指定特定候选字符串的重新转换操作的结果。

语法

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

[in] nIndex

指定要为其设置结果的候选字符串的从零开始的索引。如果 imcr 包含CAND_CANCELED，则忽略此参数。

[in] imcr

包含指定重新转换操作结果的 TfCandidateResult 值之一。

此方法可以返回其中一个值。

值	说明
S_OK	方法成功。
E_FAIL	发生了未指定的错误。

典型的重新转换操作将包括以下操作。

获取候选项列表并在对话框中向用户显示。
当用户选择候选项时，但在关闭对话框之前， ITfCandidateList：：SetResult 会使用新所选候选项的索引调用，并CAND_SELECTED。
如果选择了其他候选项，则会使用新选定的候选项的索引再次调用 ITfCandidateList：：SetResult ，并CAND_SELECTED。
如果用户选择接受新候选项，则会使用当前所选候选项的索引调用 ITfCandidateList：：SetResult ，并CAND_FINALIZED。
如果用户取消对话框，则调用 ITfCandidateList：：SetResult ，索引为零，CAND_CANCELED。