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

Artículo
11/26/2008

Actualización: noviembre 2007

Devuelve una colección de objetos ContextNode descendientes que proceden del 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 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

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 proceden del intervalo de texto especificado en la cadena reconocida. Los nodos se limitan a los que son descendientes de subTree.

Comentarios

Los parámetros start y length son referencias, pues sus valores pueden cambiar. Si el valor devuelto de GetRecognizedString es "I am late" y se pasan valores de start = 6 y length = 1, 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 está relacionado con los nodos de la parte subTree de la cadena reconocida de este objeto WritingRegionNode y no con la cadena reconocida de todo el objeto WritingRegionNode o de toda la propiedad RootNode. 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, lastParagraphLevelCollection, que contiene un objeto ContextNode que corresponde al último párrafo de un objeto WritingRegionNode, writingRegion. A continuación, marca todas las propiedades Strokes en negro excepto las del último párrafo, cuyo color cambia a rojo.

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

' Set all strokes to black
Dim inkStroke As Stroke
For Each inkStroke In writingRegion.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 =
                    writingRegion.GetNodesFromTextRange(ref start, ref length, lastParagraphCollection);

                // Set all strokes to black
                foreach (Stroke stroke in writingRegion.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.