RecognizerContext.Guide, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit le RecognizerGuide à utiliser pour entrer l'entrée manuscrite.

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

Syntaxe

'Déclaration
Public Property Guide As RecognizerGuide
'Utilisation
Dim instance As RecognizerContext
Dim value As RecognizerGuide

value = instance.Guide

instance.Guide = value

public RecognizerGuide Guide { get; set; }

public:
property RecognizerGuide Guide {
    RecognizerGuide get ();
    void set (RecognizerGuide value);
}

/** @property */
public RecognizerGuide get_Guide()
/** @property */
public  void set_Guide(RecognizerGuide value)

public function get Guide () : RecognizerGuide
public function set Guide (value : RecognizerGuide)

Valeur de propriété

Type : Microsoft.Ink.RecognizerGuide
RecognizerGuide à utiliser pour entrer l'entrée manuscrite.

Notes

La définition de la propriété Guide aboutit uniquement si la propriété Strokes a la valeur nullune référence null (Nothing en Visual Basic). Vous devez définir la propriété Guide avant d'attacher une collection Strokes à la propriété Strokes du RecognizerContext, ou bien affecter la valeur nullune référence null (Nothing en Visual Basic) à la propriété Strokes, puis définir la propriété Guide.

Remarque :
Si vous utilisez cette dernière méthode, vous devrez peut-être attacher de nouveau la collection Strokes à la propriété Strokes du RecognizerContext.

L'énumération RecognizerCapabilities contient les indicateurs FreeInput, LinedInput et BoxedInput. Ces indicateurs spécifient les fonctions d'un module de reconnaissance, mais il est impossible de les affecter directement à un objet Recognizer ou RecognizerContext car ils sont en lecture seule. Le seul moyen d'affecter un mode spécifique à un module de reconnaissance consiste à définir le repère de reconnaissance à l'aide de la propriété Guide.

Si vous ne définissez pas la propriété Guide, la valeur par défaut est le mode FreeInput, en supposant que le module de reconnaissance prend ce mode en charge.

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 de n zones	n	1
Saisie dans une zone à l'intérieur d'une grille de zones de x lignes par z colonnes	x	z

Si vous affectez une valeur non disponible au mode pour un objet Recognizer, une exception ArgumentException (page pouvant être en anglais) est levée.

Pour déterminer quelles fonctions (ou quels modes) sont disponibles à partir d'un module de reconnaissance spécifique, utilisez la propriété Capabilities de l'objet Recognizer. Dans Windows Vista, les modules de reconnaissance du script latin prennent en charge la saisie libre, la saisie dans une grille et l'entrée sous forme de ligne horizontale. Les modules de reconnaissance de caractères asiatiques prennent en charge la saisie libre et la saisie dans une grille. La reconnaissance de mouvements prend uniquement en charge la saisie libre.

Exemples

Dans cet exemple, un objet RecognizerContext est instancié et la propriété Guide est assignée.

' 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.