CustomRecognizerNode.GetNodesFromTextRange (Método) (Int32%, Int32%, ContextNodeCollection)

Artículo
11/26/2008

Actualización: noviembre 2007

Devuelve una colección de objetos ContextNode descendientes que son relevantes para el intervalo de texto especificado en la cadena reconocida de una colección de nodos descendientes.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink.Analysis (en Microsoft.Ink.Analysis.dll)

Sintaxis

'Declaración
Public Function GetNodesFromTextRange ( _
    ByRef start As Integer, _
    ByRef length As Integer, _
    subTree As ContextNodeCollection _
) As ContextNodeCollection
'Uso
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

Parámetros

start
Tipo: System.Int32%
Comienzo del intervalo de texto de la porción subTree de la cadena reconocida.

length
Tipo: System.Int32%
Longitud del intervalo de texto de la cadena reconocida.

subTree
Tipo: Microsoft.Ink.ContextNodeCollection
Objetos ContextNode descendientes a los que restringir la búsqueda.

Valor devuelto

Tipo: Microsoft.Ink.ContextNodeCollection
Colección de objetos ContextNode descendientes que son relevantes para el intervalo de texto especificado en la cadena reconocida de la colección de nodos descendientes.

Comentarios

El intervalo de texto especificado debe estar relacionado con la parte subTree de la cadena reconocida de este objeto CustomRecognizerNode y no con la cadena reconocida de todo el objeto CustomRecognizerNode o de toda la propiedad RootNode.

Los parámetros start y length son referencias, pues sus valores pueden cambiar. Por ejemplo, si el valor devuelto de GetRecognizedString es "I am late" y se pasan valores de start = 6 y length = 1, que corresponde a la letra "a". Es probable que la colección ContextNodeCollection tenga únicamente un objeto ContextNode, que será el objeto InkWordNode que se corresponde con la palabra "late". En este caso, el valor de start se modifica a 5 y el valor de length se modifica a 4, que corresponde a la palabra completa "late".

Nota El parámetro start depende de los nodos del parámetro subTree. En el ejemplo anterior, si se pasa un parámetro subTree con nodos para "am" y "late" pero no para "I", el intervalo de texto de la palabra "late" será un parámetro start con el valor 3 y una longitud con el valor 4.

Ejemplos

En el ejemplo siguiente se toma un objeto ContextNodeCollection, lastLineCollection, que contiene un objeto ContextNode que se corresponde con la última línea de CustomRecognizerNode, customRecognizer. A continuación, marca todas las propiedades Strokes en negro excepto aquellas que corresponden al texto seleccionado en la última línea, cuyo color cambia a rojo.

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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.