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

Article
11/05/2008

Mise à jour : November 2007

Retourne une collection d'objets ContextNode descendants pertinents pour la plage de texte spécifiée dans la chaîne reconnue pour 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 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

Paramètres

start
Type : System.Int32%

length
Type : System.Int32%

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

Valeur de retour

Type : System.Windows.Ink.ContextNodeCollection
Collection d'objets ContextNode descendants correspondant à la plage de texte spécifiée dans la chaîne reconnue de la collection de nœuds descendants.

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 ». Par conséquent, il est probable que le ContextNodeCollection contienne un seul ContextNode, à savoir le InkWordNode qui correspond au mot « bien ». Dans cet exemple, 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 concerne les nœuds du paramètre subTree. 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 utilise la méthode GetNodesFromTextRange pour marquer les traits qui correspondent au texte sélectionné. L'exemple de code suppose que la valeur retournée par la méthode GetRecognizedString est affectée à la propriété Text du TextBox nommé theResultsTextBox. L'exemple suppose également que l'utilisateur a sélectionné du texte dans theResultsTextBox et qu'un InkAnalyzer nommé theInkAnalyzer existe.

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

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.