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

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.

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 _
) As ContextNodeBaseCollection
'Uso
Dim instance As InkAnalyzerBase
Dim start As Integer
Dim length As Integer
Dim returnValue As ContextNodeBaseCollection

returnValue = instance.GetNodesFromTextRange(start, _
    length)

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

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

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

public function GetNodesFromTextRange(
    start : int, 
    length : int
) : 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.

Valor devuelto

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

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.

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 InkAnalyzerBase, theInkAnalyzerBase. 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 < theInkAnalyzerBase.GetRecognizedString().Length Then
    ' Get the nodes that correspond to the first five
    ' characters of the results for the ink analyzer.
    Dim selectionStart As Integer = 0
    Dim selectionLength As Integer = 5
    Dim selectedSubNodes As System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection = _
        theInkAnalyzerBase.GetNodesFromTextRange( _
            selectionStart, selectionLength)

    ' 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 < theInkAnalyzerBase.GetRecognizedString().Length)
{
    // Get the nodes that correspond to the first five
    // characters of the results for the ink analyzer.
    int selectionStart = 0;
    int selectionLength = 5;
    System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection selectedSubNodes =
        theInkAnalyzerBase.GetNodesFromTextRange(
            ref selectionStart, ref selectionLength);

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