RecognizerGuide.DrawnBox (Propiedad)

Artículo
10/28/2008

Actualización: noviembre 2007

Obtiene o establece el rectángulo que se dibuja físicamente en la pantalla del Tablet PC y en el que se realiza la escritura.

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

Sintaxis

'Declaración
Public Property DrawnBox As Rectangle
'Uso
Dim instance As RecognizerGuide
Dim value As Rectangle

value = instance.DrawnBox

instance.DrawnBox = value

public Rectangle DrawnBox { get; set; }

public:
property Rectangle DrawnBox {
    Rectangle get ();
    void set (Rectangle value);
}

/** @property */
public Rectangle get_DrawnBox()
/** @property */
public  void set_DrawnBox(Rectangle value)

public function get DrawnBox () : Rectangle
public function set DrawnBox (value : Rectangle)

Valor de propiedad

Tipo: System.Drawing.Rectangle
El rectángulo que se dibuja físicamente en la pantalla del Tablet PC y en el que se realiza la escritura, en relación a la parte superior del cuadro de escritura.

Comentarios

Las líneas del cuadro dibujado son indicaciones visuales que especifican dónde se puede efectuar la escritura. El usuario normalmente escribe dentro de los límites de las líneas.

Otro rectángulo, el cuadro de escritura, es el cuadro no visible en el que se puede realizar realmente la escritura. Es mayor que el cuadro dibujado y proporciona un margen de error a los usuarios si insertan la entrada manuscrita fuera de las líneas del cuadro dibujado. Use la propiedad WritingBox para establecer el cuadro de escritura.

El cuadro de escritura especifica los límites de la entrada manuscrita para el reconocedor. El cuadro dibujado se traza utilizando las coordenadas espaciales de entrada manuscrita, en relación a la parte superior del cuadro de escritura.

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

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.