ContextNode 類別

表示在筆墨分析中所建立物件之樹狀目錄的節點。

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

語法

'宣告
Public Class ContextNode
'用途
Dim instance As ContextNode

public class ContextNode

public ref class ContextNode

public class ContextNode

public class ContextNode

備註

在 InkAnalyzer 執行筆墨分析之後，它會以 ContextNode 物件的樹狀目錄表示結果。這些節點從最上層的 RootNode 開始，越往樹狀目錄的下層表示越小的筆劃集合。這些節點可以是文字群組 (例如段落或行)、已分析的筆墨 (例如字或繪圖) 或其他各種型別 (如需完整的清單，請參閱 ContextNodeType 類別)。

其他如 AnalysisHintNode、TextWordNode、ImageNode 等節點可以由您加入至 InkAnalyzer。

範例

這個範例會使用 InkAnalyzer (變數名稱為 theInkAnalyzer)，並且使用它的 ContextNode 樹狀目錄填入 System.Windows.Forms.TreeView (英文) (變數名稱為 theTreeView)。已選取樹狀檢視中的節點時，那些筆劃會設定為以紅色顯示。Tag (英文) 屬性是用來對應樹狀目錄節點及其所表示的內容節點。

Private Sub BuildTree()
    Me.theTreeView.Nodes.Clear()
    Dim rootNode As New TreeNode(Me.theInkAnalyzer.RootNode.ToString())
    Me.theTreeView.Nodes.Add(rootNode)
    rootNode.Tag = Me.theInkAnalyzer.RootNode

    WalkTree(Me.theInkAnalyzer.RootNode, rootNode)

End Sub 'BuildTree


Private Sub WalkTree(ByVal parentContextNode As Microsoft.Ink.ContextNode, _
                     ByVal parentTreeNode As TreeNode)

    Dim cNode As ContextNode
    For Each cNode In parentContextNode.SubNodes
        Dim newTNode As New TreeNode(cNode.ToString())
        If TypeOf cNode Is Microsoft.Ink.InkWordNode Then
            newTNode.Text = newTNode.Text + _
                ": " + CType(cNode, InkWordNode).GetRecognizedString()
        ElseIf TypeOf cNode Is Microsoft.Ink.InkDrawingNode Then
            Dim shapeName As String = CType(cNode, InkDrawingNode).GetShapeName()
            If shapeName <> "" Then
                newTNode.Text = newTNode.Text + ": " + shapeName
            End If
        End If
        WalkTree(cNode, newTNode)
        parentTreeNode.Nodes.Add(newTNode)

        ' Add the context node as a tag of the tree node
        newTNode.Tag = cNode
    Next cNode

End Sub 'WalkTree

