共用方式為

CustomRecognizerNode.GetNodesFromTextRange 方法 (Int32%, Int32%, ContextNodeCollection)

  • 發行項

從子代節點集合中，傳回子代 ContextNode 物件集合，這些物件都與已辨識字串中指定的文字範圍相關聯。

命名空間：  Microsoft.Ink
組件：  Microsoft.Ink.Analysis (在 Microsoft.Ink.Analysis.dll 中)

語法

'宣告
Public Function GetNodesFromTextRange ( _
    ByRef start As Integer, _
    ByRef length As Integer, _
    subTree As ContextNodeCollection _
) As ContextNodeCollection
'用途
Dim instance As CustomRecognizerNode
Dim start As Integer
Dim length As Integer
Dim subTree As ContextNodeCollection
Dim returnValue As ContextNodeCollection

returnValue = instance.GetNodesFromTextRange(start, _
    length, subTree)

public ContextNodeCollection GetNodesFromTextRange(
    ref int start,
    ref int length,
    ContextNodeCollection subTree
)

public:
ContextNodeCollection^ GetNodesFromTextRange(
    int% start, 
    int% length, 
    ContextNodeCollection^ subTree
)

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

public function GetNodesFromTextRange(
    start : int, 
    length : int, 
    subTree : ContextNodeCollection
) : ContextNodeCollection

參數

  • start
    型別：System.Int32%
    已辨識字串中，subTree 部分的文字範圍起點。
  • length
    型別：System.Int32%
    已辨識字串中文字範圍的長度。

傳回值

型別：Microsoft.Ink.ContextNodeCollection
子代節點集合中的子代 ContextNode 物件集合，這些物件都與已辨識字串中指定的文字範圍相關聯。

備註

指定的文字範圍應該相對於這個 CustomRecognizerNode 之已辨識字串的 subTree 部分，而不是整個 CustomRecognizerNode 或整個 RootNode 的已辨識字串。

start 和 length 參數都是參考，因為它們的值可以變更。例如，GetRecognizedString 的傳回值為 "I am late"，而且您傳入 start = 6 和 length = 1 兩個值，表示對應於 "a" 這個字母。然後 ContextNodeCollection 可能只有一個 ContextNode，這是對應於 "late" 一字的 InkWordNode。在此情況下，start 的值會變更為 5，而且 length 的值會變更為 4，表示對應於 "late" 這一整個字。

備註：start 參數是相對於 subTree 參數中的節點。在先前的範例中，如果您傳入的 subTree 參數有 "am" 和 "late" 節點但沒有 "I" 節點，則 start 參數值 3 和長度值 4 就表示 "late" 一字的文字範圍。

範例

下列範例會採用 ContextNodeCollection 物件 lastLineCollection，其中包含對應於 CustomRecognizerNode (customRecognizer) 中最後一行的一個 ContextNode 物件。接著會將所有 Strokes 標示為黑色，但會將對應於最後一行選定文字的那些筆劃變更為紅色。

' Get the nodes that correspond to this start and length
Dim selectedNodes As ContextNodeCollection = _
    customRecognizer.GetNodesFromTextRange(start, length, lastLineCollection)

' Set all strokes to black
Dim theStroke As Stroke
For Each theStroke In customRecognizer.Strokes
    theStroke.DrawingAttributes = New DrawingAttributes(Color.Black)
Next theStroke

' Set strokes in the collection to red
Dim node As ContextNode
For Each node In selectedNodes
    For Each theStroke In node.Strokes
        theStroke.DrawingAttributes = New DrawingAttributes(Color.Red)
    Next theStroke
Next node

                // Get the nodes that correspond to this start and length
                ContextNodeCollection selectedNodes =
                    customRecognizer.GetNodesFromTextRange(ref start, ref length, lastLineCollection);

                // Set all strokes to black
                foreach (Stroke stroke in customRecognizer.Strokes)
                    stroke.DrawingAttributes = new DrawingAttributes(Color.Black);

                // Set strokes in the collection to red
                foreach (ContextNode node in selectedNodes)
                {
                    foreach (Stroke stroke in node.Strokes)
                    {
                        stroke.DrawingAttributes = new DrawingAttributes(Color.Red);
                    }
                }

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱 .NET Framework 系統需求。

版本資訊

.NET Framework

支援版本：3.0

請參閱

參考

CustomRecognizerNode 類別

CustomRecognizerNode 成員

GetNodesFromTextRange 多載

Microsoft.Ink 命名空間