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

返回后代 ContextNode 对象的集合,这些对象与后代节点集合内已识别字符串中的指定文本范围相关。

命名空间:  System.Windows.Ink
程序集:  IAWinFX(在 IAWinFX.dll 中)

语法

声明
Public Function GetNodesFromTextRange ( _
    ByRef start As Integer, _
    ByRef length As Integer, _
    subTree As ContextNodeCollection _
) As ContextNodeCollection
用法
Dim instance As LineNode
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

参数

返回值

类型:System.Windows.Ink.ContextNodeCollection
后代 ContextNode 对象的集合,这些对象与后代节点集合内已识别字符串中的指定文本范围相关。

备注

指定的文本范围应相对于作为当前 LineNode 的已识别字符串一部分的 subTree,而不相对于整个 LineNode 或整个 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 对象 lastWordCollection,该对象包含一个对应于 LineNode (line) 中最后一个单词的 ContextNode。然后,将除对应于最后一行中所选文本以外的所有 Strokes 标记为黑色,最后一行中的选定文本对应的笔画更改为红色。

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

' Set all strokes to black
For Each Stroke As Stroke In line.Strokes
    Stroke.DrawingAttributes.Color = Colors.Black
Next Stroke
' Set strokes in the collection to red
For Each node As ContextNode In selectedNodes
    For Each Stroke As Stroke In node.Strokes
        Stroke.DrawingAttributes.Color = Colors.Red
    Next Stroke
Next node
// Get the nodes that correspond to this start and length
ContextNodeCollection selectedNodes =
    line.GetNodesFromTextRange(ref start, ref length, lastWordCollection);

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

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

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

版本信息

.NET Framework

受以下版本支持:3.0

另请参见

参考

LineNode 类

LineNode 成员

GetNodesFromTextRange 重载

System.Windows.Ink 命名空间