RecognizerGuide, structure

Article
11/05/2008

Mise à jour : November 2007

Représente la zone que l'objet Recognizer utilise et dans laquelle l'entrée manuscrite peut être tracée. On appelle cette zone le repère de reconnaissance.

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

Syntaxe

'Déclaration
Public Structure RecognizerGuide
'Utilisation
Dim instance As RecognizerGuide

public struct RecognizerGuide

public value class RecognizerGuide

public final class RecognizerGuide extends ValueType

JScript prend en charge l'utilisation de structures mais pas la déclaration de nouvelles structures.

Notes

Le repère de reconnaissance peut se composer de lignes et de colonnes, et fournit au module de reconnaissance un meilleur contexte pour exécuter la reconnaissance. Par exemple, vous pouvez dessiner des lignes horizontales sur l'écran d'un utilisateur (comme s'il s'agissait d'une feuille de papier avec des traits horizontaux) et visualiser ainsi où l'entrée manuscrite doit apparaître (ce type de repère se compose uniquement de lignes sans colonnes). Lorsqu'un utilisateur écrit sur les lignes, la précision de la reconnaissance s'améliore au lieu de déterminer des espaces arbitraires. Pour des illustrations de repère de reconnaissance, consultez Ink Recognition.

Les lettres telles que « t » et « I » sont plus facilement identifiées lorsqu'un repère est utilisé pour fournir le contexte à l'entrée manuscrite.

Le repère indique les limites de l'entrée manuscrite dans les coordonnées d'espace d'entrée manuscrite. La propriété DrawnBox peut définir une zone de même taille ou plus petite que la zone définie par la propriété WritingBox. Cela permet de prendre en compte des styles d'écriture différents. Si l'utilisateur écrit en dehors du DrawnBox mais dans le WritingBox, l'objet Recognizer utilise toute l'entrée manuscrite pour aider la reconnaissance.

Si l'application a dessiné des lignes sur l'écran pour indiquer à l'utilisateur où écrire, l'application doit affecter les valeurs aux propriétés du repère de reconnaissance pour informer le module de reconnaissance. Ces propriétés ne sont utiles qu'au module de reconnaissance. Leur seule définition ne dessine pas d'indice visuel à l'écran. L'application ou le contrôle dessine les indices visuels.

En plus de dessiner des lignes ou des traits sur l'écran qui permettent à l'utilisateur de savoir où il doit écrire, il est également possible de dessiner des cellules sur l'écran dans lesquelles les caractères ou les mots sont écrits. Il s'agit de la saisie dans une grille, elle est utile avec certaines langues asiatiques. Pour déterminer si le module de reconnaissance est capable d'effectuer une saisie dans une grille, appelez la propriété Capabilities de l'objet Recognizer.

Par défaut, il n'y a pas de repère. Par défaut, toutes les propriétés d'un repère ont la valeur 0. Vous devez utiliser les propriétés de cet objet pour définir le repère.

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;
}

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

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.