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

Artigo
08/25/2023

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