Proprietà RecognizerGuide.DrawnBox

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta il rettangolo disegnato fisicamente sullo schermo del Tablet PC in cui è possibile scrivere.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Property DrawnBox As Rectangle
'Utilizzo
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)

Valore proprietà

Tipo: System.Drawing.Rectangle
Rettangolo disegnato fisicamente sullo schermo del Tablet PC in cui è possibile scrivere, relativo alla parte superiore sinistra della casella di scrittura.

Note

Le righe della casella disegnata sono indizi visivi che specificano il punto in cui è possibile scrivere. L'utente scrive normalmente all'interno dei limiti delle righe.

Un altro rettangolo, la casella di scrittura, è la casella invisibile nella quale è effettivamente possibile scrivere. È più grande della casella disegnata e fornisce agli utenti un margine di errore se disegnano l'input penna all'esterno delle righe della casella disegnata. Per impostare la casella di scrittura, utilizzare la proprietà WritingBox.

La casella di scrittura specifica i limiti dell'input penna nel sistema di riconoscimento. La casella viene disegnata utilizzando le coordinate dello spazio di input penna, relative alla parte superiore sinistra della casella di scrittura.

Esempi

In questo esempio viene creata un'istanza di un oggetto RecognizerContext e la proprietà Guide viene assegnata mediante la creazione di un nuovo oggetto 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;
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.