InkAnalyzer.CreateAnalysisHint-Methode (Rectangle)

Artikel
11/26/2008

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

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)

Syntax

'Declaration
Public Function CreateAnalysisHint ( _
    analysisHintRectangle As Rectangle _
) As AnalysisHintNode
'Usage
Dim instance As InkAnalyzer
Dim analysisHintRectangle As Rectangle
Dim returnValue As AnalysisHintNode

returnValue = instance.CreateAnalysisHint(analysisHintRectangle)

public AnalysisHintNode CreateAnalysisHint(
    Rectangle analysisHintRectangle
)

public:
AnalysisHintNode^ CreateAnalysisHint(
    Rectangle analysisHintRectangle
)

public AnalysisHintNode CreateAnalysisHint(
    Rectangle analysisHintRectangle
)

public function CreateAnalysisHint(
    analysisHintRectangle : Rectangle
) : AnalysisHintNode

Parameter

analysisHintRectangle
Typ: System.Drawing.Rectangle
Das Rechteck, auf das der Speicherort des Hinweises festgelegt wird.

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.

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

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

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

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