VECTORCLONE

typedef struct tagVECTORCLONE
{
    VECTOROBJECT Object;
    VECTORPOINT Point;
    VECTORGROUP Group;
    L_UINT32 dwFlags;
    VECTORPEN Pen;
    VECTORBRUSH Brush;
    VECTORPOINT Scale;
    VECTORPOINT Rotation;
} VECTORCLONE,  * pVECTORCLONE;

The VECTORCLONE structure holds information about a vector clone object.

Member

Description

Object

Abstract object.

Point

A VECTORPOINT structure that contains the center of a vector clone object in space.

Group

A VECTORGROUP structure that contains the group this clone will be using.

dwFlags

Flag that indicates how to draw this clone object. Possible values are:

 

Value

Meaning

 

VECTOR_CLONE_USE_PEN

Use the Pen member of this structure to draw the clone. If this flag is not specified, the clone will use the same pen colors and styles as the original objects inside the group.

 

VECTOR_CLONE_USE_BRUSH

Use the Brush member of this structure to draw the clone. If this flag is not specified, the clone will use the same brush colors and styles as the original objects inside the group.

 

VECTOR_CLONE_USE_POINT_AS_ORIGIN

Use the Point member as the origin point when performing Scaling and Rotation. If this flag is not specified, the Scaling and Rotation will be performed around the accumulative center of all objects inside the group.

 

VECTOR_CLONE_USE_CHILDCLONE_ATTRIBUTES

Usually when creating nested VECTORCLONE objects in the vector drawing, you may need to allow the sub clone to maintain its objects’ colors when it’s a part of a larger clone which has one or both of the flags VECTOR_CLONE_USE_PEN or VECTOR_CLONE_USE_BRUSH is set. The default behavior is to use the same Pen/Brush of the main clone object to draw the sub clones, use this flag to override this.

Pen

VECTORPEN structure that contains information about the pen to use when drawing the vector clone object.

Brush

VECTORBRUSH structure that contains information about the brush to use when drawing the vector clone object.

Scale

A VECTORPOINT structure that contains the scaling factor to use when drawing this clone object.

Rotation

A VECTORPOINT structure that contains the rotation values to use when drawing this clone object.

Comments

nSize of the Object member must be the sizeof this structure.

nType of the Object member must be VECTOR_CLONE.

When drawing a clone object, the toolkit will first rotate the group around its origin using the values in Rotation, scale it around its origin using the values in Scale and finally translate it to the position specified in Point.

pVECTORCLONE is a pointer to a VECTORCLONE structure.