InkAnalyzerBase.GetNodesFromTextRange (Método) (Int32%, Int32%, ContextNodeBaseCollection)

Artículo
11/26/2008

Actualización: noviembre 2007

Devuelve una colección de nodos de contexto que son pertinentes al intervalo de texto especificado de los nodos especificados.

Espacio de nombres: System.Windows.Ink.AnalysisCore
Ensamblado: IACore (en IACore.dll)

Sintaxis

'Declaración
Public Function GetNodesFromTextRange ( _
    ByRef start As Integer, _
    ByRef length As Integer, _
    nodesToSearch As ContextNodeBaseCollection _
) As ContextNodeBaseCollection
'Uso
Dim instance As InkAnalyzerBase
Dim start As Integer
Dim length As Integer
Dim nodesToSearch As ContextNodeBaseCollection
Dim returnValue As ContextNodeBaseCollection

returnValue = instance.GetNodesFromTextRange(start, _
    length, nodesToSearch)

public ContextNodeBaseCollection GetNodesFromTextRange(
    ref int start,
    ref int length,
    ContextNodeBaseCollection nodesToSearch
)

public:
ContextNodeBaseCollection^ GetNodesFromTextRange(
    int% start, 
    int% length, 
    ContextNodeBaseCollection^ nodesToSearch
)

public ContextNodeBaseCollection GetNodesFromTextRange(
    /** @ref */int start,
    /** @ref */int length,
    ContextNodeBaseCollection nodesToSearch
)

public function GetNodesFromTextRange(
    start : int, 
    length : int, 
    nodesToSearch : ContextNodeBaseCollection
) : ContextNodeBaseCollection

Parámetros

start
Tipo: System.Int32%
Referencia al inicio del intervalo de texto de la cadena reconocida.

length
Tipo: System.Int32%
Referencia a la longitud del intervalo de texto de la cadena reconocida.

nodesToSearch
Tipo: System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection
Nodos de contexto a los que se limitará la búsqueda.

Valor devuelto

Tipo: System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection
Colección de nodos de contexto que son pertinentes al intervalo de texto especificado de los nodos de contexto especificados.

Comentarios

Este método modifica los valores de los parámetros start y length al expandir el intervalo de texto a los límites de la palabra más próximos.

Nota

Los parámetros length y start son relativos a la cadena reconocida del parámetro nodesToSearch.

Por ejemplo, si la cadena reconocida es "I am late" y se llama a este método el valor de parámetro 6 para start y 1 para length, que corresponde a la letra "a" de "late", este método devuelve una colección que contiene un único objeto ContextNodeBase. La colección contiene el nodo de palabra de texto o la palabra de entrada manuscrita que corresponde a la palabra "late". En este ejemplo, este método modifica también el valor de start a 5 y el valor de length a 4, lo que corresponde a la palabra "late".

Ejemplos

En el ejemplo siguiente, se obtienen los nodos de contexto que contienen los cinco primeros caracteres de la principal cadena reconocida del objeto ContextNodeBaseCollection, theLineNodes. En este ejemplo, theLineNodes están contenidos en InkAnalyzerBase, theInkAnalyzerBase. En el ejemplo, se recuperan las alternativas de análisis para estos nodos y, a continuación, se muestran las alternativas a través de un método auxiliar, ShowAlternates.

If 5 < theRecognizedString.Length Then
    ' Get the nodes that correspond to the first five
    ' characters of the results for the line nodes.
    Dim selectionStart As Integer = 0
    Dim selectionLength As Integer = 5
    Dim selectedSubNodes As System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection = _
        theInkAnalyzerBase.GetNodesFromTextRange( _
            selectionStart, selectionLength, theLineNodes)

    ' Get analysis alternates for corresponding nodes.
    Dim theAlternates As System.Windows.Ink.AnalysisCore.AnalysisAlternateBaseCollection = _
        theInkAnalyzerBase.GetAlternates(selectedSubNodes)

    ' Display the alternates using a helper method.
    Me.ShowAlternates("Alternates for the selection:", theAlternates)
End If

if (5 < theRecognizedString.Length)
{
    // Get the nodes that correspond to the first five
    // characters of the results for the line nodes.
    int selectionStart = 0;
    int selectionLength = 5;
    System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection selectedSubNodes =
        theInkAnalyzerBase.GetNodesFromTextRange(
            ref selectionStart, ref selectionLength, theLineNodes);

    // Get analysis alternates for corresponding nodes.
    System.Windows.Ink.AnalysisCore.AnalysisAlternateBaseCollection theAlternates =
        theInkAnalyzerBase.GetAlternates(selectedSubNodes);

    // Display the alternates using a helper method.
    this.ShowAlternates(
        "Alternates for the selection:", theAlternates);
}

Plataformas

Windows Vista, Windows XP SP2, Windows Server 2003

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