ParagraphNode.GetNodesFromTextRange Method (Int32%, Int32%)
Returns a collection of descendant ContextNode objects that are relevant to the specified text range in the recognized string.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)
Syntax
'Declaration
Public Function GetNodesFromTextRange ( _
ByRef start As Integer, _
ByRef length As Integer _
) As ContextNodeCollection
'Usage
Dim instance As ParagraphNode
Dim start As Integer
Dim length As Integer
Dim returnValue As ContextNodeCollection
returnValue = instance.GetNodesFromTextRange(start, _
length)
public ContextNodeCollection GetNodesFromTextRange(
ref int start,
ref int length
)
public:
ContextNodeCollection^ GetNodesFromTextRange(
int% start,
int% length
)
public function GetNodesFromTextRange(
start : int,
length : int
) : ContextNodeCollection
Parameters
start
Type: System.Int32%The start of the text range in the recognized string.
length
Type: System.Int32%The length of the text range in the recognized string.
Return Value
Type: Microsoft.Ink.ContextNodeCollection
Returns the collection of descendant ContextNode objects that are relevant to the specified text range in the recognized string.
Remarks
The specified text range should be relative to the recognized string of this ParagraphNode, rather than to the recognized string of the entire RootNode.
Examples
The following example takes a TextBox, selectedResultsTextBox, whose Text property has been set previously to the value returned by GetRecognizedString for a ParagraphNode, paragraph. The user has selected some text in the TextBox. The example code takes the selection and marks the Strokes that corresponds to that selection.
' Find out what's been selected in the text box
Dim selStart As Integer = selectedResultsTextBox.SelectionStart
Dim selLength As Integer = selectedResultsTextBox.SelectionLength
' Return if no text is selected.
If selLength = 0 Then
Return
End If
' Get the nodes that correspond to that range
Dim selectedSubNodes As ContextNodeCollection = paragraph.GetNodesFromTextRange(selStart, selLength)
' Use the new start and length value to update the
' selection in the TextBox
selectedResultsTextBox.SelectionStart = selStart
selectedResultsTextBox.SelectionLength = selLength
' First, set all strokes to black
Dim inkStroke As Stroke
For Each inkStroke In paragraph.Strokes
inkStroke.DrawingAttributes = New DrawingAttributes(Color.Black)
Next inkStroke
' Next, set all selected sub nodes to red
Dim node As ContextNode
For Each node In selectedSubNodes
For Each inkStroke In node.Strokes
inkStroke.DrawingAttributes = New DrawingAttributes(Color.Red)
Next inkStroke
Next node
// Find out what's been selected in the text box
int selStart = selectedResultsTextBox.SelectionStart;
int selLength = selectedResultsTextBox.SelectionLength;
// Return if no text is selected.
if (selLength == 0)
return;
// Get the nodes that correspond to that range
ContextNodeCollection selectedSubNodes =
paragraph.GetNodesFromTextRange(ref selStart, ref selLength);
// Use the new start and length value to update the
// selection in the TextBox
selectedResultsTextBox.SelectionStart = selStart;
selectedResultsTextBox.SelectionLength = selLength;
// First, set all strokes to black
foreach (Stroke stroke in paragraph.Strokes)
stroke.DrawingAttributes =
new DrawingAttributes(Color.Black);
// Next, set all selected sub nodes to red
foreach (ContextNode node in selectedSubNodes)
{
foreach (Stroke stroke in node.Strokes)
{
stroke.DrawingAttributes =
new DrawingAttributes(Color.Red);
}
}
Platforms
Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information
.NET Framework
Supported in: 3.0