LineNode.GetNodesFromTextRange-Methode (Int32%, Int32%, ContextNodeCollection)

Artikel
11/26/2008

Gibt eine Auflistung von untergeordneten ContextNode-Objekten zurück, die innerhalb einer Auflistung von untergeordneten Knoten für den angegebenen Textbereich in der erkannten Zeichenfolge relevant sind.

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

Syntax

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

returnValue = instance.GetNodesFromTextRange(start, _
    length, subTree)

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

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

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

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

Parameter

start
Typ: System.Int32%
Der Anfang des Textbereichs im subTree-Teil der erkannten Zeichenfolge.

length
Typ: System.Int32%
Die Länge des Textbereichs in der erkannten Zeichenfolge.

subTree
Typ: Microsoft.Ink.ContextNodeCollection
Die untergeordneten ContextNode-Objekte, auf die die Suche eingegrenzt werden soll.

Rückgabewert

Typ: Microsoft.Ink.ContextNodeCollection
Die Auflistung von ContextNode-Nachfolgerobjekten, die sich innerhalb einer Auflistung von untergeordneten Nachfolgerknoten auf den angegebenen Textbereich in der erkannten Zeichenfolge beziehen.

Hinweise

Der angegebene Textbereich sollte auf den subTree-Teil der erkannten Zeichenfolge dieses LineNode Bezug nehmen, und nicht auf die erkannte Zeichenfolge des gesamten LineNode oder des gesamten RootNode.

Der start-Parameter und der length-Parameter sind Verweise, da ihre Werte geändert werden können. Wenn beispielsweise der Rückgabewert von GetRecognizedString "I am late" ist und Sie die Werte startnbsp;=nbsp;6 und lengthnbsp;=nbsp;1 übergeben, was dem Buchstaben "a" entspricht, enthält die ContextNodeCollection wahrscheinlich nur einen ContextNode, nämlich den InkWordNode, der dem Wort "late" entspricht. In diesem Fall wird der Wert von start in 5 und der Wert von length in 4 geändert, was dem gesamten Wort "late" entspricht.

Hinweis

Der start-Parameter steht in Bezug zu den Knoten im subTree-Parameter. Wenn Sie im vorherigen Beispiel einen subTree-Parameter mit Knoten für "am" und "late", aber nicht für "I" übergeben, wären ein start-Parameter von 3 und eine Länge von 4 der Textbereich für das Wort "late."

Beispiele

Im folgenden Beispiel wird ein ContextNodeCollection-Objekt (lastWordCollection) verwendet, das ein ContextNode-Objekt enthält, das dem letzten Wort in einem LineNode (line) entspricht. Dann werden alle Strokes schwarz markiert, mit Ausnahme der Striche, die dem in der letzten Zeile ausgewählten Text entsprechen, deren Farbe in rot geändert wird.

' Get the nodes that correspond to this start and length
Dim selectedNodes As ContextNodeCollection = _
    line.GetNodesFromTextRange(start, length, lastWordCollection)

' Set all strokes to black
Dim stroke As Stroke
For Each stroke In line.Strokes
    stroke.DrawingAttributes = New DrawingAttributes(Color.Black)
Next

' Set strokes in the collection to red
Dim node As ContextNode
For Each node In selectedNodes
    For Each stroke In node.Strokes
        stroke.DrawingAttributes = New DrawingAttributes(Color.Red)
    Next
Next

// Get the nodes that correspond to this start and length
ContextNodeCollection selectedNodes =
    line.GetNodesFromTextRange(ref start, ref length, lastWordCollection);

// Set all strokes to black
foreach (Stroke stroke in line.Strokes)
    stroke.DrawingAttributes = new DrawingAttributes(Color.Black);

// Set strokes in the collection to red
foreach (ContextNode node in selectedNodes)
{
    foreach (Stroke stroke in node.Strokes)
    {
        stroke.DrawingAttributes = new DrawingAttributes(Color.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.