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

Artikel
10/28/2008

Gibt eine Auflistung von untergeordneten ContextNode-Objekten von dem festgelegten Textbereich in der erkannten Zeichenfolge im Rahmen der Auflistung der untergeordneten Knoten zurück.

Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.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%

length
Typ: System.Int32%

subTree
Typ: System.Windows.Ink.ContextNodeCollection
Die untergeordneten ContextNode-Objekte, die zur Eingrenzung der Suche eingesetzt werden.

Rückgabewert

Typ: System.Windows.Ink.ContextNodeCollection
Die Auflistung von untergeordneten ContextNode-Objekten, die von dem angegebenen Textbereich in der erkannten Zeichenfolge sind. Die Knoten sind auf diejenigen begrenzt, die Nachfolger von subTree sind.

Hinweise

Der start-Parameter und der length-Parameter sind Verweiswerte, die geändert werden können, sodass die gesamte Zeichenfolge angegeben wird, die der zurückgegebenen ContextNodeCollection zugeordnet ist. Wenn beispielsweise der Rückgabewert für GetRecognizedString "I am late" ist und Sie Werte von start = 6 und length = 1 übergeben, entsprechen die Parameter dem Buchstaben "a." In diesem Fall hat ContextNodeCollection möglicherweise nur einen ContextNode: einen InkWordNode, 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 steht in Bezug zu den Knoten im subTree-Teil der erkannten Zeichenfolge dieses WritingRegionNode und nicht zu der erkannten Zeichenfolge des gesamten WritingRegionNode oder des gesamten RootNode. 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

Das folgende Beispiel implementiert eine ContextNodeCollection, lastParagraphLevelCollection. Diese Auflistung enthält einen ContextNode, der dem letzten Absatz in einem WritingRegion mit dem Namen writingRegion entspricht. Dann werden alle Strokes schwarz markiert, außer denen 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
For Each stroke As Stroke In writingRegion.Strokes
    stroke.DrawingAttributes.Color = Colors.Black
Next stroke

' Set strokes in the collection to red
For Each node As ContextNode In selectedNodes
    For Each stroke As Stroke In node.Strokes
        stroke.DrawingAttributes.Color = Colors.Red
    Next stroke
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.Color = Colors.Black;

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