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

Artikel
11/26/2008

Gibt eine Auflistung von Kontextknoten zurück, die für den angegebenen Textbereich 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 _
) As ContextNodeBaseCollection
'Usage
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

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.

Rückgabewert

Typ: System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection
Die Auflistung von Kontextknoten, die für den angegebenen Textbereich 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.

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 InkAnalyzerBase mit dem Namen theInkAnalyzerBase enthält. Es ruft Analysealternativen zu diesen Knoten ab und zeigt die Alternativen dann mit einer Hilfsmethode ShowAlternates an.

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

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.