RecognizerGuide.DrawnBox-Eigenschaft
Ruft das Rechteck ab, das auf dem Tablettbildschirm physisch gezeichnet ist und in das geschrieben werden kann, oder legt dieses Rechteck fest.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
Public Property DrawnBox As Rectangle
'Usage
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)
Eigenschaftenwert
Typ: System.Drawing.Rectangle
Das Rechteck, das auf dem Tablettbildschirm physisch gezeichnet ist und in das geschrieben werden kann, relativ zur oberen linken Ecke des Schreibfelds.
Hinweise
Die Linien des gezeichneten Felds sind visuelle Hinweise, die angeben, in welchen Bereich geschrieben werden kann. Der Benutzer schreibt normalerweise innerhalb der Grenzen der Linien.
Ein weiteres Rechteck, das Schreibfeld, ist das unsichtbare Feld, in dem tatsächlich geschrieben werden kann. Die Abmessungen sind größer als die des gezeichneten Felds und bieten Benutzern eine gewisse Toleranzbreite, wenn sie außerhalb der Ränder des gezeichneten Felds Freihandeingaben vornehmen. Verwenden Sie die WritingBox-Eigenschaft, um das Schreibfeld festzulegen.
Das Schreibfeld gibt für das Erkennungsmodul die Begrenzungen der Freihandeingaben an. Das Feld wird unter Verwendung von Freihandbereich-Koordinaten relativ zur oberen linken Ecke des Schreibfelds gezeichnet.
Beispiele
In diesem Beispiel wird ein RecognizerContext-Objekt instanziiert, und die Guide-Eigenschaft wird durch Erstellen eines neuen RecognizerGuide-Objekts zugewiesen.
' 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;
}
Plattformen
Windows Vista
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0