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

Artikel
11/26/2008

Gibt eine ContextNodeCollection zurück, die untergeordnete ContextNode-Objekte enthält, die innerhalb einer Auflistung von untergeordneten Knoten für den angegebenen Textbereich in der erkannten Zeichenfolge relevant sind.

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

Rückgabewert

Typ: System.Windows.Ink.ContextNodeCollection
Eine ContextNodeCollection, die ContextNode-Objekte enthält, die innerhalb einer Auflistung von untergeordneten Knoten für den angegebenen Textbereich in der erkannten Zeichenfolge relevant sind.

Hinweise

Der angegebene Textbereich sollte relativ zu dem subTree-Teil der erkannten Zeichenfolge dieses ParagraphNodesein, und nicht zu der erkannten Zeichenfolge des gesamten [T:System.Windows.Ink. ParagraphNode] oder des gesamten RootNode.

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." Die ContextNodeCollection hat dann möglicherweise nur einen ContextNode, den [T:System.Windows.Ink.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-Parameter. Wenn Sie im vorherigen Beispiel einen subTree-Parameter mit Knoten für "am" und "late", aber nicht für "I" übergeben, besitzt der Textbereich für das Wort "late" den start-Parameter 3 und die Länge 4.

Beispiele

Im folgenden Beispiel wird ein ContextNodeCollection-Objekt, lastLineCollection, erfasst, das ein ContextNode-Objekt enthält, das der letzten Zeile eines ParagraphNode, paragraph 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 = _
    paragraph.GetNodesFromTextRange(start, length, lastLineCollection)

' Set all strokes to black

For Each stroke As Stroke In paragraph.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 =
    paragraph.GetNodesFromTextRange(ref start, ref length, lastLineCollection);

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