IInkLineInfo::GetCandidate-Methode (msinkaut.h)
Gibt eine alternative Erkennung aus der Erkennungsergebnisliste zurück.
HRESULT GetCandidate(
[in] UINT nCandidateNum,
[out] LPWSTR pwcRecogWord,
[out] UINT *pcwcRecogWord,
[in] DWORD dwFlags
);
[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.
Diese Methode kann einen dieser Werte zurückgeben.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der nCandidateNum-Index ist größer als die Anzahl der Erkennungswechsel. |
|
Der pwcRecogWord-Puffer ist nicht groß genug, um die Alternative zur Erkennung zu akzeptieren. |
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.
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 |