LineNode.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 LineNode
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 objeto LineNode y no con la cadena reconocida de todo el objeto LineNode 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 pasa los valores start = 6 y length = 1 en relación con la letra "a", ContextNodeCollection seguramente tenga un solo ContextNode, que es el InkWordNode que corresponde a la palabra "late". En este caso, el valor de start se cambiará a 5 y el valor de length se cambiará 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" es 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, lastWordCollection, que contiene un objeto ContextNode que se corresponde con la última palabra de LineNode, line. 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 = _
    line.GetNodesFromTextRange(start, length, lastWordCollection)

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

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

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

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