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

Artículo
03/08/2023

Obtiene o establece inkRecognizerGuide que se va a usar para la entrada de lápiz.

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT get_Guide(
  IInkRecognizerGuide **RecognizerGuide
);

Parámetros

RecognizerGuide

Valor devuelto

Ninguno

Observaciones

Establecer la propiedad Guide solo se realiza correctamente si la colección InkStrokes es NULL. Debe establecer la propiedad Guide antes de adjuntar la colección InkStrokes a InkRecognizerContext o debe establecer la colección InkStrokes en NULL y, a continuación, establecer la Guía (y posible volver a adjuntar la colección InkStrokes).

La enumeración InkRecognizerCapabilities contiene las marcas IRC_FreeInput, IRC_LinedInput y IRC_BoxedInput . Estas marcas especifican las funcionalidades de un reconocedor, pero porque son de solo lectura, no hay ninguna manera de establecer ninguna de estas directamente en un objeto IInkRecognizer o InkRecognizerContext . La única manera de colocar un reconocedor en un modo específico es establecer la guía mediante la propiedad Guide . Si no establece la propiedad Guide , el reconocedor tiene como valor predeterminado el modo FreeInput (si el reconocedor es capaz de hacerlo). Otra manera de establecer el reconocedor en el modo FreeInput es establecer la propiedad Guide en un objeto InkRecognizerGuide que tiene su propiedad Columns establecida en cero y su propiedad Rows establecida en cero.

Si establece la propiedad Guide en un objeto InkRecognizerGuide que tiene su propiedad Columns establecida en cero y su propiedad Rows establecida en 1 o más, el reconocedor está en modo IRC_LinedInput (si el reconocedor es capaz de esto). El reconocedor usa la propiedad Rows para controlar el número de líneas.

Si establece la propiedad Guide en un objeto InkRecognizerGuide que tiene su propiedad Rows establecida en cero y su propiedad Columns establecida en 1 o más, el reconocedor está en modo IRC_LinedInput (si el reconocedor es capaz de hacerlo) para la escritura vertical. El reconocedor usa la propiedad Columns para controlar el número de líneas verticales. Si el reconocedor es capaz de esto, la propiedad Capabilities del objeto IInkRecognizer devuelve IRC_DownAndLeft o IRC_DownAndRight, o ambos.

Si establece la propiedad Guide en un objeto InkRecognizerGuide que tiene su propiedad Columns establecida en 1 o más y su propiedad Rows establecida en 1 o más, el reconocedor está en modo IRC_BoxedInput (si el reconocedor es capaz de esto).

Si establece el modo en uno que no está disponible en este reconocedor, se devuelve un error.

Para obtener información sobre cómo consultar qué funcionalidades o modos están disponibles desde un reconocedor específico, vea la propiedad Capabilities del objeto IInkRecognizer . En general, los reconocedores de script latino admiten entradas gratuitas y entrada en línea horizontal, los reconocedores de caracteres asiáticos orientales admiten entradas gratuitas y entrada boxing, y el reconocedor de gestos solo admite entradas gratuitas.

Requisitos


Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	msinkaut.h
Library	InkObj.dll