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 |