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.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_FAIL	Si è verificato un errore non specificato.

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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	ctffunc.h
DLL	Tiptsf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

ITfCandidateList

TfCandidateResult