Shape class
Represents the settings for a CorelDRAW or Corel DESIGNER shape object (or 'shape'), group, or selection; and allows editing of existing shapes
Syntax:
Class Shape
Remarks:
The Shape class represents the settings for a CorelDRAW shape object (or "shape"), group, or selection.
Properties:
Name Description
AbsoluteHScale Returns the absolute Horizontal Scale. This is the total of all Horizontal stretches applied to a shape.
AbsoluteSkew Returns the absolute skew angle applied to a shape since its creation
AbsoluteVScale Returns the absolute Vertical Scale. This is the total of all Vertical stretches applied to a shape.
Application Returns the application to which the object belongs
Bitmap Allows users to access the bitmap properties
BottomY Returns or sets the Y coordinate of the bottom edge of the shape
BoundingBox Returns the bounding rectangle around the shape(s)
BSpline Returns a read-only BSpline object
CanHaveFill Returns True if a fill can be applied to the given shape
CanHaveOutline Returns True if an outline can be applied to the given shape
CenterX Returns or sets the horizontal position of the center of the shape
CenterY Returns or sets the vertical position of the center of the shape
CloneLink Returns the clone link properties
Clones Returns the collection of cloned shapes
Connector Allows users to access the connector properties
Curve Allows users to access the curve properties
Custom Returns the properties of a custom shape
Dimension Returns a read-only Dimension object
DisplayCurve Returns a read-only curve object representing the current shape
DrapeFill Returns or sets whether there is a DrapeFill
Effect Returns effect object for current object if applicable
Effects Returns a collection of effects applied to object
Ellipse Allows users to access the ellipse properties
EPS Returns the properties of an Embedded PostScript object
Fill Returns or sets the fill properties
FillMode Returns or sets the fill mode for the shape
Guide Allows users to access guide properties
IsSimpleShape Returns True if the shape is not a group shape of any kind
Layer Returns or sets the layer that the shape resides upon
LeftX Returns or sets the X coordinate of the left edge of the shape
Locked Returns or sets whether the shape is Locked
Name Returns or sets a shape's name
Next Returns the next shape
ObjectData Returns a DataItems collection, which represents the object data associated with a shape
OLE Returns an OLE object
OriginalHeight Returns Original Height of the shape, ignores any transformations that may have been applied after creation.
OriginalWidth Returns Original Width of the shape, ignores any transformations that may have been applied after creation.
Outline Allows users to access the outline properties
OverprintBitmap Returns or sets whether the bitmap should be overprinted
OverprintFill Returns or sets whether the fill should be overprinted
OverprintOutline Returns or sets whether the outline should be overprinted
Page Returns the page that the shape belongs to
Parent Returns the parent of which the object is a child: if the shape is a Selection Shape it will be a document, otherwise it will be a layer
ParentGroup Returns a shape object that represents the group shape to which the active shape belongs to
PixelAlignedRendering Returns and sets the align to pixel property of the shape
Polygon Allows users to access the polygon properties
PositionX Returns or sets the horizontal position (X) of the shape on the page, according to the document's reference point
PositionY Returns or sets the vertical position (Y) of the shape on the page, according to the document's reference point
PowerClip Returns the PowerClip
PowerClipParent Returns the PowerClip parent
Previous Returns the previous shape
Properties Gives access to the shape's invdividual properties
Rectangle Allows users to access the rectangle properties
RightX Returns or sets the X coordinate of the right edge of the shape
RotationAngle Returns or sets the rotation angle of the shape on the page
RotationCenterX Returns or sets the horizontal center of rotation (X) for the shape on the page
RotationCenterY Returns or sets the vertical center of rotation (Y) for the shape on the page
Selectable Determines if the shape is currently visible and not locked
Selected Returns or sets the object's selection state; single selects if selecting
Shapes Returns a collection of shapes
SizeHeight Returns or sets the height of the shape on the page
SizeWidth Returns or sets the width of the shape on the page
SnapPoints Returns the points collection of the object
Spread Returns the page spread the shape belongs to
StaticID Returns the Object Data Manager's Static ID field
Style Returns a styleset applied to the shape
Symbol Returns the Symbol property of the shape
Text Allows users to access the text properties
TextWrapOffset Returns or sets the text wrap offset
TopY Returns or sets the Y coordinate of the top edge of the shape
TransformationMatrix Returns or sets the transformation matrix applied to the shape
Transparency Returns the transparency for the current object if applicable
TreeNode Returns the tree node corresponding to the given shape object
Type Returns the shape's type to distinguish between shape types (rectangles, ellipses,text, curves, etc.)
URL Returns the hyperlink for the shape
Virtual Returns True if the shape is a temporary object
Visible Returns or sets whether the shape is Visible
WrapText Returns or sets whether overlaying text will wrap around the shape
ZOrder Returns the index of the shape in its parent shape collection
Methods:
Name Description
AddToPowerClip Adds this shape to a PowerClip object
AddToSelection Adds a shape to a selection; does not work if the shape is a Selection Shape
AffineTransform Applies an affine transformation (as defined by the transformation-matrix components) to a shape, relative to the center point of the transformation
AlignAndDistribute Aligns and/or distributes the shape or shapes in the selection
AlignToGrid Aligns a shape to the grid
AlignToPage Aligns a shape to the page
AlignToPageCenter Aligns a shape to the page center
AlignToPoint Aligns a shape to the specified co-ordinates
AlignToShape Aligns a shape to another shape
AlignToShapeRange Aligns a shape to a ShapeRange
ApplyEffectBCI Applies a Brightness-Contrast-Intensity color effect
ApplyEffectColorBalance Applies a Color balance effect
ApplyEffectGamma Applies a gamma color correction effect
ApplyEffectHSL Applies a Hue-Saturation-Lightness color effect
ApplyEffectInvert Inverts the colors of the shape or selection
ApplyEffectPosterize Applies a Posterize color effect
ApplyStyle Applies a text/graphic style
ApplyTransformMatrix Applies the transformation matrix to the shape
BreakApart Breaks apart a shape that was previously combined with another shape
BreakApartEx Breaks the curve apart and returns the objects as a shape range
Chamfer Creates chamfers on each cusp corner of the shape
ClearEffect Clears any effect applied to the shape
ClearTransformations Clears all rotations as well as stretch and skew transformations applied to the shape
Clone Clones the shape and returns a reference to the cloned shape
CloneAsRange Clones the shape or selection and returns the cloned shape(s) as a shape range
Combine Combines a shape with another shape. The shapes must be part of the same selection.
CompareTo Compares the properties of two shapes
CompareToEx Compares the two shapes using the CQL expression as condition, and returns True if the condition is met
ConvertToBitmap Rasterizes the shape from a vector to a bitmap object
ConvertToBitmapEx Converts a shape to a bitmap
ConvertToCurves Converts a shape to curves
ConvertToSymbol Converts a shape to a symbol
Copy Copies the shape to the Clipboard
CopyPropertiesFrom Copies fill, outline and/or text properties from another shape
CopyToLayer Copies the shape to the specified layer
CopyToLayerAsRange Copies the shape or selection to the specified layer and returns the duplicated shape(s) as a range
CreateArrowHead Creates an arrow from a shape
CreateBlend Blends two shapes
CreateBoundary Creates a boundary shape around the Shape object
CreateContour Creates a contour effect
CreateCustomDistortion Applies a custom distortion to a shape
CreateCustomEffect Applies a custom effect to a shape
CreateDocumentFrom Creates a copy of a document containing the shape
CreateDropShadow Applies a dropshadow effect to a shape
CreateEnvelope Creates an envelope effect
CreateEnvelopeFromCurve Creates an envelope effect by using the specified curve as a template
CreateEnvelopeFromShape Creates an envelope effect by using the specified shape as a template
CreateExtrude Creates an extrude effect
CreateInnerShadow Applies an inner shadow effect to a shape
CreateLens Creates a lens effect
CreateParallelCurves Creates a set of new shapes parallel to this shape; works on shapes containing only open paths.
CreatePerspective Creates a perspective effect
CreatePushPullDistortion Creates a push-pull distortion effect
CreateSelection Creates a selection from a shape
CreateTwisterDistortion Creates a twister distortion effect
CreateZipperDistortion Creates a zipper distortion effect
CustomCommand Executes a custom command on the given shape
Cut Removes the shape from the page, and copies it to the Clipboard
Delete Deletes the shape
Distribute Distributes the shapes evenly in the selection
Duplicate Duplicates the shape
DuplicateAsRange Duplicates the shape or selection and returns the duplicated shape(s) as a shape range
EqualDivide Divides the object into equal divisions
Evaluate Evaluates the given CQL expression by using properties of the current shape and returns the result of the expression
Fillet Creates fillets on each cusp corner of the shape
FindShapeAtPoint Finds a child shape at the given point on the page. Return Nothing if none found at the given location.
FindSnapPoint Finds a snap point by using reference data
FlattenEffects Flattens live bitmap effects by converting an object to a bitmap image
Flip Mirrors an existing shape horizontally andor vertically. No new object is created.
GetBoundingBox Returns the shape bounding box relative to its lower-left corner
GetColors Returns the list of colors used in the shape.
GetColorTypes Returns the list of color types used in the shape.
GetLinkedShapes Returns all the shapes linked in some way to the current shape
GetMatrix Returns the values used in the tranformation matrix of a transformed shape
GetOverprintFillState Returns the overprint fill state flags for the shape
GetOverprintOutlineState Returns the overprint outline state flags for the shape
GetPosition Returns x and y coordinate and ReferencePoint of a shape
GetPositionEx Returns the coordinates of the specified point
GetSize Returns the width and height of a shape
GetToolShapeGuid Gets the tool shape GUID. Returns an empty string if it is a built-in type
Group Creates a group of selected Objects
Intersect Creates a shape consisting of an intersection of two shapes
IsOnShape Finds if the given coordinates are 'inside', 'outside' or on the margins of the curve
IsTypeAnyOf Returns True if the specified shape is of a type included in the list
ModifyToolShapeProperties Modifies an addon tool shape's properties
Move Specifies a distance to move a shape horizontally andor vertically
MoveToLayer Moves the shape to the specified layer
OrderBackOf Moves the shape behind another shape
OrderBackOne Moves the shape back one in the stacking order
OrderForwardOne Moves the shape forward one in the stacking order
OrderFrontOf Moves the shape in front of another shape
OrderIsInFrontOf Determines whether or not one shape is in front of another
OrderReverse Reverses the stacking order
OrderToBack Moves the shape to the back in the stacking order
OrderToFront Moves the shape to the front in the stacking order
PlaceTextInside Places the given text inside a shape
Project Assigns a shape to one of the 3D-like projection planes
RemoveFromContainer Removes this shape from a PowerClip object
RemoveFromSelection Removes a shape from a selection; does not work if the shape is a Selection Shape
ReplaceWith Logs a shape replacement transaction so that it can be undone by the user
Rotate Rotates the shape by adding the amount to the current rotation value
RotateEx Rotates an object by specifying the center and angle of rotation
Scallop Creates scallops on each cusp corner of the shape
Separate Separates shapes that have been combined, or are from a link group
SetBoundingBox Moves and resizes a shape to fit within a specific bounding box (Area and location)
SetMatrix Applies new values to a shape that has undergone a transformation
SetPosition Moves a shape to a specific location
SetPositionEx Moves the shape to the coordinates of the specified point
SetRotationCenter Specifies the horizontal and vertical position of the center of rotation for the shape
SetSize Stretches a shape to fit a specific width and height
SetSizeEx Sets the shape size by using the anchor point
Skew Specifies an angle(vertical andor Horizontal) to skew a shape
SkewEx Skews a shape by specifying center, horizontal and vertical angles
SnapPointsOfType Returns a collection of snap points of a given type
StepAndRepeat Creates multiple copies of the shape
Stretch Specifies a value to stretch a shape horizontally andor vertically relative to its reference point
StretchEx Stretches the shape by using the anchor point
TransformMatrix Modifies the shape's transformation matrix by multiplying it by the given matrix
Trim Trims shape from another object
Ungroup Ungroups a group of shapes
UngroupAll Ungroups all shapes, including nested groups
UngroupAllEx Ungroups all sub-groups and returns the ungrouped objects as a shape range
UngroupEx Returns the ungrouped objects as a shape range
Unproject Removes a projection transformation from a shape
Weld Welds shape to another object
Version Information:
CorelDRAW: X7.4, X7, X7.6, X8, 2017, 2018, 2019, 2019.2, 2020, 2021, 2020.1, 2021.5, 2022-v24, 2022-v24.1, 2022-v24.2, 2023-v24.3
Corel DESIGNER: X7, 2017.1, 20.1, 2019.2, 2020.1, 2021.5, 2022-v24, 2022-v24.1, 2022-v24.2, 2023-v24.3

© Corel Corporation. All rights reserved. The content herein is in the form of a personal web log ("Blog") or forum posting. As such, the views expressed in this site are those of the participants and do not necessarily reflect the views of Corel Corporation, or its affiliates and their respective officers, directors, employees and agents. Terms of Use / Privacy​ ​/ ​Cookies / Terms and Conditions / User Guidelines.