CustomRecognizerNode.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 d'une collection de nœuds descendants.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink.Analysis (dans Microsoft.Ink.Analysis.dll)

Syntaxe

'Déclaration
Public Function GetNodesFromTextRange ( _
    ByRef start As Integer, _
    ByRef length As Integer, _
    subTree As ContextNodeCollection _
) As ContextNodeCollection
'Utilisation
Dim instance As CustomRecognizerNode
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%
Début de la plage de texte dans la partie subTree de la chaîne reconnue.

length
Type : System.Int32%
Longueur de la plage de texte dans la chaîne reconnue.

subTree
Type : Microsoft.Ink.ContextNodeCollection
Objets ContextNode descendants auxquels limiter la recherche.

Valeur de retour

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

Notes

La plage de texte spécifiée doit être relative à la portion subTree de la chaîne reconnue de ce CustomRecognizerNode plutôt qu'à la chaîne reconnue de l'ensemble du CustomRecognizerNode ou de la propriété RootNode.

Les paramètres start et length sont des références car leurs valeurs peuvent être modifiées. Par exemple, si la valeur de retour de la méthode GetRecognizedString est « Je vais bien » et que vous passez les valeurs de start = 9 et length = 1, ce qui correspond à la lettre « i ». Il est possible que le ContextNodeCollection n'ait qu'un seul ContextNode, c'est-à-dire le 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 est relatif aux 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 prend un objet ContextNodeCollection, lastLineCollection, qui contient un objet ContextNode qui correspond à la dernière ligne d'un CustomRecognizerNode, customRecognizer. L'ensemble des Strokes est ensuite marqué en noir à l'exception des traits correspondant au texte sélectionné dans la dernière ligne, qui passent en rouge.

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

' Set all strokes to black
Dim theStroke As Stroke
For Each theStroke In customRecognizer.Strokes
    theStroke.DrawingAttributes = New DrawingAttributes(Color.Black)
Next theStroke

' Set strokes in the collection to red
Dim node As ContextNode
For Each node In selectedNodes
    For Each theStroke In node.Strokes
        theStroke.DrawingAttributes = New DrawingAttributes(Color.Red)
    Next theStroke
Next node

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

                // Set all strokes to black
                foreach (Stroke stroke in customRecognizer.Strokes)
                    stroke.DrawingAttributes = new DrawingAttributes(Color.Black);

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