Metodo IInkLineInfo::GetCandidate (msinkaut.h)

Articolo
03/08/2023

Restituisce un riconoscimento alternativo dall'elenco dei risultati di riconoscimento.

Sintassi

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

Parametri

[in] nCandidateNum

Indice in base zero della voce di elenco alternativo da recuperare.

[out] pwcRecogWord

Buffer in cui archiviare il riconoscimento selezionato alternativo. Se pwcRecogWord è NULL, il metodo non tenta di recuperare la parola alternativa di riconoscimento.

[out] pcwcRecogWord

Passa la lunghezza del buffer pwcRecogWord in caratteri Unicode e restituisce il numero di caratteri Unicode copiati nel buffer.

[in] dwFlags

Non usato.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_FAIL	L'indice nCandidateNum è maggiore del numero di alternative di riconoscimento.
ERROR_MORE_DATA	Il buffer pwcRecogWord non è sufficiente per accettare il riconoscimento alternativo.

Commenti

Se il parametro pwcRecogWord è Null, il metodo non tenta di recuperare la parola alternativa di riconoscimento, ma imposta solo pwcRecogWord sul numero di caratteri nell'alternativa di riconoscimento.

Se il buffer pwcRecogWord non è sufficiente per contenere il riconoscimento alternativo, il buffer pwcRecogWord viene riempito con il primo numero di caratteri pwcRecogWord dal riconoscimento alternativo.

Requisiti


Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	msinkaut.h
Libreria	InkObj.dll

Vedi anche

IInkLineInfo

SetCandidate, metodo

Condividi tramite