Proprietà RecognizerGuide.WritingBox

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta l'area di scrittura invisibile della guida di riconoscimento in cui è effettivamente possibile scrivere.

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

Sintassi

'Dichiarazione
Public Property WritingBox As Rectangle
'Utilizzo
Dim instance As RecognizerGuide
Dim value As Rectangle

value = instance.WritingBox

instance.WritingBox = value

public Rectangle WritingBox { get; set; }

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

/** @property */
public Rectangle get_WritingBox()
/** @property */
public  void set_WritingBox(Rectangle value)

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

Valore proprietà

Tipo: System.Drawing.Rectangle
Area di scrittura rettangolare della casella della guida, nelle coordinate dello spazio di input penna.

Note

La casella di scrittura fornisce un margine di errore agli utenti che scrivono all'esterno della casella disegnata, ovvero le righe disegnate fisicamente sullo schermo del Tablet PC sulle quali gli utenti scrivono. Per impostare la casella disegnata, utilizzare la proprietà DrawnBox.

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.