InkAnalyzer.CreateAnalysisHint-Methode (Rect)

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

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

Syntax

'Declaration
Public Function CreateAnalysisHint ( _
    rectangle As Rect _
) As AnalysisHintNode
'Usage
Dim instance As InkAnalyzer
Dim rectangle As Rect
Dim returnValue As AnalysisHintNode

returnValue = instance.CreateAnalysisHint(rectangle)

public AnalysisHintNode CreateAnalysisHint(
    Rect rectangle
)

public:
AnalysisHintNode^ CreateAnalysisHint(
    Rect rectangle
)

public AnalysisHintNode CreateAnalysisHint(
    Rect rectangle
)

public function CreateAnalysisHint(
    rectangle : Rect
) : AnalysisHintNode

Parameter

rectangle
Typ: System.Windows.Rect

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.

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 mit dem Namen theInkAnalyzerWithHint erstellt. Der Bereich des neuen Hinweises wird auf das Rechteck mit dem Namen theAnalysisRegion festgelegt. Für den Hinweis werden dann die folgenden Eigenschaften festgelegt:

' Add a new analysis hint to theInkAnalyzer.
Dim theAnalysisHint As AnalysisHintNode = Me.theInkAnalyzer.CreateAnalysisHint(theAnalysisRegion.GetBounds())

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

// Add a new analysis hint to theInkAnalyzer.
AnalysisHintNode theAnalysisHint =
    this.theInkAnalyzer.CreateAnalysisHint(theAnalysisRegion.GetBounds());

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.