RecognizerGuide.Columns, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit le nombre de colonnes dans la zone du repère de reconnaissance.

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

Syntaxe

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

Valeur de propriété

Type : System.Int32
Nombre de colonnes dans la zone de repère.

Notes

La largeur de colonne est déterminée par la taille de la zone de dessin. Pour obtenir ou définir la zone de dessin, utilisez la propriété DrawnBox.

Utilisez les valeurs des propriétés Columns et Rows pour contrôler le type de saisie de reconnaissance que vous utilisez. Lorsque Columns et Rows sont tous les deux supérieurs à zéro, la saisie dans une grille est utilisée. Le tableau suivant répertorie les modes de saisie potentiels et les valeurs à définir pour les propriétés Columns et Rows de chaque mode.

Pour ce type d'entrée	Affecte à la propriété Rows la valeur	Affectez à la propriété Columns la valeur
Saisie libre	0	0
Saisie verticale d'1 ligne	0	1
Saisie verticale de n lignes	0	n
Saisie horizontale d'1 ligne	1	0
Saisie horizontale de n lignes	n	0
Saisie dans une grille d'une zone	1	1
Saisie dans une grille avec 1 colonne de n zones	1	n
Saisie dans une zone à l'intérieur d'une grille de zones de x lignes par z colonnes	x	z

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.