InkAnalyzer.GetNodesFromTextRange-Methode (Int32%, Int32%)

Artikel
10/28/2008

Gibt eine ContextNodeCollection mit den ContextNode-Objekten zurück, die für den angegebenen Textbereich relevant sind.

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

Syntax

'Declaration
Public Function GetNodesFromTextRange ( _
    ByRef start As Integer, _
    ByRef length As Integer _
) As ContextNodeCollection
'Usage
Dim instance As InkAnalyzer
Dim start As Integer
Dim length As Integer
Dim returnValue As ContextNodeCollection

returnValue = instance.GetNodesFromTextRange(start, _
    length)

public ContextNodeCollection GetNodesFromTextRange(
    ref int start,
    ref int length
)

public:
ContextNodeCollection^ GetNodesFromTextRange(
    int% start, 
    int% length
)

public ContextNodeCollection GetNodesFromTextRange(
    /** @ref */int start,
    /** @ref */int length
)

public function GetNodesFromTextRange(
    start : int, 
    length : int
) : ContextNodeCollection

Parameter

start
Typ: System.Int32%

length
Typ: System.Int32%

Rückgabewert

Typ: System.Windows.Ink.ContextNodeCollection
Die Auflistung von ContextNode-Objekten, die für den angegebenen Textbereich relevant sind.

Hinweise

Der Textbereich sollte relativ zur erkannten Zeichenfolge des gesamten InkAnalyzer sein.

Diese Methode ändert die Werte des start-Parameters und des length-Parameters, indem der Textbereich bis zu den nächsten Wortgrenzen erweitert wird. Wenn die erkannte Zeichenfolge beispielsweise "I am late" lautet, rufen Sie diese Methode mit den Parameterwerten 6 für start und 1 für length (entspricht dem Buchstaben "a" in "late") auf. Die Methode gibt eine Auflistung mit einem einzigen ContextNode zurück, und zwar dem InkWordNode oder dem TextWordNode. Im vorliegenden Beispiel ändert diese Methode auch den Wert von start zu 5 und den Wert von length zu 4. Dies entspricht dem Wort "late".

Beispiele

In diesem Beispiel wird die Text-Eigenschaft eines TextBox namens theResultsTextBox von dem durch GetRecognizedString() für den InkAnalyzer (theInkAnalyzer) zurückgegebenen Wert auf neue Werte in der Textfeldauswahl zurückgesetzt, die die der Textfeldauswahl entsprechenden Strokes markieren.

' Find out what's been selected in the text box
Dim selStart As Integer = theResultsTextBox.SelectionStart
Dim selLength As Integer = theResultsTextBox.SelectionLength

' Get the nodes that correspond to that range
Dim selectedSubNodes As ContextNodeCollection = _
    Me.theInkAnalyzer.GetNodesFromTextRange(selStart, selLength)

' Use the new start and length value to update the
' selection in the TextBox
theResultsTextBox.SelectionStart = selStart
theResultsTextBox.SelectionLength = selLength

' First, set all strokes to black
For Each theStroke As Stroke In Me.theInkAnalyzer.RootNode.Strokes
    theStroke.DrawingAttributes.Color = Colors.Black
Next theStroke

' Next, set all selected sub nodes to red
For Each theContextNode As ContextNode In selectedSubNodes
    For Each theStroke As Stroke In theContextNode.Strokes
        theStroke.DrawingAttributes.Color = Colors.Red
    Next theStroke
Next theContextNode

// Find out what's been selected in the text box
int selStart = theResultsTextBox.SelectionStart;
int selLength = theResultsTextBox.SelectionLength;

// Get the nodes that correspond to that range
ContextNodeCollection selectedSubNodes =
    this.theInkAnalyzer.GetNodesFromTextRange(
        ref selStart, ref selLength);

// Use the new start and length value to update the
// selection in the TextBox
theResultsTextBox.SelectionStart = selStart;
theResultsTextBox.SelectionLength = selLength;

// First, set all strokes to black
foreach (Stroke theStroke
    in this.theInkAnalyzer.RootNode.Strokes)
{
    theStroke.DrawingAttributes.Color = Colors.Black;
}

// Next, set all selected sub nodes to red
foreach (ContextNode theContextNode in selectedSubNodes)
{
    foreach (Stroke theStroke in theContextNode.Strokes)
    {
        theStroke.DrawingAttributes.Color = Colors.Red;
    }
}

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.