Método IInkLineInfo::GetCandidate (msinkaut.h)
Retorna uma alternativa de reconhecimento da lista de resultados de reconhecimento.
Sintaxe
HRESULT GetCandidate(
[in] UINT nCandidateNum,
[out] LPWSTR pwcRecogWord,
[out] UINT *pcwcRecogWord,
[in] DWORD dwFlags
);
Parâmetros
[in] nCandidateNum
Índice baseado em zero da entrada de lista alternativa a ser recuperada.
[out] pwcRecogWord
Buffer no qual armazenar a alternativa de reconhecimento selecionada. Se pwcRecogWord for NULL, o método não tentará recuperar a palavra alternativa de reconhecimento.
[out] pcwcRecogWord
Passa o comprimento do buffer pwcRecogWord em caracteres Unicode e retorna o número de caracteres Unicode que foram copiados para o buffer.
[in] dwFlags
Não usado.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
O índice nCandidateNum é maior que o número de alternativas de reconhecimento. |
|
O buffer pwcRecogWord não é grande o suficiente para aceitar a alternativa de reconhecimento. |
Comentários
Se o parâmetro pwcRecogWord for nulo, o método não tentará recuperar a palavra alternativa de reconhecimento, mas apenas definirá pwcRecogWord como o número de caracteres na alternativa de reconhecimento.
Se o buffer pwcRecogWord não for grande o suficiente para conter a alternativa de reconhecimento, o buffer pwcRecogWord será preenchido com o primeiro número pwcRecogWord de caracteres da alternativa de reconhecimento.
Requisitos
| Cliente mínimo com suporte | Windows XP Tablet PC Edition [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | msinkaut.h |
| Biblioteca | InkObj.dll |