InkAnalyzerBase.CreateAnalysisHint-Methode

Artikel
11/26/2008

Fügt dem Freihandanalysemodul einen neuen Analysehinweis mit einem leeren Bereich hinzu.

Namespace: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)

Syntax

'Declaration
Public Function CreateAnalysisHint As ContextNodeBase
'Usage
Dim instance As InkAnalyzerBase
Dim returnValue As ContextNodeBase

returnValue = instance.CreateAnalysisHint()

public ContextNodeBase CreateAnalysisHint()

public:
ContextNodeBase^ CreateAnalysisHint()

public ContextNodeBase CreateAnalysisHint()

public function CreateAnalysisHint() : ContextNodeBase

Rückgabewert

Typ: System.Windows.Ink.AnalysisCore.ContextNodeBase
Der neue Analysehinweis.

Hinweise

Um dem Freihandanalysemodul zusätzlichen Kontext bereitzustellen, können Sie ihm Analysehinweise hinzufügen. Analysehinweise können die Erkennungsgenauigkeit verbessern. So können Sie zum Beispiel Faktoid- und Führungslinieninformationen für Felder in einer Formularanwendung hinzufügen.

Diese Methode erstellt einen neuen ContextNodeBase mit einem Type-Eigenschaftswert von AnalysisHint() und fügt der SubNodes-Auflistung des RootNode des Freihandanalysemoduls den neuen Hinweis hinzu.

Um dem Hinweis Kontextinformationen hinzuzufügen, verwenden Sie die AddPropertyData-Methode des ContextNodeBase-Objekts, und legen Sie den propertyDataId-Parameter auf eine der GUIDs (Globally Unique Identifier) in der PropertyGuidsForAnalysisHintsBase-Klasse fest.

Wenn einem unendlichen Bereich ein Hinweis zugewiesen wird, der als globaler Hinweis bezeichnet wird, wendet das Freihandanalysemodul den Kontext des Hinweises auf sämtliche Freihandelemente an, die sich nicht im Bereich eines anderen Hinweises befinden. An ein einzelnes Analysemodul können mehrere Hinweise angefügt werden. An ein einziges Freihandanalysemodul kann jedoch nur ein globaler Hinweis angefügt werden, und nicht globale Hinweise können einander nicht überlappen. Weitere Informationen zu den Arten von Kontextinformationen, die von einem Hinweis bereitgestellt werden können, finden Sie unter PropertyGuidsForAnalysisHintsBase.

Durch Hinzufügen eines Analysehinweises wird der Bereich des Hinweises nicht für eine erneute Analyse markiert. Um den Bereich im Hinweis für eine erneute Analyse zu markieren, rufen Sie die Union-Methode des DirtyRegion-Objekts mit der Location des Hinweises auf.

Weitere Informationen zur Freihandanalyse finden Sie unter Ink Analysis Overview.

Beispiele

Im folgenden Beispiel wird ein Analysehinweis theAnalysisHint für InkAnalyzerBase mit dem Namen theInkAnalyzerBase erstellt. Anschließend wird theAnalysisHint als globaler Hinweis festgelegt, und dem Hinweis werden die AllowPartialDictionaryTerms-Eigenschaft und die Name-Eigenschaft hinzugefügt.

' 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");

Plattformen

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.