Proprietà RecognizerGuide.Columns

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta il numero di colonne nella casella della guida di riconoscimento.

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

Sintassi

'Dichiarazione
Public Property Columns As Integer
'Utilizzo
Dim instance As RecognizerGuide
Dim value As Integer

value = instance.Columns

instance.Columns = value

public int Columns { get; set; }

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

/** @property */
public int get_Columns()
/** @property */
public  void set_Columns(int value)

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

Valore proprietà

Tipo: System.Int32
Numero di colonne nella casella della guida.

Note

La larghezza della colonna è determinata dalla dimensione della casella disegnata. Per ottenere o impostare la casella disegnata, utilizzare la proprietà DrawnBox.

Utilizzare i valori delle proprietà Columns e Rows per controllare il tipo di input di riconoscimento utilizzato. L'input boxed viene utilizzato quando entrambi gli oggetti Columns e Rows sono maggiori di zero. Nella tabella seguente sono elencate le potenziali modalità di input e i valori in base ai quali impostare le proprietà Columns e Rows per ogni modalità.

Per questo tipo di input	Impostare la proprietà Rows su	Inoltre, impostare la proprietà Columns su
Input libero	0	0
Input allineato verticale con 1 riga	0	1
Input allineato verticale con n righe	0	n
Input allineato orizzontale con 1 riga	1	0
Input allineato orizzontale con n righe	n	0
Input boxed con 1 casella	1	1
Input boxed con 1 colonna costituita da n caselle	1	n
Input boxed in una griglia di caselle di X righe e Z colonne	X	Z

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.