Context Node Types

These constants define values that specify the type of IContextNode objects.

Constant/value Description
GUID_CNT_ANALYSISHINT
(AnalysisHint)
Represents a node that contains additional context information for a region that the IInkAnalyzer uses to improve its analysis.
GUID_CNT_CUSTOMRECOGNIZER
(CustomRecognizer)
Represents a node used for a single recognition operation.
All strokes and nodes that are within a custom recognizer node are recognized by an independent recognition operation and are not analyzed by the IInkAnalyzer.
A custom recognizer node must be the direct child of ink analyzer's root node.
A custom recognizer node can contain the following types of child elements:
  • Any number of UnclassifiedInk nodes.
  • Any number of Object nodes.
  • Any number of Line nodes.
  • Any number of InkWord nodes.
  • Any number of nodes with an unknown Guid value.
GUID_CNT_IMAGE
(Image)
Represents a node for a two-dimensional region where any non-ink images can exist in the document.
The IInkAnalyzer does not produce image nodes. Use IContextNode::CreateSubNode to add an image node to the context node tree. The IInkAnalyzer then uses the regions defined by the image node to determine if any ink annotates the non-ink image.
An image node cannot have any child elements.
GUID_CNT_INKBULLET
(InkBullet)
The InkBullet ContextNodeType represents a collection of strokes that make up a bullet in a bulleted list.
A ContextNode of type InkBullet cannot have any children. It can only be a child of a Paragraph ContextNode. Only one InkBullet can appear in a single Paragraph ContextNode.
GUID_CNT_INKDRAWING
(InkDrawing)
Represents a node for a collection of strokes that constitutes a drawing.
Drawings are strokes that are determined to be shapes or abstract sketches. They are generally any strokes that are not classified as writing strokes.
An ink drawing node cannot have any child elements.
GUID_CNT_INKWORD
(InkWord)
Represents a node for a collection of strokes that constitutes a logical grouping to form a recognizable word.
An ink word node cannot contain any child elements.
GUID_CNT_LINE
(Line)
Represents a node for a line of words.
A line node can contain the following types of child elements:
  • Any number of ink word nodes.
  • Any number of text word nodes.
  • Any number of nodes with an unknown GUID value.
GUID_CNT_OBJECT
(Object)
Represents a node for an object that is returned from an "object" custom recognizer.
An object node cannot contain any child elements.
Only custom recognizer nodes can contain object nodes.
GUID_CNT_PARAGRAPH
(Paragraph)
Represents a node for a collection of nodes that constitutes a logical grouping of lines.
The exact definition of a paragraph is determined by the analyzing engines. In general, a paragraph contains groups of lines that would reflow together if the box that contains the lines were resized.
A paragraph node can contain the following types of child elements:
  • Any number of ink bullet nodes.
  • Any number of line nodes.
  • Any number of nodes with an unknown GUID value.
GUID_CNT_ROOT
(Root)
Represents a node for the top node of a tree of nodes that describe the results of ink analysis.
Root nodes are generally obtained from the IInkAnalyzer::GetRootNode Method method.
A root node can contain the following types of child elements:
  • Any number of analysis hint nodes.
  • Any number of custom recognizer nodes.
  • Any number of image nodes.
  • Any number of ink drawing nodes.
  • Any number of writing region nodes.
  • Any number of unclassified ink nodes.
  • Any number of nodes with an unknown GUID value.
GUID_CNT_TEXTWORD
(TextWord)
Represents a node for the two-dimensional region where any non-ink text can exist in the document.
The IInkAnalyzer does not produce text word nodes. Use IContextNode::CreateSubNode to add a text word node to the context node tree. The IInkAnalyzer then uses the regions defined by the text word node to determine if any ink annotates the non-ink text.
Future recognizers may use the region defined by a text word node to determine if any ink annotates the non-ink word.
A text word node cannot have any child elements
GUID_CNT_UNCLASSIFIEDINKNODE
(UnclassifiedInk)
Represents a node for any strokes that have not yet been classified or recognized.
An unclassified ink node cannot have any child elements.

Remarks

For more information about the different context node types, see Ink Analysis Overview.

Requirements

Requirement Value
Minimum supported client
Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server
None supported
Header
Iaguid.h

See also

IContextNode::CreatePartiallyPopulatedSubNode

IContextNode::CreateSubNode

IContextNode::GetType

IInkAnalyzer::CreateAnalysisHint Method

IInkAnalyzer::CreateCustomRecognizer Method

IInkAnalyzer::FindNodesOfType Method

IInkAnalyzer::FindNodesOfTypeForStrokes Method

IInkAnalyzer::FindNodesOfTypeInSubTree Method

Ink Analysis Reference