IInkLineInfo::SetCandidate-Methode (msinkaut.h)
Updates eine Erkennungs-Alternative in der Erkennungsergebnisliste, entweder durch Ersetzen eines vorhandenen Alternativen oder durch Hinzufügen eines Alternativen zur Liste.
Syntax
HRESULT SetCandidate(
[in] UINT nCandidateNum,
[in] LPWSTR strRecogWord
);
Parameter
[in] nCandidateNum
Nullbasierter Index des festzulegenden alternativen Listeneintrags.
[in] strRecogWord
Zeiger auf den neuen Alternativtext.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der nCandidateNum-Index liegt außerhalb des Bereichs. |
|
Der Vorgang konnte nicht abgeschlossen werden. Die Erkennungsergebnisliste wird nicht geändert. |
Hinweise
Die Kandidatenliste kann jeweils nur um einen neuen Eintrag am Ende der aktuellen Liste erweitert werden. Wenn z. B. das Text-Freihandobjekt (tInk) derzeit über zehn Erkennungsergebnisse verfügt, fügt das Festlegen des nCandidateNum-Parameters auf 10 der Erkennungsergebnisliste des Freihandobjekts ein neues Ergebnis hinzu.
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 |