Private Sub theTreeView_AfterSelect(ByVal sender As Object, _
            ByVal e As System.Windows.Forms.TreeViewEventArgs) _
            Handles theTreeView.AfterSelect
    ' Get the context node
    Dim selectedNode As ContextNode = CType(e.Node.Tag, ContextNode)

    MarkNodeAsRed(selectedNode)

    timeStampLabel.Text = ""

    ' Show selected results
    If Not (selectedNode Is Nothing) Then
        Select Case selectedNode.Type
            Case Microsoft.Ink.ContextNodeType.WritingRegion
                Dim writingRegion As WritingRegionNode = _
                    CType(selectedNode, WritingRegionNode)
                selectedResultsTextBox.Text = writingRegion.GetRecognizedString()
            Case Microsoft.Ink.ContextNodeType.Paragraph
                Dim paragraph As ParagraphNode = _
                    CType(selectedNode, ParagraphNode)
                selectedResultsTextBox.Text = paragraph.GetRecognizedString()
            Case Microsoft.Ink.ContextNodeType.Line
                Dim line As LineNode = _
                    CType(selectedNode, LineNode)
                selectedResultsTextBox.Text = line.GetRecognizedString()
            Case Microsoft.Ink.ContextNodeType.InkWord
                Dim inkWord As InkWordNode = _
                    CType(selectedNode, InkWordNode)
                Dim parentNode As ContextNode = inkWord.ParentNode
                If TypeOf parentNode Is LineNode Then
                    Dim parentLine As LineNode = CType(parentNode, LineNode)
                    ' Put parent line's recognized string into the text box
                    selectedResultsTextBox.Text = parentLine.GetRecognizedString()

                    ' Select the text that corresponds to the ink word
                    Dim subNodes As New ContextNodeCollection(theInkAnalyzer)
                    subNodes.Add(inkWord)
                    Dim start As Integer
                    Dim length As Integer
                    parentLine.GetTextRangeFromNodes(subNodes, start, length)
                    If start >= 0 AndAlso length > 0 Then
                        selectedResultsTextBox.Select(start, length)
                    End If
                End If
                ' Show the time stamp
                If inkWord.ContainsPropertyData(Me.timeStampGuid) Then
                    Dim timeStamp As DateTime = _
                        CType(inkWord.GetPropertyData(Me.timeStampGuid), DateTime)
                    timeStampLabel.Text = timeStamp.ToShortTimeString()
                End If

                ' Snippet to demonstrate GetPropertyDataIds
                Dim propertyDataIds() As Guid = inkWord.GetPropertyDataIds()

                ' Snippets to demonstrate loading and saving
                Dim data As Byte() = inkWord.SavePropertiesData()
                If (Not inkWord.LoadPropertiesData(data)) Then
                    MessageBox.Show("Cannot load property data")
                End If
            Case Microsoft.Ink.ContextNodeType.InkDrawing
                Dim drawingNode As InkDrawingNode = CType(selectedNode, InkDrawingNode)
                selectedResultsTextBox.Text = drawingNode.GetShapeName()
            Case Microsoft.Ink.ContextNodeType.InkBullet
                Dim bulletNode As InkBulletNode = CType(selectedNode, InkBulletNode)
                selectedResultsTextBox.Text = bulletNode.GetRecognizedString()
            Case Microsoft.Ink.ContextNodeType.Object
                Dim selectedObject As ObjectNode = selectedNode
                selectedResultsTextBox.Text = selectedObject.GetRecognizedString()
            Case Microsoft.Ink.ContextNodeType.CustomRecognizer
                Dim customRecognizer As CustomRecognizerNode = selectedNode
                selectedResultsTextBox.Text = customRecognizer.GetRecognizedString()
            Case Else
                selectedResultsTextBox.Text = String.Empty
        End Select
    End If
    Me.currentNode = selectedNode

End Sub 'theTreeView_AfterSelect


Private Sub MarkNodeAsRed(ByVal selectedNode As ContextNode)
    ' Set all node strokes to black, but this one to red
    Dim inkStroke As Stroke
    For Each inkStroke In Me.theInkCollector.Ink.Strokes
        If Not (selectedNode Is Nothing) AndAlso _
           selectedNode.Strokes.Contains(inkStroke) Then
            inkStroke.DrawingAttributes = New DrawingAttributes(Color.Red)
        Else
            inkStroke.DrawingAttributes = Me.theInkCollector.DefaultDrawingAttributes
        End If
    Next inkStroke
    theNotesPanel.Refresh()

End Sub 'MarkNodeAsRed

        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(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, 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);
                        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 = String.Empty;
                }

                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
    Microsoft.Ink.AnalysisHintNode
    Microsoft.Ink.CustomRecognizerNode
    Microsoft.Ink.ImageNode
    Microsoft.Ink.InkBulletNode
    Microsoft.Ink.InkDrawingNode
    Microsoft.Ink.InkWordNode
    Microsoft.Ink.LineNode
    Microsoft.Ink.ObjectNode
    Microsoft.Ink.ParagraphNode
    Microsoft.Ink.RootNode
    Microsoft.Ink.TextWordNode
    Microsoft.Ink.UnclassifiedInkNode
    Microsoft.Ink.WritingRegionNode

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。

平台

Windows Vista

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

版本資訊

.NET Framework

支援版本：3.0

請參閱

參考

ContextNode 成員

Microsoft.Ink 命名空間

InkAnalyzer.Analyze

InkAnalyzer.RootNode

Microsoft.Ink.ContextNodeType