WritingRegionNode.GetNodesFromTextRange, méthode (Int32%, Int32%, ContextNodeCollection)

Article
11/05/2008

Mise à jour : November 2007

Retourne une collection d'objets ContextNode descendants à partir de la plage de texte spécifiée dans une collection de nœuds descendants.

Espace de noms : System.Windows.Ink
Assembly : IAWinFX (dans IAWinFX.dll)

Syntaxe

'Déclaration
Public Function GetNodesFromTextRange ( _
    ByRef start As Integer, _
    ByRef length As Integer, _
    subTree As ContextNodeCollection _
) As ContextNodeCollection
'Utilisation
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

Paramètres

start
Type : System.Int32%

length
Type : System.Int32%

subTree
Type : System.Windows.Ink.ContextNodeCollection
Objets ContextNode descendants utilisés pour limiter la recherche.

Valeur de retour

Type : System.Windows.Ink.ContextNodeCollection
Collection d'objets ContextNode descendants à partir de la plage de texte spécifiée dans la chaîne reconnue. Les nœuds sont limités aux descendants de subTree.

Notes

Les paramètres start et length sont des valeurs de référence pouvant être modifiées pour spécifier l'ensemble de la chaîne associée au ContextNodeCollection retourné. Par exemple, si la valeur de retour de la méthode GetRecognizedString est « Je vais bien », vous pouvez définir les valeurs start = 9 et length = 1, ce qui correspond à la lettre « i ». Dans ce cas, il est probable que le ContextNodeCollection ait juste un ContextNode, un InkWordNode qui correspond au mot « bien ». Dans ce cas, la valeur de start passe à 8 et la valeur de length passe à 4, ce qui correspond au mot « bien » en entier.

Remarque Le paramètre start dépend plus des nœuds de la partie subTree de la chaîne reconnue du WritingRegionNode, que de la chaîne reconnue du WritingRegionNode complet ou de la propriété RootNode complète. Dans l'exemple précédent, si vous passez un paramètre subTree avec des nœuds pour « vais » et « bien », mais pas pour « je », un paramètre start égal à 5 et une longueur égale à 4 représentent la plage de texte du mot « bien ».

Exemples

L'exemple suivant prend un ContextNodeCollection, lastParagraphLevelCollection. Cette collection contient un ContextNode qui correspond au dernier paragraphe d'un WritingRegion nommé writingRegion. L'ensemble des Strokes est ensuite marqué en noir à l'exception de ceux du dernier paragraphe, qui deviennent rouge.

' 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;
    }
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.