Classe ContextNode
Aggiornamento: novembre 2007
Rappresenta un nodo in una struttura ad albero di oggetti creati come parte dell'analisi dell'input penna.
Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)
Sintassi
'Dichiarazione
Public Class ContextNode
'Utilizzo
Dim instance As ContextNode
public class ContextNode
public ref class ContextNode
public class ContextNode
public class ContextNode
Note
Dopo l'esecuzione di un'analisi dell'input penna, l'oggetto InkAnalyzer presenta i risultati sotto forma di una struttura ad albero di oggetti ContextNode. Questi nodi iniziano dall'alto con un oggetto RootNode e rappresentano insiemi di tratti sempre più piccoli man mano che si scende nella struttura ad albero. Questi nodi possono essere gruppi di parole (ad esempio paragrafi o righe), input penna analizzati (ad esempio parole o disegni) o diversi altri tipi. Per l'elenco completo, vedere la classe ContextNodeType.
Altri nodi, ad esempio AnalysisHintNode, TextWordNodeImageNode potrebbero essere aggiunti all'oggetto InkAnalyzer dall'utente.
Esempi
Nell'esempio riportato di seguito viene accettato un oggetto InkAnalyzer, theInkAnalyzer e viene utilizzata la relativa struttura ad albero ContextNode per riempire un oggetto System.Windows.Forms.TreeView, theTreeView. Quando viene selezionato un nodo nella visualizzazione struttura, i tratti vengono impostati per essere visualizzati in rosso. La proprietà Tag viene utilizzata per eseguire il mapping tra nodi di struttura e i nodi di contesto che rappresentano.
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();
}
Gerarchia di ereditarietà
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
Codice thread safe
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Piattaforme
Windows Vista
.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Informazioni sulla versione
.NET Framework
Supportato in: 3.0