RecognizerContext.Guide (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene o establece el objeto RecognizerGuide para usarlo para la entrada de entradas manuscritas.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Property Guide As RecognizerGuide
'Uso
Dim instance As RecognizerContext
Dim value As RecognizerGuide

value = instance.Guide

instance.Guide = value

public RecognizerGuide Guide { get; set; }

public:
property RecognizerGuide Guide {
    RecognizerGuide get ();
    void set (RecognizerGuide value);
}

/** @property */
public RecognizerGuide get_Guide()
/** @property */
public  void set_Guide(RecognizerGuide value)

public function get Guide () : RecognizerGuide
public function set Guide (value : RecognizerGuide)

Valor de propiedad

Tipo: Microsoft.Ink.RecognizerGuide
Objeto RecognizerGuide que se va a usar para la entrada de entradas manuscritas.

Comentarios

Establecer la propiedad Guide solamente resulta correcto si la propiedad Strokes es nullreferencia null (Nothing en Visual Basic). Debe establecer la propiedad Guide antes de asociar una colección Strokes a la propiedad Strokes de RecognizerContext, o debe establecer la propiedad Strokes en nullreferencia null (Nothing en Visual Basic) y, a continuación, establecer la propiedad Guide.

Nota

Si usa el segundo método, es posible que tenga que volver a asociar la colección Strokes a la propiedad Strokes de RecognizerContext.

La enumeración RecognizerCapabilities contiene los marcadores FreeInput, LinedInput y BoxedInput. Estos marcadores especifican las capacidades de un reconocedor, pero como son de solo lectura, no hay ninguna manera de establecerlos directamente en los objetos RecognizerContext o Recognizer. La única manera de establecer un reconocedor en un modo concreto es establecer la guía del reconocimiento mediante la propiedad Guide.

Si no establece la propiedad Guide, el valor predeterminado es el modo FreeInput, suponiendo que el reconocedor sea compatible con este modo.

La tabla siguiente enumera los posibles modos de entrada y en qué valores se deben establecer las propiedades Rows y Columns para cada modo.

Para este tipo de entrada	Establezca la propiedad Rows en	Y establezca la propiedad Columns en
Entrada libre	0	0
Entrada de línea vertical con 1 línea	0	1
Entrada de línea vertical con n líneas	0	n
Entrada de línea horizontal con 1 línea	1	0
Entrada de línea horizontal con n líneas	n	0
Entrada de cuadro con 1 cuadro	1	1
Entrada de cuadro con n cuadros	n	1
Entrada de cuadro en una cuadrícula de cuadros con x filas por z columnas	x	z

Si establece el modo en uno que no está disponible para un objeto Recognizer, se produce la excepción ArgumentException.

Para consultar qué capacidades o modos hay disponibles desde un reconocedor concreto, use la propiedad Capabilities del objeto Recognizer. En Windows Vista, los reconocedores de alfabetos latinos admiten la entrada libre, la entrada de cuadro y la entrada de línea horizontal; los reconocedores de caracteres del este asiático admiten la entrada libre y la entrada de cuadro, y el reconocedor de movimientos solamente admite la entrada libre.

Ejemplos

En este ejemplo se crea una instancia de un objeto RecognizerContext y la propiedad Guide asignada.

' create a new RecognizerContext object
mRecognizerContext = New RecognizerContext()
' if the Recognizer supports LinedInput, set the Guide
If (mRecognizerContext.Recognizer.Capabilities And RecognizerCapabilities.LinedInput) <> 0 Then
    ' get the lower right corner in pixel units
    Dim lowerRight As Point = New Point(mInkOverlay.AttachedControl.Width, mInkOverlay.AttachedControl.Height)
    ' convert to ink space units
    mInkOverlay.Renderer.PixelToInkSpace(Me.CreateGraphics(), lowerRight)
    ' create Rectangles
    Dim writingBox As Rectangle = New Rectangle(0, 0, lowerRight.X, lowerRight.Y)
    Dim drawnBox As Rectangle = New Rectangle(0, 0, lowerRight.X, lowerRight.Y)
    ' shrink drawn box relative to writing box
    drawnBox.Inflate(-100, -100)
    ' create Guide with 8 rows, zero columns, and no midline
    Dim guide As RecognizerGuide = New RecognizerGuide(8, 0, 0, writingBox, drawnBox)
    mRecognizerContext.Guide = guide
End If

// create a new RecognizerContext object
mRecognizerContext = new RecognizerContext();
// if the Recognizer supports LinedInput, set the Guide
if ((mRecognizerContext.Recognizer.Capabilities & RecognizerCapabilities.LinedInput) != 0)
{
    // get the lower right corner in pixel units
    Point lowerRight = new Point(mInkOverlay.AttachedControl.Width, mInkOverlay.AttachedControl.Height);
    // convert to ink space units
    mInkOverlay.Renderer.PixelToInkSpace(this.CreateGraphics(), ref lowerRight);
    // create Rectangles
    Rectangle writingBox = new Rectangle(0, 0, lowerRight.X, lowerRight.Y);
    Rectangle drawnBox = new Rectangle(0, 0, lowerRight.X, lowerRight.Y);
    // shrink drawn box relative to writing box
    drawnBox.Inflate(-100, -100);
    // create Guide with 8 rows, zero columns, and no midline
    RecognizerGuide guide = new RecognizerGuide(8, 0, 0, writingBox, drawnBox);
    mRecognizerContext.Guide = guide;
}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.