InkAnalyzerBase.GetNodesFromTextRange 方法 (Int32%, Int32%, ContextNodeBaseCollection)

發行項
10/29/2008

傳回與指定節點的指定文字範圍相關聯的內容節點集合。

命名空間： System.Windows.Ink.AnalysisCore
組件： IACore (在 IACore.dll 中)

語法

'宣告
Public Function GetNodesFromTextRange ( _
    ByRef start As Integer, _
    ByRef length As Integer, _
    nodesToSearch As ContextNodeBaseCollection _
) As ContextNodeBaseCollection
'用途
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

參數

start
型別：System.Int32%
已辨識字串中文字範圍開頭的參考。

length
型別：System.Int32%
已辨識字串中文字範圍長度的參考。

nodesToSearch
型別：System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection
要做為限制搜尋範圍的內容節點。

傳回值

型別：System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection
與指定內容節點的指定文字範圍相關聯的內容節點集合。

備註

這個方法會透過將文字範圍擴充至最接近的文字界限修改 start 和 length 參數的值。

注意事項：
start 和 length 參數與 nodesToSearch 參數的已辨識字串相關聯。

例如，如果辨識的字串為 "I am late"，而且您針對 start 使用參數值 6 以及針對 length 使用 1 呼叫這個方法，而該參數對應至 "late" 中的字母 "a"，則這個方法會傳回包含單一 ContextNodeBase 的集合。這個集合包含對應至 "late" 這個字的筆墨單字或文字節點。在這個範例中，這個方法也會將 start 的值修改為 5 並將 length 的值修改為 4，這會對應於 "late" 一字。

範例

下列範例會取得內容節點，其中包含 ContextNodeBaseCollection (theLineNodes) 之頂端辨識字串的前五個字元。在這個範例中，theLineNodes 包含在 InkAnalyzerBasetheInkAnalyzerBase 中。範例會擷取這些節點的分析替代項目，然後使用 Helper 方法 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);
}