IInkAnalyzer::GetTextRangeFromNodes method

Finds the text range in the recognized string that corresponds to a collection of IContextNode objects.

Syntax

HRESULT GetTextRangeFromNodes(
  [out] LONG          *plStart,
  [out] LONG          *plLength,
  [in]  IContextNodes *pNodesToSearch
);

Parameters

plStart [out]

A 32-bit signed integer that indicates the start of the text range. This parameter is passed uninitialized.

plLength [out]

A 32-bit signed integer that indicates the length of the text range. This parameter is passed uninitialized.

pNodesToSearch [in]

The collection of IContextNode objects for which to find the text range.

Return value

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

Remarks

If pNodesToSearch contains IContextNode objects that are not adjacent, this method returns the smallest text range that covers all of the IContextNode objects.

This method throws an E_INVALIDARG exception when pNodesToSearch contains an IContextNode that is not associated with the IInkAnalyzer.

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

IInkAnalyzer