icontextnode-setpartiallypopulated.md

description	ms.assetid	title	ms.topic	ms.date	topic_type	api_name	api_type	api_location
Modifies the value that indicates whether this IContextNode is partially or fully populated.	4d8e1ec0-757d-4346-a77e-263bd612972b	IContextNode::SetPartiallyPopulated method (IACom.h)	reference	05/31/2018	APIRef kbSyntax	IContextNode.SetPartiallyPopulated	COM	IACom.dll

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

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)
DLL	IACom.dll

See also

IContextNode

_IAnalysisProxyEvents::PopulateContextNode

IContextNode::CreatePartiallyPopulatedSubNode

IContextNode::GetPartiallyPopulated

Ink Analysis Reference