CustomRecognizerNode.GetNodesFromTextRange Method (Int32%, Int32%)

Článek
10/19/2012

Returns a collection of descendant ContextNode objects that are relevant to the specified text range in the recognized string.

Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)

Syntax

'Declaration
Public Function GetNodesFromTextRange ( _
    ByRef start As Integer, _
    ByRef length As Integer _
) As ContextNodeCollection
'Usage
Dim instance As CustomRecognizerNode 
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 beginning location 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: System.Windows.Ink.ContextNodeCollection
Returns the collection of descendant ContextNode objects pertaining to the specified text range in the recognized string.

Remarks

The specified text range should be relative to the recognized string of this CustomRecognizerNode, rather than to the recognized string of the entire RootNode.

Examples

The following example uses a TextBox named selectedResultsTextBox. Previously, the Text property was set to the value returned by GetRecognizedString for a CustomRecognizerNode object, customRecognizer. The user has selected some of the text in the TextBox. If the InkRecognitionConfidence level is Strong, then the Strokes that correspond to the user's selection are highlighted in red.

' Find out what's been selected in the text box 
Dim start As Integer = selectedResultsTextBox.SelectionStart
Dim length As Integer = selectedResultsTextBox.SelectionLength

' Return if no text is selected. 
If length = 0 Then 
    Return 
End If 

' Only highlight if strong recognition 
If customRecognizer.InkRecognitionConfidence = _
   InkRecognitionConfidence.Strong Then 

    Dim selectedNodes As ContextNodeCollection = _
        customRecognizer.GetNodesFromTextRange(start, length)

    ' Use the new start and length value to update the 
    ' selection in the TextBox
    selectedResultsTextBox.SelectionStart = start
    selectedResultsTextBox.SelectionLength = length

    ' Color the strokes red if part of the selected words. 
    ' Otherwise, color them black. 
    For Each Stroke As Stroke In customRecognizer.Strokes
        Stroke.DrawingAttributes.Color = Colors.Black
    Next Stroke

    For Each selectedNode As ContextNode In selectedNodes
        For Each Stroke As Stroke In selectedNode.Strokes
            Stroke.DrawingAttributes.Color = Colors.Red
        Next Stroke
    Next selectedNode
End If

// Find out what's been selected in the text box 
int start = selectedResultsTextBox.SelectionStart;
int length = selectedResultsTextBox.SelectionLength;

// Return if no text is selected. 
if (length == 0)
    return;

// Only highlight if strong recognition 
if (customRecognizer.InkRecognitionConfidence == InkRecognitionConfidence.Strong)
{
    ContextNodeCollection selectedNodes =
        customRecognizer.GetNodesFromTextRange(ref start, ref length);

    // Use the new start and length value to update the 
    // selection in the TextBox
    selectedResultsTextBox.SelectionStart = start;
    selectedResultsTextBox.SelectionLength = length;

    // Color the strokes red if part of the selected words. 
    // Otherwise, color them black. 
    foreach (Stroke stroke in customRecognizer.Strokes)
    {
        stroke.DrawingAttributes.Color = Colors.Black;
    }
    foreach (ContextNode selectedNode in selectedNodes)
    {
        foreach (Stroke stroke in selectedNode.Strokes)
        {
            stroke.DrawingAttributes.Color = Colors.Red;
        }
    }
}

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

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

Sdílet prostřednictvím