Compartilhar via


Método IInkRecognizerContext::get_Guide (msinkaut.h)

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

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT get_Guide(
  IInkRecognizerGuide **RecognizerGuide
);

Parâmetros

RecognizerGuide

Valor retornado

Nenhum

Comentários

A definição da propriedade Guide só terá êxito 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á como padrão o modo FreeInput (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 como 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 neste 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 de script latino dão suporte à entrada gratuita e à entrada alinhada horizontal, os reconhecedores de caracteres do Leste Asiático dão suporte à entrada livre e à entrada em caixa, e o reconhecedor de gestos dá suporte apenas à entrada gratuita.

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

Propriedade Capabilities

Propriedade Columns

IInkRecognizer Interface

Iinkrecognizercontext

Enumeração InkRecognizerCapabilities

Classe InkRecognizerContext

Classe InkRecognizerGuide

Coleção InkStrokes

Propriedade Rows