AnalysisHintNode.Guide, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit le repère de reconnaissance utilisé par le InkAnalyzer pour analyser l'entrée manuscrite dans la zone active.

Espace de noms : System.Windows.Ink
Assembly : IAWinFX (dans IAWinFX.dll)

Syntaxe

'Déclaration
Public Property Guide As InkRecognizerGuide
'Utilisation
Dim instance As AnalysisHintNode
Dim value As InkRecognizerGuide

value = instance.Guide

instance.Guide = value

public InkRecognizerGuide Guide { get; set; }

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

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

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

Valeur de propriété

Type : System.Windows.Ink.InkRecognizerGuide
Repère de reconnaissance que le InkAnalyzer utilise pour analyser l'entrée manuscrite dans la zone active. La valeur par défaut est un InkRecognizerGuide où toutes ses propriétés ont la valeur 0.

Notes

Remarque :
Si le System.Windows.Ink.InkRecognizer que le InkAnalyzer utilise pour la reconnaissance de l'écriture manuscrite ne prend pas en charge les repères, le InkAnalyzer ignore le repère. Pour plus d'informations sur les fonctionnalités prises en charge par un InkRecognizer, consultez InkRecognizer.Capabilities.

Toutes les coordonnées du RecognizerGuide sont exprimées selon les coordonnées de l'espace d'entrée manuscrite et sont relatives au coin supérieur gauche de l'indication. Pour une indication globale, le repère n'est pas translaté ; il utilise le système de coordonnées de l'objet Ink. Pour plus d'informations sur l'utilisation d'un repère pour améliorer la reconnaissance de l'écriture manuscrite, consultez RecognizerGuide.

Pendant l'analyse, si le module de reconnaissance de l'écriture manuscrite appliqué aux traits ne prend pas en charge un repère, l'analyseur d'entrée manuscrite génère un AnalysisWarning pour lequel la valeur System.Windows.Ink.AnalysisWarningCode de la propriété WarningCode() est GuideNotSupported.

Pour supprimer un repère d'une indication, appelez la méthode ClearGuide ou la méthode RemovePropertyData(Guid) de l'indication en affectant la valeur PropertyGuidsForAnalysisHints.Guide à propertyDataId.

Exemples

Cet exemple crée un AnalysisHintNode (nommé theAnalysisHint) pour le InkAnalyzer (nommé theInkAnalyzerWithHint), et définit theAnalysisHint comme une indication globale. Les propriétés Guide et Name sont ensuite définies sur l'indication.

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

' Add a new, global analysis hint to theInkAnalyzerWithHint.
Dim theAnalysisHint As AnalysisHintNode = Me.theInkAnalyzerWithHint.CreateAnalysisHint()
theAnalysisHint.Location.MakeInfinite()

' Create an InkRecognizerGuide with the writing box
' slightly larger than the drawing box.
Dim theGuide As New InkRecognizerGuide(1, 0, midline, _
    guideBoxLeft - WRITINGBOXMARGIN, guideBoxTop - WRITINGBOXMARGIN, _
    guideBoxRight + WRITINGBOXMARGIN, guideBoxBottom + WRITINGBOXMARGIN, _
    guideBoxLeft, guideBoxTop, guideBoxRight, guideBoxBottom)

theAnalysisHint.Guide = theGuide
theAnalysisHint.Name = "Recognizer Guide"

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;

// Add a new, global analysis hint to theInkAnalyzerWithHint.
AnalysisHintNode theAnalysisHint =
    this.theInkAnalyzerWithHint.CreateAnalysisHint();
theAnalysisHint.Location.MakeInfinite();

// Create an InkRecognizerGuide with the writing box
// slightly larger than the drawing box.
InkRecognizerGuide theGuide = new InkRecognizerGuide(1, 0, midline, 
    guideBoxLeft - WRITINGBOXMARGIN, guideBoxTop - WRITINGBOXMARGIN, 
    guideBoxRight + WRITINGBOXMARGIN, guideBoxBottom + WRITINGBOXMARGIN,
    guideBoxLeft, guideBoxTop, guideBoxRight, guideBoxBottom);

theAnalysisHint.Guide = theGuide;
theAnalysisHint.Name = "Recognizer 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.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

AnalysisHintNode, classe

Membres AnalysisHintNode

System.Windows.Ink, espace de noms

RecognizerGuide

Partager via