Auf Englisch lesen

Freigeben über


IInkLineInfo::GetCandidate-Methode (msinkaut.h)

Gibt eine alternative Erkennung aus der Erkennungsergebnisliste zurück.

Syntax

HRESULT GetCandidate(
  [in]  UINT   nCandidateNum,
  [out] LPWSTR pwcRecogWord,
  [out] UINT   *pcwcRecogWord,
  [in]  DWORD  dwFlags
);

Parameter

[in] nCandidateNum

Nullbasierter Index des abzurufenden alternativen Listeneintrags.

[out] pwcRecogWord

Puffer, in dem die ausgewählte Erkennungs-Alternative gespeichert werden soll. Wenn pwcRecogWordNULL ist, versucht die Methode nicht, das alternative Erkennungswort abzurufen.

[out] pcwcRecogWord

Übergibt die Länge des pwcRecogWord-Puffers in Unicode-Zeichen und gibt die Anzahl der Unicode-Zeichen zurück, die in den Puffer kopiert wurden.

[in] dwFlags

Wird nicht verwendet.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich ausgeführt.
E_FAIL
Der nCandidateNum-Index ist größer als die Anzahl der Erkennungswechsel.
ERROR_MORE_DATA
Der pwcRecogWord-Puffer ist nicht groß genug, um die Alternative zur Erkennung zu akzeptieren.

Hinweise

Wenn der pwcRecogWord-Parameter NULL ist, versucht die Methode nicht, das Erkennungs-Alternative Wort abzurufen, sondern legt pwcRecogWord nur auf die Anzahl der Zeichen in der Erkennungs-Alternative fest.

Wenn der pwcRecogWord-Puffer nicht groß genug ist, um die Erkennungs-Alternative zu enthalten, wird der pwcRecogWord-Puffer mit der ersten pwcRecogWord-Anzahl von Zeichen aus der Erkennungs-Alternative gefüllt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile msinkaut.h
Bibliothek InkObj.dll

Weitere Informationen

IInkLineInfo

SetCandidate-Methode