InkAnalyzer.CreateAnalysisHint-Methode

Artikel
10/28/2008

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

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.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: Microsoft.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. Rufen Sie die Union-Methode des DirtyRegion-Objekts mit der Location-Eigenschaft des Hinweises auf, um den Bereich im Hinweis für eine erneute Analyse zu markieren.

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

Beispiele

In diesem Beispiel wird ein AnalysisHintNode mit dem Namen theAnalysisHint für den InkAnalyzertheInkAnalyzerWithHint erstellt, und theAnalysisHint wird als globaler Hinweis festgelegt. Für den Hinweis werden dann die folgenden Eigenschaften festgelegt:

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

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

// Add a new, global analysis hint to theInkAnalyzerWithHint.
Microsoft.Ink.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.