Metodo ITfCandidateList::SetResult (ctffunc.h)

Specifica il risultato di un'operazione di ricoversione per la stringa candidata specifica.

Sintassi

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

Parametri

[in] nIndex

Specifica l'indice in base zero della stringa candidata per cui impostare il risultato. Questo parametro viene ignorato se imcr contiene CAND_CANCELED.

[in] imcr

Contiene uno dei valori TfCandidateResult che specifica il risultato dell'operazione di riconciliazione.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

Un'operazione di ricoversione tipica include le operazioni seguenti.

1. Un elenco di candidati viene ottenuto e visualizzato all'utente in una finestra di dialogo.
2. Quando l'utente seleziona un candidato, ma prima che la finestra di dialogo venga chiusa, ITfCandidateList::SetResult viene chiamato con l'indice del candidato appena selezionato e CAND_SELECTED.
3. Se viene selezionato un candidato diverso, ITfCandidateList::SetResult viene chiamato di nuovo con l'indice del candidato appena selezionato e CAND_SELECTED.
4. Se l'utente sceglie di accettare il nuovo candidato, ITfCandidateList::SetResult viene chiamato con l'indice del candidato attualmente selezionato e CAND_FINALIZED.
5. Se l'utente annulla la finestra di dialogo, ITfCandidateList::SetResult viene chiamato con un indice pari a zero e CAND_CANCELED.

Requisiti

Vedi anche

ITfCandidateList

TfCandidateResult