ITfCandidateList ::SetResult, méthode (ctffunc.h)

Spécifie le résultat d’une opération de conversion pour une chaîne candidate spécifique.

Syntaxe

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

Paramètres

[in] nIndex

Spécifie l’index de base zéro de la chaîne candidate pour laquelle définir le résultat. Ce paramètre est ignoré si imcr contient CAND_CANCELED.

[in] imcr

Contient l’une des valeurs TfCandidateResult qui spécifie le résultat de l’opération de conversion.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Remarques

Une opération de conversion classique comprend les opérations suivantes.

1. Une liste de candidats est obtenue et affichée à l’utilisateur dans une boîte de dialogue.
2. Lorsque l’utilisateur sélectionne un candidat, mais avant que la boîte de dialogue ne soit ignorée, ITfCandidateList ::SetResult est appelé avec l’index du candidat et du CAND_SELECTED nouvellement sélectionnés.
3. Si un autre candidat est sélectionné, ITfCandidateList ::SetResult est appelé à nouveau avec l’index du candidat nouvellement sélectionné et CAND_SELECTED.
4. Si l’utilisateur choisit d’accepter le nouveau candidat, ITfCandidateList ::SetResult est appelé avec l’index du candidat sélectionné et CAND_FINALIZED.
5. Si l’utilisateur annule la boîte de dialogue, ITfCandidateList ::SetResult est appelé avec un index de zéro et CAND_CANCELED.

Configuration requise

Voir aussi

ITfCandidateList

TfCandidateResult