InkRecognizerGuide, classe
Mise à jour : November 2007
Représente la zone que l'objet InkRecognizer utilise et dans laquelle l'entrée manuscrite peut être tracée. Cette zone porte le nom de recognizer guide.
Espace de noms : System.Windows.Ink
Assembly : IAWinFX (dans IAWinFX.dll)
Syntaxe
'Déclaration
Public Class InkRecognizerGuide
'Utilisation
Dim instance As InkRecognizerGuide
public class InkRecognizerGuide
public ref class InkRecognizerGuide
public class InkRecognizerGuide
public class InkRecognizerGuide
Notes
InkRecognizerGuide 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 être saisie (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. Par exemple, 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 InkRecognizerGuide spécifie les limites à l'intérieur desquelles l'entrée manuscrite peut être tracée en définissant deux rectangles, le drawn box et le writing box. Les limites de la zone de dessin sont des indicateurs visuels et les limites de la zone d'écriture sont invisibles. Ensemble, elles définissent la zone dans laquelle il est possible d'écrire. L'utilisateur écrit normalement à l'intérieur des limites des lignes visibles de la zone de dessin. La zone de dessin est spécifiée par les propriétés DrawnBoxTop, DrawnBoxLeft, DrawnBoxBottom et DrawnBoxRight. Ces propriétés ne sont utiles qu'au module de reconnaissance. Leur seule définition ne dessine pas d'indice visuel à l'écran. Vous devez dessiner les indices visuels en utilisant l'application ou le contrôle.
La zone d'écriture est plus grande que la zone de dessin et permet aux utilisateurs de bénéficier d'une marge d'erreur s'ils dessinent à l'extérieur des lignes de la zone de dessin. La zone d'écriture est spécifiée par les propriétés WritingBoxTop, WritingBoxLeft, WritingBoxBottomet WritingBoxRight.
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 boxed input, particulièrement 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 InkRecognizer.
Par défaut, toutes les valeurs de propriété du repère sont égales à 0, ce qui signifie qu'il n'y a aucun repère. Vous devez utiliser les propriétés de l'objet InkRecognizerGuide pour définir le repère.
Exemples
L'exemple suivant définit simultanément toutes les valeurs dans le InkRecognizerGuide.
Dim guideBoxTop As Double = 0
Dim guideBoxBottom As Double = 50
Dim guideBoxLeft As Double = 0
Dim guideBoxRight As Double = 600
Dim WRITINGBOXMARGIN As Integer = 10
' Find the midline of the guide box.
Dim midline As Double = (guideBoxBottom - guideBoxTop) / 2 + guideBoxTop
theGuide.Rows = 1
theGuide.Columns = 0
theGuide.Midline = midline
theGuide.WritingBoxLeft = guideBoxLeft - WRITINGBOXMARGIN
theGuide.WritingBoxTop = guideBoxTop - WRITINGBOXMARGIN
theGuide.WritingBoxRight = guideBoxRight + WRITINGBOXMARGIN
theGuide.WritingBoxBottom = guideBoxBottom + WRITINGBOXMARGIN
theGuide.DrawnBoxLeft = guideBoxLeft
theGuide.DrawnBoxTop = guideBoxTop
theGuide.DrawnBoxRight = guideBoxRight
theGuide.DrawnBoxBottom = guideBoxBottom
double guideBoxTop = 0;
double guideBoxBottom = 50;
double guideBoxLeft = 0;
double guideBoxRight = 600;
const int WRITINGBOXMARGIN = 10;
// Find the midline of the guide box.
double midline = (guideBoxBottom - guideBoxTop) / 2 + guideBoxTop;
theGuide.Rows = 1;
theGuide.Columns = 0;
theGuide.Midline = midline;
theGuide.WritingBoxLeft = guideBoxLeft - WRITINGBOXMARGIN;
theGuide.WritingBoxTop = guideBoxTop - WRITINGBOXMARGIN;
theGuide.WritingBoxRight = guideBoxRight + WRITINGBOXMARGIN;
theGuide.WritingBoxBottom = guideBoxBottom + WRITINGBOXMARGIN;
theGuide.DrawnBoxLeft = guideBoxLeft;
theGuide.DrawnBoxTop = guideBoxTop;
theGuide.DrawnBoxRight = guideBoxRight;
theGuide.DrawnBoxBottom = guideBoxBottom;
Hiérarchie d'héritage
System.Object
System.Windows.Ink.InkRecognizerGuide
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.
Informations de version
.NET Framework
Pris en charge dans : 3.0
Voir aussi
Référence
System.Windows.Ink, espace de noms
Recognizer
RecognizerContext