ITfCandidateList::SetResult-Methode (ctffunc.h)

Gibt das Ergebnis eines Reversionsvorgangs für die spezifische Kandidatenzeichenfolge an.

Syntax

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

Parameter

[in] nIndex

Gibt den nullbasierten Index der Kandidatenzeichenfolge an, für die das Ergebnis festgelegt werden soll. Dieser Parameter wird ignoriert, wenn imcr CAND_CANCELED enthält.

[in] imcr

Enthält einen der TfCandidateResult-Werte , der das Ergebnis des Reversionsvorgangs angibt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Ein typischer Reversionsvorgang umfasst die folgenden Vorgänge.

1. Eine Liste der Kandidaten wird abgerufen und dem Benutzer in einem Dialogfeld angezeigt.
2. Wenn der Benutzer einen Kandidaten auswählt, aber bevor das Dialogfeld geschlossen wird, wird ITfCandidateList::SetResult mit dem Index des neu ausgewählten Kandidaten aufgerufen und CAND_SELECTED.
3. Wenn ein anderer Kandidat ausgewählt wird, wird ITfCandidateList::SetResult mit dem Index des neu ausgewählten Kandidaten und CAND_SELECTED erneut aufgerufen.
4. Wenn der Benutzer den neuen Kandidaten akzeptiert, wird ITfCandidateList::SetResult mit dem Index des aktuell ausgewählten Kandidaten und CAND_FINALIZED aufgerufen.
5. Wenn der Benutzer das Dialogfeld abbricht, wird ITfCandidateList::SetResult mit einem Index von 0 und CAND_CANCELED aufgerufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	ctffunc.h
DLL	Tiptsf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITfCandidateList

TfCandidateResult