API Documentation > CorelDRAW > 2025-v26
ShapeRange class
Represents a dynamic array (or range) of Shape objects. Shape-specific properties and methods can be applied to each shape in a shape range.
Syntax:
Class ShapeRange
Remarks:
The ShapeRange class represents a dynamic array (or range) of Shape objects. Shape-specific properties and methods can be applied to each shape in a shape range. You can create a ShapeRange object by using the New keyword in Visual Basic.
Properties:
Name Description
_NewEnum Returns an enumerator that iterates through a collection
Application Gets the application to which the shape range belongs
BottomY Returns the Y coordinate of the bottom edge of the bounding box of shapes in the range
BoundingBox Returns the bounding rectangle around the shape(s)
CenterX Gets or sets the horizontal position of the center of the shapes
CenterY Gets or sets the vertical position of the center of the shapes
Count Gets the number of shapes in the range
FirstShape Returns the first shape in range
Item Gets a reference to the shape specified, in base 1
LastShape Returns the last shape in range
LeftX Returns the X coordinate of the left edge of the bounding box of shapes in the range
Parent Gets the parent of which the shape range is a child
PositionX Gets or sets the horizontal position (X) of the shape range on the page, according to the document's reference point
PositionY Gets or sets the vertical position (Y) of the shape range on the page, according to the document's reference point
ReverseRange Returns another shape range which contains all the shapes from the given range in the reverse order
RightX Returns the X coordinate of the right edge of the bounding box of shapes in the range
RotationCenterX Gets or sets the horizontal center of rotation (X) for the shape range on the page
RotationCenterY Gets or sets the vertical center of rotation (Y) for the shape range on the page
Shapes Returns a collection of shapes from the range
SizeHeight Gets or sets the height of the shape range on the page
SizeWidth Gets or sets the width of the shape range on the page
TopY Returns the Y coordinate of the top edge of the bounding box of shapes in the range
Methods:
Name Description
Add Adds a shape in a range
AddRange Adds a shape range into a range
AddToPowerClip Adds this shape range to a power clip
AddToSelection Adds a shaperange to a Selection
AffineTransform Applies affine transformation defined by transformation matrix components to the shape relative to the center point of the transformation
AlignAndDistribute Aligns and/or distributes shapes in the range
AlignRangeToGrid Aligns a shape range to the grid
AlignRangeToPage Aligns a shape range to the page's edges
AlignRangeToPageCenter Aligns a shape range to the center of the page
AlignRangeToPoint Aligns a shape range to the specified co-ordinates
AlignRangeToShape Aligns a shape range to the specified shape
AlignRangeToShapeRange Aligns a shape range to the bounding box of the specified shape range
AlignToGrid Aligns all shapes of the range to the grid
AlignToPage Aligns all shapes of the range to the page's edges
AlignToPageCenter Aligns all shapes of the range to the center of the page
AlignToPoint Aligns all shapes of the range to the specified co-ordinates
AlignToShape Aligns all shapes of the range to the specified shape
AlignToShapeRange Aligns all shapes of the range to the bounding box of the specified shape range
All Returns a copy of the current shape range
AllExcluding Creates a new shape range out of all the shapes in the current range except the specified list of shapes
ApplyCustomHatchFill Applies a custom hatch fill to the shapes in the range
ApplyEffectBCI Applies Brightness-Contrast-Intensity color effect to the shapes in the range
ApplyEffectColorBalance Applies Color balance effect to the shapes in the range
ApplyEffectGamma Applies gamma color correction effect to the shapes in the range
ApplyEffectHSL Applies Hue-Saturation-Lightness color effect to the shapes in the range
ApplyEffectInvert Inverts the colors of the shapes in the range
ApplyEffectPosterize Applies Posterize color effect to the shapes in the range
ApplyFill Applies the specified fill to objects in the range
ApplyFountainFill Apply a Fountain Fill to all shapes in the range
ApplyHatchFill Applies a preset hatch fill from a library to the shapes in the range
ApplyNoFill Apply no Fill to all shapes in the range
ApplyOutline Applies the specified outline to objects in the range
ApplyPatternFill Apply a Pattern Fill to all shapes in the range
ApplyPostscriptFill Apply a PostScript Fill to all shapes in the range
ApplyTextureFill Apply a Texture Fill to all shapes in the range
ApplyUniformFill Apply a Uniform Fill to all shapes in the range
BreakApart Breaks all objects in the range apart
BreakApartEx Breaks all objects in the range apart and returns the broken shapes as a shape range
Chamfer Creates chamfers on each cusp corner of shapes in the range
ClearEffect Clears effects for the shapes in the shape range.
ClearTransformations Clears all rotation, stretch and skew transformations applied to the shapes in this range
Clone Clones the ShapeRange and returns a reference to the range
Combine Combines all shapes together
ConvertOutlineToObject Converts an outline into an object
ConvertToBitmap Rasterizes all shapes in the range to a bitmap object
ConvertToBitmapEx Rasterizes range of shapes to a Bitmap file and returns a shape
ConvertToCurves Convert all shapes within a range to curves
ConvertToSymbol Convert a shape to a symbol
Copy Copies the shaperange to the cliboard
CopyPropertiesFrom Copies fill, outline and/or text properties from another shape
CopyToLayer Copies all shapes in the range to the specified layer
CountAnyOfType Returns the number of shapes of specific types in the range
CreateBoundary Creates a boundary shape around the items in the ShapeRange
CreateDocumentFrom Creates a copy of a document containing the shapes in the range
CreateParallelCurves Creates a set of new shapes parallel to the appropriate shapes in the range; works on shapes containing only open paths.
CreateSelection Makes a selection from a shape range
CustomCommand Executes a custom command on the given shapes
Cut Removes the shaperange form the page, and places it onto the clipboard
Delete Deletes a shape in a range
DeleteItem Removes the specified shape from the shape range and deletes it from the document
Distribute Distributes the shapes in the ShapeRange
Duplicate Duplicates the entire Shape range
EqualDivide Divides the objects in the ShapeRange into equal divisions
Exists Determines if the given shape is present in the range
ExistsAnyOfType Determines if the range contains any shapes of specific types
Fillet Creates fillets on each cusp corner of shapes in the range
FindAnyOfType Returns a list of shapes of specific types contained in the range
FlattenEffects Flattens live bitmap effects by converting objects to bitmap images
Flip Mirrors all shapes within the range, either horizontall andor vertically
GetBoundingBox Gets the shape range bounding box relatively to its lower left corner
GetColors Returns the list of colors used in the range.
GetColorTypes Returns the list of color types used in the range.
GetLinkedShapes Gets all the shapes linked in some way to the shapes in the range
GetOverprintFillState Returns the overprint fill state flags for the shape range
GetOverprintOutlineState Returns the overprint outline state flags for the shape range
GetPosition Returns the x y position of the shape range
GetPositionEx Returns the coordinates of the specified point
GetSize returns the width and height of the shape range
GetToolShapes Gets a subset shape range that match a toolshape GUID
Group Creates a group from all shapes in the range
Hide Hides all the shapes in the range
IndexOf Gets the index of a shape
Lock Locks all shapes in the range
ModifyToolShapeProperties Modifies addon tool shape's properties
Move specify a distance to move a shape range horizontally andor vertically
MoveToLayer Moves all shapes in the range to the specified layer
OrderBackOf Arranges the shape's stacking order by moving it in back of another shape
OrderBackOne Arranges the shape's stacking order by moving it back one
OrderForwardOne Arranges the shape's stacking order by moving it forward one
OrderFrontOf Arranges the shape's stacking order by moving it in front of another shape
OrderReverse Reverses
OrderToBack Arranges the shape's stacking order by moving it to the back
OrderToFront Arranges the shape's stacking order by moving it to the front
Project Assigns all shapes to one of our 3D projection planes
Range Creates a new shape range out of the specified list of shapes from the current range
Remove Removes as pecified shape from a the range
RemoveAll Removes All shapes form the range
RemoveFromContainer Removes this shape range from a power clip
RemoveFromSelection Removes the shape in the range from the current selection
RemoveRange Removes a range of shapes from the shape range.
RestoreCloneLink Restores clone links for the shapes in the shape range.
Rotate Rotates the shape by adding the amount to the current rotation value
RotateEx EX-Rotates the shape by adding the amount to the current rotation value
Scallop Creates scallops on each cusp corner of shapes in the range
SetBoundingBox Move and resize a shape to fit within a specific bounding box, (Area and location)
SetFillMode Specifies the fill mode for the shapes in the range
SetOutlineProperties Sets all outline properties
SetOutlinePropertiesEx Sets all outline properties
SetPixelAlignedRendering Sets the align to pixel property to the shapes in the range
SetPosition Move a shape range to a specific location
SetPositionEx Moves the shapes to the coordinates of the specified point
SetRotationCenter Sets the rotation center of the shape range
SetSize Stretches a shape range to fit a specific width and height
SetSizeEx Sets the shape range size using the anchor point
Show Shows all the shapes in the range
Skew Skews all shapes within the range by a horizontal and vertical angle
SkewEx Skews all shapes in the range by specifying a center point and angle
Sort Sorts shapes in the range based on the CQL condition expression
Split Split the range into subranges delimited by shapes in the Separators parameter
StepAndRepeat Creates multiple copies of the shapes in the range
Stretch Stretches the shapes in the shape range
StretchEx Stretches the shapes in the shape range using the anchor point
Ungroup Ungroups one level of groups in the range
UngroupAll Ungroups all shapes including nested groups
UngroupAllEx Ungroups all grouped shapes and returns the ungrouped objects as a shape range
UngroupEx Ungroups one level of groups in the range and return the ungrouped shape as a range
Unlock Unlocks all shapes in the range
Unproject Removes projection transformation from a range of shapes