AnalysisHintNode.Guide, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit le repère de reconnaissance que le InkAnalyzer utilise pour analyser l'entrée manuscrite dans cette zone.

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

Syntaxe

'Déclaration
Public Property Guide As RecognizerGuide
'Utilisation
Dim instance As AnalysisHintNode
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
Repère de reconnaissance que le InkAnalyzer utilise pour analyser l'entrée manuscrite dans cette zone. La valeur par défaut est un RecognizerGuide, dont les propriétés Rows, Columns et Midline ont la valeur 0 et dont les propriétés DrawnBox et WritingBox sont des rectangles vides.

Notes

Remarque :
Si le Microsoft.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 InkRecognizerBase.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 Microsoft.Ink.AnalysisWarningCode de la propriété WarningCode est GuideNotSupported.

Pour supprimer un repère d'une indication, appelez la méthode RemovePropertyData de l'indication en affectant la valeur PropertyGuidsForAnalysisHintsBase.Guide à propertyDataId. Vous pouvez également supprimer le repère (rétablir la valeur par défaut) en appelant la méthode ClearGuide.

Exemples

Cet exemple crée un AnalysisHintNode, theAnalysisHint, pour le InkAnalyzer, theInkAnalyzerWithHint, et définit theAnalysisHint comme une indication globale. Il définit ensuite les propriétés Guide et Name sur l'indication.

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

theAnalysisHint.Guide = New RecognizerGuide(1, 0, _
    Me.theMidlineHeightInHimetric, _
    Rectangle.Inflate(Me.theGuideBoxInHimetric, 50, 50), _
    Me.theGuideBoxInHimetric)
theAnalysisHint.Name = "Recognizer Guide"

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

theAnalysisHint.Guide = new RecognizerGuide(1, 0,
    this.theMidlineHeightInHimetric,
    Rectangle.Inflate(this.theGuideBoxInHimetric, 50, 50),
    this.theGuideBoxInHimetric);
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.