InkAnalyzerBase.GetNodesFromTextRange-Methode (Int32%, Int32%, ContextNodeBaseCollection)

Artikel
11/26/2008

Gibt eine Auflistung von Kontextknoten zurück, die für den angegebenen Textbereich des angegebenen Knotens relevant sind.

Namespace: System.Windows.Ink.AnalysisCore
Assembly: IACore (in IACore.dll)

Syntax

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

Parameter

start
Typ: System.Int32%
Ein Verweis auf den Anfang des Textbereichs in der erkannten Zeichenfolge.

length
Typ: System.Int32%
Ein Verweis auf die Länge des Textbereichs in der erkannten Zeichenfolge.

nodesToSearch
Typ: System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection
Die Kontextknoten, auf die die Suche beschränkt werden soll.

Rückgabewert

Typ: System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection
Die Auflistung von Kontextknoten, die für den angegebenen Textbereich des angegebenen Kontextknotens relevant sind.

Hinweise

Diese Methode ändert die Werte des start-Parameters und des length-Parameters, indem der Textbereich bis zu den nächsten Wortgrenzen erweitert wird.

Hinweis

Der start-Parameter und der length-Parameter beziehen sich auf die erkannte Zeichenfolge des nodesToSearch-Parameters.

Wenn die erkannte Zeichenfolge beispielsweise "I am late" lautet und Sie diese Methode mit den Parameterwerten 6 für start und 1 für length aufrufen (dies entspricht dem Buchstaben "a" in "late"), gibt diese Methode eine Auflistung zurück, die einen einzigen ContextNodeBase enthält. Die Auflistung enthält den Freihandwort- oder Textwortknoten, der dem Wort "late" entspricht. Für das vorliegende Beispiel ändert diese Methode auch den Wert von start in 5 und den Wert von length in 4. Dies entspricht dem Wort "late".

Beispiele

Im folgenden Beispiel wird der Kontextknoten abgerufen, der die ersten fünf Zeichen der ersten erkannten Zeichenfolge von ContextNodeBaseCollection mit dem Namen theLineNodes enthält. In diesem Beispiel sind theLineNodes im InkAnalyzerBase mit dem Namen theInkAnalyzerBase enthalten. Das Beispiel ruft Analysealternativen zu diesen Knoten ab und zeigt die Alternativen dann mit einer Hilfsmethode ShowAlternates an.

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);
}

Plattformen

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.