Compartilhar via


Método IInkStrokes::ToString (msinkaut.h)

[ToString não está mais disponível para uso a partir do Windows Vista. Em vez disso, consulte a propriedade String para o equivalente desse método para o objeto IInkRecognitionAlternate . ]

O reconhecedor padrão executa o reconhecimento na coleção de traços e retorna a cadeia de caracteres superior da principal alternativa do resultado do reconhecimento.

Sintaxe

HRESULT ToString(
  [out, retval] BSTR *ToString
);

Parâmetros

[out, retval] ToString

A cadeia de caracteres superior da propriedade TopAlternate do objeto IInkRecognitionResult , depois que o reconhecedor padrão executa o reconhecimento na coleção de traços.

Para obter mais informações sobre o tipo de dados BSTR , consulte Usando a biblioteca COM.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_POINTER
Um parâmetro continha um ponteiro inválido.
E_FAIL
Falha na operação.
E_OUTOFMEMORY
Sem memória.
E_INK_EXCEPTION
Ocorreu uma exceção dentro do método .
TPC_E_RECOGNIZER_NOT_REGISTERED
Nenhum reconhecedor está instalado, a chave do Registro de Reconhecedores está corrompida ou seu ambiente não dá suporte ao reconhecimento de manuscrito.

Comentários

ToString não deve ser usado para aplicativos de reconhecimento de manuscrito; ele pode ser usado para fins de depuração.

ToString retornará NULL se:

  • A coleção InkStrokes está vazia.
  • Não é possível criar um reconhecedor padrão.
  • O reconhecedor padrão não dá suporte à entrada gratuita.

Requisitos

Requisito Valor
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

IInkRecognizer Interface

Iinkstrokes

Coleção InkStrokes