IInkLineInfo::GetCandidate-Methode (msinkaut.h)

Artikel
08/24/2023

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

Freigeben über