InkAnalyzerBase.CreateAnalysisHint, méthode

Article
11/05/2008

Mise à jour : November 2007

Ajoute une nouvelle indication d'analyse avec une zone vide à l'analyseur d'entrée manuscrite.

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

Syntaxe

'Déclaration
Public Function CreateAnalysisHint As ContextNodeBase
'Utilisation
Dim instance As InkAnalyzerBase
Dim returnValue As ContextNodeBase

returnValue = instance.CreateAnalysisHint()

public ContextNodeBase CreateAnalysisHint()

public:
ContextNodeBase^ CreateAnalysisHint()

public ContextNodeBase CreateAnalysisHint()

public function CreateAnalysisHint() : ContextNodeBase

Valeur de retour

Type : System.Windows.Ink.AnalysisCore.ContextNodeBase
Nouvelle indication d'analyse.

Notes

Pour fournir des informations de contexte supplémentaires à l'analyseur d'entrée manuscrite, vous pouvez ajouter des indications d'analyse à l'analyseur d'entrée manuscrite. Les indications d'analyse peuvent améliorer la précision de la reconnaissance. Par exemple, vous pouvez ajouter des informations relatives aux élément et aux repères pour les champs dans une application de formulaire.

Cette méthode crée un ContextNodeBase dont la valeur de la propriété Type est AnalysisHint() et ajoute la nouvelle indication à la collection SubNodes de la propriété RootNode de l'analyseur d'entrée manuscrite.

Pour ajouter des informations de contexte à l'indication, utilisez la méthode AddPropertyData de l'objet ContextNodeBase en affectant au paramètre propertyDataId l'un des identificateurs globaux uniques (GUID) de la classe PropertyGuidsForAnalysisHintsBase.

Si une zone infinie est assignée à une indication, appelée indication globale, l'analyseur d'entrée manuscrite applique le contexte de l'indication à toute entrée manuscrite qui ne se trouve pas dans la zone d'une autre indication. Plusieurs indications peuvent être attachées à un seul analyseur. Toutefois, vous ne pouvez attacher qu'une seule indication globale à un analyseur d'entrée manuscrite. Les indications non globales ne peuvent pas se chevaucher. Pour plus d'informations sur les types d'informations de contexte dans les indications, consultez PropertyGuidsForAnalysisHintsBase.

L'ajout d'une indication d'analyse ne marque pas la zone de l'indication pour une nouvelle analyse. Pour marquer la zone de l'indication en vue d'une nouvelle analyse, appelez la méthode Union de l'objet DirtyRegion avec la propriété Location de l'indication.

Pour plus d'informations sur l'analyse d'entrée manuscrite, consultez Ink Analysis Overview.

Exemples

L'exemple suivant crée une indication d'analyse, theAnalysisHint, pour le InkAnalyzerBase, theInkAnalyzerBase. Il définit ensuite theAnalysisHint comme une indication globale et ajoute les propriétés AllowPartialDictionaryTerms et Name à l'indication.

' Add a new, global analysis hint to the ink analyzer. 
Dim theAnalysisHintNode As System.Windows.Ink.AnalysisCore.ContextNodeBase = _
    theInkAnalyzerBase.CreateAnalysisHint()
theAnalysisHintNode.Location.MakeInfinite()
theAnalysisHintNode.AddPropertyData( _
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.AllowPartialDictionaryTerms, _
    True)
theAnalysisHintNode.AddPropertyData( _
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.Name, _
    "Allow Partial Dictionary Terms")

// Add a new, global analysis hint to the ink analyzer. 
System.Windows.Ink.AnalysisCore.ContextNodeBase theAnalysisHintNode =
    theInkAnalyzerBase.CreateAnalysisHint();
theAnalysisHintNode.Location.MakeInfinite();
theAnalysisHintNode.AddPropertyData(
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.AllowPartialDictionaryTerms,
    true);
theAnalysisHintNode.AddPropertyData(
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.Name,
    "Allow Partial Dictionary Terms");

Plateformes

Windows Vista, Windows XP SP2, Windows Server 2003

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.