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

Gibt eine Auflistung von untergeordneten ContextNode-Objekten zurück, die aus dem angegebenen Textbereich in der erkannten Zeichenfolge innerhalb einer Auflistung von untergeordneten Knoten stammen.

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 WritingRegionNode
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 ContextNode-Nachfolgerobjekte, auf die die Suche eingegrenzt werden soll.

Rückgabewert

Typ: Microsoft.Ink.ContextNodeCollection
Die Auflistung von ContextNode-Nachfolgerobjekten, die aus dem angegebenen Textbereich in der erkannten Zeichenfolge stammen. Die Knoten sind auf diejenigen begrenzt, die Nachfolger von subTree sind.

Hinweise

Der start-Parameter und der length-Parameter sind Verweise, da ihre Werte geändert werden können. Wenn der Rückgabewert von GetRecognizedString "I am late"lautet, und Sie die Werte start = 6 und length = 1 übergeben, entsprechen diese Parameterwerte dem Buchstaben "a". ContextNodeCollection verfügt dann wahrscheinlich nur über einen ContextNode, der den InkWordNode darstellt, der dem Wort "late" entspricht. In diesem Fall werden der Wert von start in 5 und der Wert von length in 4 geändert, was dem gesamten Word "late" entspricht.

Hinweis Der start-Parameter bezieht sich auf die Knoten im subTree-Teil der erkannten Zeichenfolge dieses WritingRegionNode-Objekts und nicht auf die erkannte Zeichenfolge des gesamten WritingRegionNode-Objekts oder des gesamten RootNode-Objekts. Wenn Sie im vorherigen Beispiel einen subTree-Parameter mit Knoten für "am" und "late" jedoch nicht für I" übergeben, definieren ein start-Parameter mit dem Wert 3 und eine Länge von 4 den Textbereich für das Wort "late".

Beispiele

Im folgenden Beispiel wird ein ContextNodeCollection-Objekt namens lastParagraphLevelCollection erfasst, das ein ContextNode-Objekt enthält, das dem letzten Absatz in einem WritingRegionNode namens writingRegion entspricht. Dann werden alle Strokes schwarz markiert, bis auf die im letzten Absatz, die rot markiert werden.

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

' Set all strokes to black
Dim inkStroke As Stroke
For Each inkStroke In writingRegion.Strokes
    inkStroke.DrawingAttributes = New DrawingAttributes(Color.Black)
Next inkStroke
' Set strokes in the collection to red
Dim node As ContextNode
For Each node In selectedNodes
    For Each inkStroke In node.Strokes
        inkStroke.DrawingAttributes = New DrawingAttributes(Color.Red)
    Next inkStroke
Next node

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

                // Set all strokes to black
                foreach (Stroke stroke in writingRegion.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.