RootNode-Klasse
Stellt den obersten ContextNode für eine Knotenstruktur dar, die die Ergebnisse der Freihandanalyse beschreibt.
Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)
Syntax
'Declaration
Public NotInheritable Class RootNode _
Inherits ContextNode
'Usage
Dim instance As RootNode
public sealed class RootNode : ContextNode
public ref class RootNode sealed : public ContextNode
public final class RootNode extends ContextNode
public final class RootNode extends ContextNode
Hinweise
Der Zugriff auf den RootNode erfolgt über die InkAnalyzer.RootNode-Eigenschaft.
Ein RootNode-Objekt kann eine beliebige Anzahl von untergeordneten Objekten der folgenden Typen enthalten:
UnclassifiedInkNode-Objekte
WritingRegionNode-Objekte
InkDrawingNode-Objekte
ImageNode-Objekte
AnnotationNode-Objekte
AnalysisHintNode-Objekte
CustomNode-Objekte
Beispiele
Im folgenden Beispiel wird am RootNode eines InkAnalyzer namens theInkAnalyzer damit begonnen, eine TreeView namens theTreeView mit der ContextNode-Struktur aufzufüllen. Wenn ein Knoten in der TreeView ausgewählt ist, werden die Striche rot dargestellt. Die Tag-Eigenschaft wird zur Zuordnung zwischen Strukturknoten und den Kontextknoten verwendet, die sie vertreten.
Private Sub BuildTree()
' Remove the old nodes from the TreeView and add the current results.
Me.theResultsTreeView.Items.Clear()
Dim rootNode As New TreeViewItem()
rootNode.Tag = Me.theInkAnalyzer.RootNode
rootNode.Header = theInkAnalyzer.RootNode.ToString()
Me.theResultsTreeView.Items.Add(rootNode)
WalkTree(Me.theInkAnalyzer.RootNode, rootNode)
End Sub 'BuildTree
Private Shared Sub WalkTree(ByVal parentContextNode As ContextNode, ByVal parentTreeNode As TreeViewItem)
parentTreeNode.IsExpanded = True
For Each theContextSubnode As ContextNode In parentContextNode.SubNodes
Dim newTreeNode As New TreeViewItem()
newTreeNode.Header = theContextSubnode.ToString()
If TypeOf theContextSubnode Is InkWordNode Then
newTreeNode.Header += ": " + CType(theContextSubnode, InkWordNode).GetRecognizedString()
ElseIf TypeOf theContextSubnode Is InkDrawingNode Then
newTreeNode.Header += ": " + CType(theContextSubnode, InkDrawingNode).GetShapeName()
End If
' If the context node is confirmed, add a note to the
' tree view item.
If (theContextSubnode.IsConfirmed(ConfirmationType.NodeTypeAndProperties)) Then
newTreeNode.Header += " Confirmed."
End If
' Add the context node as a tag of the tree view item and
' add the new tree view item to the parent node.
newTreeNode.Tag = theContextSubnode
parentTreeNode.Items.Add(newTreeNode)
WalkTree(theContextSubnode, newTreeNode)
Next theContextSubnode
End Sub 'WalkTree
Sub theResultsTreeView_SelectedItemChanged(ByVal sender As Object, _
ByVal e As RoutedPropertyChangedEventArgs(Of Object))
Dim selectedTreeViewItem As TreeViewItem = e.NewValue '
If selectedTreeViewItem Is Nothing Then
Return
End If
' Get the context node
Dim selectedNode As ContextNode = CType(selectedTreeViewItem.Tag, ContextNode)
MarkNodeAsRed(selectedNode)
timeStampLabel.Content = ""
' Show selected results
If Not (selectedNode Is Nothing) Then
If selectedNode.Type = ContextNodeType.WritingRegion Then
Dim writingRegion As WritingRegionNode = CType(selectedNode, WritingRegionNode)
selectedResultsTextBox.Text = writingRegion.GetRecognizedString()
ElseIf selectedNode.Type = ContextNodeType.Paragraph Then
Dim paragraph As ParagraphNode = CType(selectedNode, ParagraphNode)
selectedResultsTextBox.Text = paragraph.GetRecognizedString()
ElseIf selectedNode.Type = ContextNodeType.Line Then
Dim line As LineNode = CType(selectedNode, LineNode)
selectedResultsTextBox.Text = line.GetRecognizedString()
ElseIf selectedNode.Type = ContextNodeType.InkWord Then
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
ElseIf selectedNode.Type = ContextNodeType.InkDrawing Then
Dim drawingNode As InkDrawingNode = CType(selectedNode, InkDrawingNode)
selectedResultsTextBox.Text = drawingNode.GetShapeName()
ElseIf selectedNode.Type = ContextNodeType.InkBullet Then
Dim bulletNode As InkBulletNode = CType(selectedNode, InkBulletNode)
selectedResultsTextBox.Text = bulletNode.GetRecognizedString()
ElseIf selectedNode.Type = ContextNodeType.CustomRecognizer Then
Dim customRecognizer As CustomRecognizerNode = CType(selectedNode, CustomRecognizerNode)
selectedResultsTextBox.Text = customRecognizer.GetRecognizedString()
ElseIf selectedNode.Type = ContextNodeType.Object Then
Dim selectedObject As ObjectNode = CType(selectedNode, ObjectNode)
selectedResultsTextBox.Text = selectedObject.GetRecognizedString()
Else
selectedResultsTextBox.Text = ""
End If
If TypeOf selectedNode Is InkWordNode Then
Dim inkWord As InkWordNode = CType(selectedNode, InkWordNode)
' Show the time stamp
If inkWord.ContainsPropertyData(Me.timeStampGuid) Then
Dim timeStamp As DateTime = CType(inkWord.GetPropertyData(Me.timeStampGuid), DateTime)
timeStampLabel.Content = 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
End If
End If
PopulateLinksList(selectedNode)
Me.currentNode = selectedNode
End Sub
Private Sub PopulateLinksList(ByVal selectedNode As ContextNode)
linksListBox.Items.Clear()
If selectedNode Is Nothing Then
Return
End If
Dim link As ContextLink
For Each link In selectedNode.Links
linksListBox.Items.Add(link.SourceNode.ToString() + ", " & _
link.DestinationNode.ToString() & ": " & _
link.LinkDirection.ToString())
Next
End Sub
Sub MarkNodeAsRed(ByVal selectedNode As ContextNode)
' Set all node strokes to black, but this one to red
Dim stroke As Stroke
For Each stroke In Me.theInkCanvas.Strokes
If Not (selectedNode Is Nothing) AndAlso selectedNode.Strokes.Contains(stroke) Then
stroke.DrawingAttributes.Color = Colors.Red
Else
stroke.DrawingAttributes.Color = Me.theInkCanvas.DefaultDrawingAttributes.Color
End If
Next stroke
End Sub 'theResultsTreeView_SelectedItemChanged
private void BuildTree()
{
// Remove the old nodes from the TreeView and add the current results.
this.theResultsTreeView.Items.Clear();
TreeViewItem rootNode = new TreeViewItem();
rootNode.Tag = this.theInkAnalyzer.RootNode;
rootNode.Header = theInkAnalyzer.RootNode.ToString();
this.theResultsTreeView.Items.Add(rootNode);
WalkTree(this.theInkAnalyzer.RootNode, rootNode);
}
private static void WalkTree(ContextNode parentContextNode, TreeViewItem parentTreeNode)
{
// Expand the current TreeViewItem.
parentTreeNode.IsExpanded = true;
foreach (ContextNode theContextSubnode
in parentContextNode.SubNodes)
{
TreeViewItem newTreeNode = new TreeViewItem();
newTreeNode.Header = theContextSubnode.ToString();
if (theContextSubnode is InkWordNode)
{
newTreeNode.Header += ": " +
((InkWordNode)theContextSubnode).GetRecognizedString();
}
else if (theContextSubnode is InkDrawingNode)
{
newTreeNode.Header += ": " +
((InkDrawingNode)theContextSubnode).GetShapeName();
}
// If the context node is confirmed, add a note to the
// tree view item.
if (theContextSubnode.IsConfirmed(ConfirmationType.NodeTypeAndProperties))
{
newTreeNode.Header += " Confirmed.";
}
// Add the context node as a tag of the tree view item and
// add the new tree view item to the parent node.
newTreeNode.Tag = theContextSubnode;
parentTreeNode.Items.Add(newTreeNode);
WalkTree(theContextSubnode, newTreeNode);
}
}
void theResultsTreeView_SelectedItemChanged(object sender, RoutedPropertyChangedEventArgs<object> e)
{
TreeViewItem selectedTreeViewItem = e.NewValue as TreeViewItem;
if (selectedTreeViewItem == null)
{
return;
}
// Get the context node
ContextNode selectedNode = (ContextNode)selectedTreeViewItem.Tag;
MarkNodeAsRed(selectedNode);
timeStampLabel.Content = "";
// Show selected results
if (selectedNode != null)
{
if (selectedNode.Type == ContextNodeType.WritingRegion)
{
WritingRegionNode writingRegion = (WritingRegionNode)selectedNode;
selectedResultsTextBox.Text = writingRegion.GetRecognizedString();
}
else if (selectedNode.Type == ContextNodeType.Paragraph)
{
ParagraphNode paragraph = (ParagraphNode)selectedNode;
selectedResultsTextBox.Text = paragraph.GetRecognizedString();
}
else if (selectedNode.Type == ContextNodeType.Line)
{
LineNode line = (LineNode)selectedNode;
selectedResultsTextBox.Text = line.GetRecognizedString();
}
else if (selectedNode.Type == 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;
int length;
parentLine.GetTextRangeFromNodes(subNodes, out start, out length);
if (start >= 0 && length > 0)
{
selectedResultsTextBox.Select(start, length);
}
}
}
else if (selectedNode.Type == ContextNodeType.InkDrawing)
{
InkDrawingNode drawingNode = (InkDrawingNode)selectedNode;
selectedResultsTextBox.Text = drawingNode.GetShapeName();
}
else if (selectedNode.Type == ContextNodeType.InkBullet)
{
InkBulletNode bulletNode = (InkBulletNode)selectedNode;
selectedResultsTextBox.Text = bulletNode.GetRecognizedString();
}
else if (selectedNode.Type == ContextNodeType.CustomRecognizer)
{
CustomRecognizerNode customRecognizer = (CustomRecognizerNode)selectedNode;
selectedResultsTextBox.Text = customRecognizer.GetRecognizedString();
}
else if (selectedNode.Type == 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.Content = 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");
}
}
PopulateLinksList(selectedNode);
this.currentNode = selectedNode;
}
private void PopulateLinksList(ContextNode selectedNode)
{
linksListBox.Items.Clear();
if (selectedNode == null)
{
return;
}
foreach (ContextLink link in selectedNode.Links)
{
linksListBox.Items.Add(link.SourceNode.ToString() + ", " +
link.DestinationNode.ToString() + ": " +
link.LinkDirection.ToString());
}
}
private void MarkNodeAsRed(ContextNode selectedNode)
{
// Set all node strokes to black, but this one to red
foreach (Stroke stroke in this.theInkCanvas.Strokes)
{
if (selectedNode != null &&
selectedNode.Strokes.Contains(stroke))
stroke.DrawingAttributes.Color = Colors.Red;
else
stroke.DrawingAttributes.Color =
this.theInkCanvas.DefaultDrawingAttributes.Color;
}
}
Vererbungshierarchie
System.Object
System.Windows.Ink.ContextNode
System.Windows.Ink.RootNode
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows Vista
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0