IInkStrokeDisp interface

Represents a single ink stroke.

A stroke is a set of properties and point data that the digitizer captures that represent the coordinates and properties of a known ink mark. It is the set of data that is captured in a single pen down, up, or move sequence.

Members

The IInkStrokeDisp interface inherits from the IUnknown interface. IInkStrokeDisp also has these types of members:

Methods

The IInkStrokeDisp interface has these methods.

MethodDescription
Clip

Removes the portions of the IInkStrokeDisp that are outside a rectangle.

FindIntersections

Finds the points where this IInkStrokeDisp intersects other strokes within an InkStrokes collection.

This method can determine only the points of intersection.

GetBoundingBox

Retrieves a rectangle, in ink space coordinates, that corresponds to the portion of the display to invalidate or redraw when displaying an IInkStrokeDisp.

GetFlattenedBezierPoints

Retrieves the array of actual points that are used to approximate the Bezier representation of a stroke.

GetPacketData

Retrieves the packet data associated with one or more points in an IInkStrokeDisp object.

GetPacketDescriptionPropertyMetrics

Retrieves the metrics for a given packet description type.

GetPacketValuesByProperty

Retrieves the data for a known packet property from one or more packets in the IInkStrokeDisp object.

GetPoints

Retrieves the points that make up a stroke.

GetRectangleIntersections

Finds the points where a stroke intersects a given rectangle.

HitTestCircle

Determines whether a stroke is either completely inside or intersected by a given circle.

Move

Applies a translation to the ink of the stroke.

NearestPoint

Finds the location on the stroke nearest to a known point and returns the distance that point is from the stroke. Everything is in ink space coordinates.

Rotate

Rotates the ink using an angle in degrees around a center point of the rotation.

ScaleToRectangle

Scales the stroke to fit in the specified rectangle.

ScaleTransform

Scales the ink using X and Y factors.

SetPacketValuesByProperty

Sets the packet values for a particular property.

SetPoints

Sets the points of the stroke using an array of X, Y values.

Shear

Shears the ink in the stroke by the specified horizontal and vertical factors.

Split

Splits the stroke at the specified location on the stroke.

Transform

Applies a linear transformation to a stroke, which can represent scaling, rotation, translation, and combinations of transformations.

 

Properties

The IInkStrokeDisp interface has these properties.

PropertyAccess typeDescription

BezierCusps

Read-only

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

BezierPoints

Read-only

Gets the array of control points that represent the Bezier approximation of the stroke.

Deleted

Read-only

Gets a value that indicates whether the IInkStrokeDisp object has been deleted from its parent InkDisp object.

DrawingAttributes

Read/write

Gets or sets the drawing attributes to apply to ink as it is drawn.

ExtendedProperties

Read-only

Gets the collection of application-defined data.

Id

Read-only

Gets the identifier of the IInkStrokeDisp object.

Ink

Read-only

Gets the parent InkDisp object for this stroke.

PacketCount

Read-only

Gets the number of packets received for a stroke.

PacketDescription

Read-only

Gets an array of globally unique identifiers (GUIDs) that describes the types of packet data stored in the Stroke object.

PacketSize

Read-only

Gets the size, in bytes, of a packet.

PolylineCusps

Read-only

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

SelfIntersections

Read-only

Gets the self-intersections of the stroke.

 

Remarks

If you define a class that implements this interface, the new class will not interact correctly with the Tablet PC application programming interfaces (APIs).

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

IInkCursor Interface
InkDisp Class
InkStrokes Collection

 

 

Show: