Export (0) Print
Expand All

ContextNode Class

Represents a node in a tree of objects that are created as part of ink analysis.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in microsoft.ink.analysis.dll)

public class ContextNode
public class ContextNode
public class ContextNode
Not applicable.

After an InkAnalyzer performs an analysis on ink, it presents the results as a tree of ContextNode objects. These nodes start at the top with a RootNode, and then represent smaller and smaller collections of strokes as they progress down the tree. These nodes can be groups of words (such as paragraphs or lines), analyzed ink (such as words or drawings), or a variety of other types. (See the ContextNodeType class for a full list.)

Other nodes, such as AnalysisHintNode, TextWordNode, ImageNode could be added to InkAnalyzer by you.

This example takes an InkAnalyzer, theInkAnalyzer, and uses its ContextNode tree to fill a System.Windows.Forms.TreeViewSystem.Windows.Forms.TreeView, theTreeView. When a node in the tree view is selected, those strokes are set to appear in red. The Tag property is used to map between tree nodes and the context nodes that they represent.

private void BuildTree()
{
    this.theTreeView.Nodes.Clear();
    TreeNode rootNode =
        new TreeNode(this.theInkAnalyzer.RootNode.ToString());
    this.theTreeView.Nodes.Add(rootNode);
    rootNode.Tag = this.theInkAnalyzer.RootNode;

    WalkTree(this.theInkAnalyzer.RootNode, rootNode);
}

private void WalkTree(
    Microsoft.Ink.ContextNode parentContextNode, TreeNode parentTreeNode)
{
    foreach (ContextNode cNode in parentContextNode.SubNodes)
    {
        TreeNode newTNode = new TreeNode(cNode.ToString());
        if (cNode is Microsoft.Ink.InkWordNode)
        {
            newTNode.Text +=
                ": " + ((InkWordNode)cNode).GetRecognizedString();
        }
        else if (cNode is Microsoft.Ink.InkDrawingNode)
        {
            String shapeName = ((InkDrawingNode)cNode).GetShapeName();
            if (shapeName != "")
                newTNode.Text += ": " + shapeName;
        }
        WalkTree(cNode, newTNode);
        parentTreeNode.Nodes.Add(newTNode);

        // Add the context node as a tag of the tree node
        newTNode.Tag = cNode;
    }
}

private void theTreeView_AfterSelect(object sender, 
    System.Windows.Forms.TreeViewEventArgs e)
{
    // Get the context node
    ContextNode selectedNode = (ContextNode)e.Node.Tag;

    MarkNodeAsRed(selectedNode);

    timeStampLabel.Text = "";

    // Show selected results
    if (selectedNode != null)
    {
        if (selectedNode.Type == Microsoft.Ink.ContextNodeType.WritingRegion)
        {
            WritingRegionNode writingRegion = (WritingRegionNode)selectedNode;
            selectedResultsTextBox.Text = writingRegion.GetRecognizedString();
        }
        else if (selectedNode.Type == Microsoft.Ink.ContextNodeType.Paragraph)
        {
            ParagraphNode paragraph = (ParagraphNode)selectedNode;
            selectedResultsTextBox.Text = paragraph.GetRecognizedString();
        }
        else if (selectedNode.Type == Microsoft.Ink.ContextNodeType.Line)
        {
            LineNode line = (LineNode)selectedNode;
            selectedResultsTextBox.Text = line.GetRecognizedString();
        }
        else if (selectedNode.Type == Microsoft.Ink.ContextNodeType.InkWord)
        {
            InkWordNode inkWord = (InkWordNode)selectedNode;
            ContextNode parentNode = inkWord.ParentNode;
            if (parentNode is LineNode)
            {
                LineNode parentLine = (LineNode)parentNode;
                // Put parent line's recognized string into the text box
                selectedResultsTextBox.Text = parentLine.GetRecognizedString();

                // Select the text that corresponds to the ink word
                ContextNodeCollection subNodes = new ContextNodeCollection(theInkAnalyzer);
                subNodes.Add(inkWord);
                int start = 0;
                int length = 0;
                parentLine.GetTextRangeFromNodes(subNodes, out start, out length);
                System.Diagnostics.Debug.WriteLine(inkWord.GetRecognizedString()
                    + " start: " + start + " length: " + length);
                if (start >= 0 && length > 0)
                {
                    selectedResultsTextBox.Select(start, length);
                }
            }
        }
        else if (selectedNode.Type == Microsoft.Ink.ContextNodeType.InkDrawing)
        {
            InkDrawingNode drawingNode = (InkDrawingNode)selectedNode;
            selectedResultsTextBox.Text = drawingNode.GetShapeName();
        }
        else if (selectedNode.Type == Microsoft.Ink.ContextNodeType.InkBullet)
        {
            InkBulletNode bulletNode = (InkBulletNode)selectedNode;
            selectedResultsTextBox.Text = bulletNode.GetRecognizedString();
        }
        else if (selectedNode.Type == Microsoft.Ink.ContextNodeType.CustomRecognizer)
        {
            CustomRecognizerNode customRecognizer = (CustomRecognizerNode)selectedNode;
            selectedResultsTextBox.Text = customRecognizer.GetRecognizedString();
        }
        else if (selectedNode.Type == Microsoft.Ink.ContextNodeType.Object)
        {
            ObjectNode selectedObject = (ObjectNode)selectedNode;
            selectedResultsTextBox.Text = selectedObject.GetRecognizedString();
        }
        else
        {
            selectedResultsTextBox.Text = "";
        }

        if (selectedNode is InkWordNode)
        {
            InkWordNode inkWord = (InkWordNode)selectedNode;

            // Show the time stamp
            if (inkWord.ContainsPropertyData(this.timeStampGuid))
            {
                DateTime timeStamp =
                    (DateTime)inkWord.GetPropertyData(this.timeStampGuid);
                timeStampLabel.Text = timeStamp.ToShortTimeString();
            }

            // Snippet to demonstrate GetPropertyDataIds
            Guid[] propertyDataIds = inkWord.GetPropertyDataIds();
            // Snippets to demonstrate loading and saving
            byte[] data = inkWord.SavePropertiesData();
            if (!inkWord.LoadPropertiesData(data))
                MessageBox.Show("Cannot load property data");
        }

    }
    this.currentNode = selectedNode;
}

private void MarkNodeAsRed(ContextNode selectedNode)
{
    // Set all node strokes to black, but this one to red
    foreach (Stroke stroke in this.theInkCollector.Ink.Strokes)
    {
        if (selectedNode != null && 
            selectedNode.Strokes.Contains(stroke))
            stroke.DrawingAttributes = new DrawingAttributes(Color.Red);
        else
            stroke.DrawingAttributes = this.theInkCollector.DefaultDrawingAttributes;
    }

    theNotesPanel.Refresh();
}

System.Object
  Microsoft.Ink.ContextNode
     Derived Classes

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0

Community Additions

ADD
Show:
© 2014 Microsoft