DrawGroup Method

Creates a group with the specified position, width and height. Returns an instance of the Shape object representing this group.

Applies to: Page object, Shape object

Syntax

[[Set] shapeRet =] object.DrawGroup ( xLeft, yTop, xRight, yBottom )

The DrawGroup method syntax has these parts:

Part Description
object Required. An expression that returns an instance of an object from the Applies to list.
xLeft

Required. A Double value that represents the X-coordinate of the top left corner of the rectangle that is the group's bound.

yTop

Required. A Double value that represents the Y-coordinate of the top left corner of the rectangle that is the group's bound.

xRight Required. A Double value that represents the X-coordinate of the bottom right corner of the rectangle that is the group's bound.
yBottom Required. A Double value that represents the Y-coordinate of the bottom right corner of the rectangle that is the group's bound.
shapeRet Optional. A Shape type variable.

Remarks

If object is a page or a group, the DrawGroup method creates a new group with the specified dimensions and adds it to the shape collection of the corresponding page or group. The coordinate origin of the created group (the GPinX and GPinY properties) is set in the point with the xLeft and yTop coordinates. The new group contains no shapes.

If object is a simple shape (not group), the DrawGroup method takes no action and returns Nothing.

The coordinates of the points are specified in the coordinate system of the shape, group or page to which the instance of the object object corresponds. The coordinates are set in internal units (InternalUnit).

 

See Also

GPinX property, GPinY property