ConfirmationType enumeration

Specifies the type of confirmation that can occur on an IContextNode object.

Syntax

typedef enum ConfirmationType { 
  ConfirmationType_None                   = 0,
  ConfirmationType_NodeTypeAndProperties  = 1,
  ConfirmationType_TopBoundary            = 4
} ConfirmationType;

Constants

ConfirmationType_None

No confirmation is applied. The IInkAnalyzer is free to change a context node or any of its descendants as needed.

ConfirmationType_NodeTypeAndProperties

The IInkAnalyzer cannot change the type or any properties of the specified context node.

ConfirmationType_TopBoundary

The IInkAnalyzer will not perform operations, including adding ink or merging with other ContextNodes, that cause the TopBoundary to move beyond the current top boundary. For example:

• An application analyzes a set of Ink, and a ParagraphNode is identified.
• The application confirms the TopBoundary of this paragraph.
• The user of the application writes new ink above the current paragraph. When analyze is called again, the new ink will not be incorporated into the Confirmed paragraph node.
• Since only the top boundary is confirmed, the ContextNode can continue to grow in other directions. Deleting strokes can cause the top boundary to move down. Translating the ContextNode can cause the location to change, but will not allow additional ink to be merged in the new location.

This ConfirmationType is only applicable to paragraph nodes.

Remarks

You can use the NodeTypeAndProperties value only for ink word and ink drawing nodes (see IContextNode::GetType). Otherwise, an E_INVALIDARG is returned from IContextNode::Confirm.

Requirements

Requirement	Value
Minimum supported client	Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server	None supported
Header	IACom.h (also requires IACom_i.c)

See also

IContextNode::Confirm

IContextNode::IsConfirmed