Método IInkRecognizerContext::p utref_Guide (msinkaut.h)

Obtém ou define o InkRecognizerGuide a ser usado para entrada de tinta.

Essa propriedade é de leitura/gravação.

Sintaxe

HRESULT putref_Guide(
  IInkRecognizerGuide *RecognizerGuide
);

Parâmetros

RecognizerGuide

Valor de retorno

Nenhum

Observações

A definição da propriedade Guide só será bem-sucedida se a coleção InkStrokes for NULL. Você deve definir a propriedade Guide antes de anexar a coleção InkStrokes ao InkRecognizerContext ou definir a coleção InkStrokes como NULL e, em seguida, definir o Guia (e possível reanexar a coleção InkStrokes).

A enumeração InkRecognizerCapabilities contém os sinalizadores IRC_FreeInput, IRC_LinedInput e IRC_BoxedInput . Esses sinalizadores especificam os recursos de um reconhecedor, mas como eles são somente leitura, não há como definir nenhum deles diretamente em um objeto IInkRecognizer ou InkRecognizerContext . A única maneira de colocar um reconhecedor em um modo específico é definir o guia usando a propriedade Guide . Se você não definir a propriedade Guide , o reconhecedor usará o modo FreeInput como padrão (se o reconhecedor for capaz disso). Outra maneira de definir o reconhecedor no modo FreeInput é definir a propriedade Guide como um objeto InkRecognizerGuide que tenha sua propriedade Columns definida como zero e sua propriedade Rows definida como zero.

Se você definir a propriedade Guide como um objeto InkRecognizerGuide que tenha sua propriedade Columns definida como zero e sua propriedade Rows definida como 1 ou mais, o reconhecedor estará no modo IRC_LinedInput (se o reconhecedor for capaz disso). O reconhecedor usa a propriedade Rows para controlar o número de linhas.

Se você definir a propriedade Guide para um objeto InkRecognizerGuide que tenha sua propriedade Rows definida como zero e sua propriedade Columns definida como 1 ou mais, o reconhecedor estará no modo IRC_LinedInput (se o reconhecedor for capaz disso) para gravação vertical. O reconhecedor usa a propriedade Columns para controlar o número de linhas verticais. Se o reconhecedor for capaz disso, a propriedade Capabilities do objeto IInkRecognizer retornará IRC_DownAndLeft ou IRC_DownAndRight ou ambos.

Se você definir a propriedade Guide como um objeto InkRecognizerGuide que tenha sua propriedade Columns definida como 1 ou mais e sua propriedade Rows definida como 1 ou mais, o reconhecedor estará no modo IRC_BoxedInput (se o reconhecedor for capaz disso).

Se você definir o modo como um que não está disponível desse reconhecedor, um erro será retornado.

Para obter informações sobre como consultar quais recursos ou modos estão disponíveis em um reconhecedor específico, consulte a propriedade Capabilities do objeto IInkRecognizer . Em geral, os reconhecedores do script latino dão suporte a entrada gratuita e entrada horizontal forrada, reconhecedores de caracteres do Leste Asiático dão suporte a entrada gratuita e entrada em caixa, e o reconhecedor de gestos só dá suporte à entrada gratuita.

Requisitos

Consulte também

Propriedade Capabilities

Propriedade Columns

IInkRecognizer Interface

Iinkrecognizercontext

Enumeração InkRecognizerCapabilities

Classe InkRecognizerContext

Classe InkRecognizerGuide

Coleção InkStrokes

Propriedade Rows