RecognizerGuide.DrawnBox, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit le rectangle dessiné physiquement sur l'écran de la tablette et dans lequel écrire.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Property DrawnBox As Rectangle
'Utilisation
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)

Valeur de propriété

Type : System.Drawing.Rectangle
Rectangle dessiné physiquement sur l'écran de la tablette et dans lequel écrire, par rapport au coin supérieur gauche de la zone d'écriture.

Notes

Les lignes de la zone de dessin sont des signaux visuels qui spécifient où écrire. Normalement, l'utilisateur écrit dans les limites des lignes.

Un autre rectangle, la zone d'écriture, désigne la zone invisible dans laquelle il est possible d'écrire. Elle est plus grande que la zone de dessin et permet aux utilisateurs de bénéficier d'une marge d'erreur s'ils tracent l'entrée manuscrite en dehors des lignes de la zone de dessin. Utilisez la propriété WritingBox pour définir la zone d'écriture.

La zone d'écriture spécifie les limites de l'entrée manuscrite au module de reconnaissance. La zone de dessin est dessinée à l'aide de coordonnées d'espace d'entrée manuscrite, par rapport au coin au supérieur gauche de la zone d'écriture.

Exemples

Dans cet exemple, un objet RecognizerContext est instancié et la propriété Guide est assignée par la création d'un objet 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;
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.