RecognizerGuide (Estructura)

Artículo
10/28/2008

Actualización: noviembre 2007

Representa el área que usa el objeto Recognizer y en el que se puede dibujar entrada manuscrita. El área se conoce como la guía de reconocedor.

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

Sintaxis

'Declaración
Public Structure RecognizerGuide
'Uso
Dim instance As RecognizerGuide

public struct RecognizerGuide

public value class RecognizerGuide

public final class RecognizerGuide extends ValueType

JScript admite el uso de estructuras, pero no admite la declaración de estructuras nuevas.

Comentarios

La guía de reconocedor puede estar compuesta por filas y columnas y da al reconocedor un mejor contexto en el que realizar el reconocimiento. Por ejemplo, puede dibujar líneas horizontales en la pantalla de un usuario, casi como en una página de papel con rayas, que muestra dónde se debe insertar la entrada manuscrita (este tipo de guía sólo estaría compuesto por filas, no por columnas). Si un usuario escribe en las líneas, en lugar de en algún espacio arbitrario, mejorará la exactitud del reconocimiento. Para obtener ilustraciones de guías de reconocedor, vea Ink Recognition.

Las letras como la "t" y la "I" se reconocen más fácilmente cuando se utiliza una guía para dar contexto a la entrada manuscrita.

La guía especifica los límites de la entrada manuscrita en coordenadas espaciales de entrada manuscrita. La propiedad DrawnBox puede definir un cuadro que tenga el mismo tamaño o menor que el cuadro definido por la propiedad WritingBox. Esto permite estilos de escritura dispares. Si el usuario escribe fuera de la propiedad DrawnBox pero dentro de la propiedad WritingBox, el objeto Recognizer utilizará toda la tinta para ayudar en el reconocimiento.

Si la aplicación ha dibujado guías en la pantalla en la que se espera que escriba el usuario, la aplicación debe establecer los valores de las propiedades de la guía de reconocedor para informar a dicho reconocedor. Estas propiedades sólo puede utilizarlas el reconocedor. No basta con definirlas para que en la pantalla aparezcan dibujadas pistas visuales. La aplicación o el control dibuja las pistas visuales.

Además de dibujar líneas, o reglas, en la pantalla que indica a los usuarios dónde escribir, también es posible dibujar celdas en la pantalla en la que se escriben caracteres o palabras. Esto se denomina entrada de cuadro y resulta útil para algunos idiomas del este asiático. Para determinar si el reconocedor admite la entrada de cuadro, llame a la propiedad Capabilities del objeto Recognizer.

De forma predeterminada no hay ninguna guía. Una guía predeterminada tiene todos los valores de propiedad establecidos en 0. Debe utilizar las propiedades de este objeto para establecer la guía.

Ejemplos

En este ejemplo, se crea una instancia del objeto RecognizerContext y se asigna la propiedad Guide creando un nuevo objeto RecognizerGuide.

' 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;
}

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

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.