IInkStrokeDisp::BezierCusps property

Gets an array that contains the indices of the cusps of the Bezier approximation of the stroke.

This property is read-only.

Syntax


HRESULT get_BezierCusps(
  [out, retval] VARIANT *Cusps
);

Property value

An array of integers for the indices of the points that are the cusps of the Bezier approximation of the stroke.

For more information about the VARIANT structure, see Using the COM Library.

Error codes

NameMeaning
S_OK

Success.

E_POINTER

Parameter pointer was NULL or invalid.

E_OUTOFMEMORY

Cannot allocate memory for the points.

E_INK_EXCEPTION

An exception occurred inside the method.

Remarks

Note  The array of Bezier control points that the BezierPoints property returns are made up of x and y values. The BezierCusps property refers only to the x values in this array. The y values can be retrieved by an action similar to the following below.
 

A cusp is a point on the stroke where the direction of writing changes in a discontinuous fashion. For example, if the stroke represents the capital letter "L", this property returns three cusps: two corresponding to the first and last control points on the stroke and the third representing the corner of the "L".

The following code extracts the x and y values of the Bezier cusps of an IInkStrokeDisp, theStroke, and stores them in a two-dimensional array called BezierCuspValues.

Requirements

Minimum supported client

Windows XP Tablet PC Edition [desktop apps only]

Minimum supported server

None supported

Header

Msinkaut.h (also requires Msinkaut_i.c)

Library

InkObj.dll

See also

IInkStrokeDisp Interface
BezierPoints Property

 

 

Show: