RootNode.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 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

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 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 ser relativo a la parte subTree de la cadena reconocida de este RootNode, en lugar de la cadena reconocida de todo el objeto RootNode.

Los parámetros start y length son referencias, pues sus valores pueden cambiar. Por ejemplo, el valor devuelto de GetRecognizedString es "I am late" y se pasan los valores start = 6 y length = 1, que se corresponden con 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, lastRegionCollection, que contiene un objeto ContextNode que corresponde al último párrafo de un objeto RootNode, theRootNode. 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 = theRootNode.GetNodesFromTextRange(start, length, lastRegionCollection)

' Set all strokes to black
Dim inkStroke As Stroke
For Each inkStroke In theRootNode.Strokes
    inkStroke.DrawingAttributes = New DrawingAttributes(Color.Black)
Next inkStroke
' Set strokes in the collection to red
Dim node As ContextNode
For Each node In selectedNodes
    For Each inkStroke In node.Strokes
        inkStroke.DrawingAttributes = New DrawingAttributes(Color.Red)
    Next inkStroke
Next node

            // 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 = 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.