IContextNode::SetPartiallyPopulated method

Modifies the value that indicates whether this IContextNode is partially or fully populated.

Syntax

HRESULT SetPartiallyPopulated(
  [in] VARIANT_BOOL fPartiallyPopulated
);

Parameters

fPartiallyPopulated [in]

VARIANT_TRUE if this IContextNode is partially populated; otherwise, VARIANT_FALSE.

Return value

For a description of the return values, see Classes and Interfaces - Ink Analysis.

Remarks

Use this method when your application maintains its own data structure, which is synchronized with that of the IInkAnalyzer. For more information, see Data Proxy with Ink Analysis.

When virtualizing your document tree, be sure to set the PropertyGuidsForContextNodes.RotatedBoundingBox value (using ContextNode.AddPropertyValue) on all ContextNode objects. The RotatedBoundingBox property is calculated by the InkAnalyzer and by default should be on all writing ContextNodes. However, if your application virtualizes the analysis results by setting the PartiallyPopulated property, when handling the PopulateContextNode event be sure to populate the RotatedBoundingBox property. Failure to set the RotatedBoundingBox property will result in potentially more document data being used in the current analysis operation

Requirements

See also

IContextNode

_IAnalysisProxyEvents::PopulateContextNode

IContextNode::CreatePartiallyPopulatedSubNode

IContextNode::GetPartiallyPopulated

Ink Analysis Reference