RecognizerGuide.Rows-Eigenschaft

Artikel
11/26/2008

Ruft die Anzahl der Zeilen im Führungslinienfeld ab oder legt diese fest.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Property Rows As Integer
'Usage
Dim instance As RecognizerGuide
Dim value As Integer

value = instance.Rows

instance.Rows = value

public int Rows { get; set; }

public:
property int Rows {
    int get ();
    void set (int value);
}

/** @property */
public int get_Rows()
/** @property */
public  void set_Rows(int value)

public function get Rows () : int
public function set Rows (value : int)

Eigenschaftenwert

Typ: System.Int32
Die Anzahl der Zeilen im Führungslinienfeld.

Hinweise

Die Zeilenhöhe wird von der Größe des gezeichneten Felds bestimmt. Verwenden Sie die DrawnBox-Eigenschaft, um das gezeichnete Feld abzurufen oder festzulegen.

Verwenden Sie die Werte der Columns- und der Rows-Eigenschaft, um die Art der zu erkennenden Eingaben zu steuern, die Sie verwenden möchten. Wenn sowohl Columns als auch Rows größer als 0 (null) sind, wird die Eingabe in Feldern verwendet. In der folgenden Tabelle werden potenzielle Eingabemodi und die Werte aufgelistet, auf die die Columns-Eigenschaft und die Rows-Eigenschaft für die einzelnen Modi festgelegt werden sollen.

Für diesen Typ von Eingabe	Legen Sie die Rows-Eigenschaft wie folgt fest:	Legen Sie außerdem die Columns-Eigenschaft wie folgt fest:
Freie Eingabe	0	0
Eingabe auf vertikalen Zeilen mit 1 Zeile	0	1
Eingabe auf vertikalen Zeilen mit n Zeilen	0	n
Eingabe auf horizontalen Zeilen mit 1 Zeile	1	0
Eingabe auf horizontalen Zeilen mit n Zeilen	n	0
Eingabe in Feldern mit 1 Feld	1	1
Eingabe in Feldern bei 1 Spalte mit n Feldern	1	n
Eingabe in ein Feldraster mit x Zeilen und z Spalten	x	z

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.