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

Artikel
10/28/2008

Gibt eine Auflistung von ContextNode-Nachfolgeobjekten zurück, die sich auf den angegebenen Textbereich in der erkannten Zeichenfolge für eine Auflistung von Nachfolgerknoten beziehen.

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 RootNode
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 ContextNode-Nachfolgeobjekte, die zum Einschränken der Suche verwendet werden.

Rückgabewert

Typ: System.Windows.Ink.ContextNodeCollection
Die Auflistung der ContextNode-Nachfolgeobjekte, die innerhalb der Auflistung der Nachfolgerknoten dem angegebenen Textbereich in der erkannten Zeichenfolge entsprechen.

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 diese Parameter dem Buchstaben "a". Folglich enthält die ContextNodeCollection wahrscheinlich nur einen ContextNode, nämlich einen InkWordNode, welcher dem Wort "late" entspricht. In diesem Beispiel wird der Wert von start zu 5, und der Wert von length zu 4 geändert. Dies entspricht dem gesamten Wort "late".

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, ergibt ein start-Parameterwert von 3 und ein Längenwert von 4 den Textbereich für das Wort "late".

Beispiele

Im folgenden Beispiel wird die GetNodesFromTextRange-Methode verwendet, um den Strich zu markieren, der dem ausgewählten Text entspricht. Der Beispielcode geht davon aus, dass die Text-Eigenschaft der TextBox mit dem Namen theResultsTextBox auf den von der GetRecognizedString-Methode zurückgegebenen Wert festgelegt ist. Das Beispiel geht außerdem davon aus, dass der Benutzer in der theResultsTextBox Text ausgewählt hat, und dass ein InkAnalyzer mit dem Namen theInkAnalyzer vorhanden ist.

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

    ' Set all strokes to black
    For Each stroke As Stroke In theRootNode.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

End Sub 'showLastWritingRegion_Click

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

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