Método ITfCandidateList::SetResult (ctffunc.h)

Especifica o resultado de uma operação de reconversão para a cadeia de caracteres candidata específica de s.

Sintaxe

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

Parâmetros

[in] nIndex

Especifica o índice baseado em zero da cadeia de caracteres candidata para a qual definir o resultado. Esse parâmetro será ignorado se imcr contiver CAND_CANCELED.

[in] imcr

Contém um dos valores TfCandidateResult que especifica o resultado da operação de reconversão.

Retornar valor

Esse método pode retornar um desses valores.

Comentários

Uma operação típica de reconversão incluiria as operações a seguir.

1. Uma lista de candidatos é obtida e exibida para o usuário em uma caixa de diálogo.
2. Quando o usuário seleciona um candidato, mas antes que a caixa de diálogo seja ignorada, ITfCandidateList::SetResult é chamado com o índice do candidato recém-selecionado e CAND_SELECTED.
3. Se um candidato diferente for selecionado, ITfCandidateList::SetResult será chamado novamente com o índice do candidato recém-selecionado e CAND_SELECTED.
4. Se o usuário optar por aceitar o novo candidato, ITfCandidateList::SetResult será chamado com o índice do candidato atualmente selecionado e CAND_FINALIZED.
5. Se o usuário cancelar a caixa de diálogo, ITfCandidateList::SetResult será chamado com um índice de zero e CAND_CANCELED.

Requisitos

Confira também

ITfCandidateList

TfCandidateResult