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
);

[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.

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

Valeur	Description
S_OK	La méthode a réussi.
E_FAIL	Une erreur non spécifiée s'est produite.

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

Une liste de candidats est obtenue et affichée à l’utilisateur dans une boîte de dialogue.
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.
Si un autre candidat est sélectionné, ITfCandidateList ::SetResult est appelé à nouveau avec l’index du candidat nouvellement sélectionné et CAND_SELECTED.
Si l’utilisateur choisit d’accepter le nouveau candidat, ITfCandidateList ::SetResult est appelé avec l’index du candidat sélectionné et CAND_FINALIZED.
Si l’utilisateur annule la boîte de dialogue, ITfCandidateList ::SetResult est appelé avec un index de zéro et CAND_CANCELED.

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	ctffunc.h
DLL	Tiptsf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel