Método IInkLineInfo::SetCandidate (msinkaut.h)

Atualizações uma alternativa de reconhecimento na lista de resultados de reconhecimento, substituindo uma alternativa existente ou adicionando uma alternativa à lista.

Sintaxe

HRESULT SetCandidate(
  [in] UINT   nCandidateNum,
  [in] LPWSTR strRecogWord
);

Parâmetros

[in] nCandidateNum

Índice baseado em zero da entrada de lista alternativa a ser definida.

[in] strRecogWord

Ponteiro para o novo texto alternativo.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_FAIL	O índice nCandidateNum está fora do intervalo.
E_OUTOFMEMORY	Não foi possível concluir a operação. A lista de resultados do reconhecimento não foi alterada.

Comentários

A lista de candidatos só pode ser estendida por uma nova entrada por vez, no final da lista atual. Por exemplo, se o objeto de tinta de texto (tInk) tiver atualmente dez resultados de reconhecimento, definir o parâmetro nCandidateNum como 10 adicionará um novo resultado à lista de resultados de reconhecimento do objeto de tinta de texto.

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

Confira também

Método GetCandidate

IInkLineInfo