InkAnalyzer.CreateAnalysisHint-Methode

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

Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)

Syntax

'Declaration
Public Function CreateAnalysisHint As AnalysisHintNode
'Usage
Dim instance As InkAnalyzer
Dim returnValue As AnalysisHintNode

returnValue = instance.CreateAnalysisHint()

public AnalysisHintNode CreateAnalysisHint()

public:
AnalysisHintNode^ CreateAnalysisHint()

public AnalysisHintNode CreateAnalysisHint()

public function CreateAnalysisHint() : AnalysisHintNode

Rückgabewert

Typ: System.Windows.Ink.AnalysisHintNode
Der neue AnalysisHintNode, der dem Freihandanalysemodul hinzugefügt wird.

Hinweise

Das Freihandanalysemodul fügt den neuen AnalysisHintNode als untergeordneten Knoten von RootNode des Analysemoduls hinzu.

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.

Der neue AnalysisHintNode stellt einen leeren Bereich dar, bis Sie seine Location-Eigenschaft aktualisieren.

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 einzelnes Freihandanalysemodul kann jedoch nur ein globaler Hinweis angefügt werden, und ein Bereich eines nicht globalen Hinweises kann den Bereich eines globalen Hinweises nicht überlappen. Weitere Informationen zu den Arten von Kontextinformationen, die von einem Hinweis bereitgestellt werden können, finden Sie unter AnalysisHintNode.

Beispiele

In diesem Beispiel wird ein AnalysisHintNode mit dem Namen theAnalysisHint für den InkAnalyzer namens theInkAnalyzerWithHint) erstellt. Außerdem wird theAnalysisHint zu einem globalen Hinweis gemacht, und es werden die folgenden Eigenschaften für den Hinweis festgelegt.

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

theAnalysisHint.AllowPartialDictionaryTerms = True
theAnalysisHint.Name = "Allow Partial Dictionary Terms"

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

theAnalysisHint.AllowPartialDictionaryTerms = true;
theAnalysisHint.Name = "Allow Partial Dictionary Terms";

Plattformen

Windows Vista

.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.