Metodo InkAnalyzerBase.GetNodesFromTextRange (Int32%, Int32%, ContextNodeBaseCollection)

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce un insieme di nodi di contesto rilevanti per l'intervallo di testo specificato dei nodi specificati.

Spazio dei nomi: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)

Sintassi

'Dichiarazione
Public Function GetNodesFromTextRange ( _
    ByRef start As Integer, _
    ByRef length As Integer, _
    nodesToSearch As ContextNodeBaseCollection _
) As ContextNodeBaseCollection
'Utilizzo
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

Parametri

start
Tipo: System.Int32%
Riferimento all'inizio dell'intervallo di testo nella stringa riconosciuta.

length
Tipo: System.Int32%
Riferimento alla lunghezza dell'intervallo di testo nella stringa riconosciuta.

nodesToSearch
Tipo: System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection
Nodi di contesto ai quali limitare la ricerca.

Valore restituito

Tipo: System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection
Insieme di nodi di contesto rilevanti per l'intervallo di testo specificato dei nodi di contesto specificati.

Note

Questo metodo modifica i valori dei parametri start e length espandendo l'intervallo di testo ai limiti della parola più vicina.

Nota

I parametri start e length sono relativi alla stringa riconosciuta del parametro nodesToSearch.

Se, ad esempio, la stringa riconosciuta è "I am late" e questo metodo viene chiamato utilizzando i valori di parametro 6 per start e 1 per length, corrispondente alla lettera "a" in "late", questo metodo restituisce un insieme contenente un singolo oggetto ContextNodeBase. L'insieme contiene il nodo della parola dell'input penna o della parola del testo che corrisponde alla parola "late". In questo esempio questo metodo imposta inoltre il valore di start su 5 e il valore di length su 4, che corrisponde alla parola "late".

Esempi

Nell'esempio seguente si ottengono i nodi di contesto che contengono i primi cinque caratteri della prima stringa riconosciuta dell'oggetto ContextNodeBaseCollection, theLineNodes. In questo esempio, theLineNodes sono contenuti dall'oggetto InkAnalyzerBase, theInkAnalyzerBase. Nell'esempio vengono recuperate le alternative di analisi per questi nodi che vengono successivamente visualizzate tramite un metodo di supporto, 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);
}

Piattaforme

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.