Shape.Trim method - Developer Area

API Documentation > Corel DESIGNER > 2017.1 > Shape > IVGShape

Shape.Trim method

Trims shape from another object

Syntax:

Function Trim(ByVal TargetShape As Shape, Optional ByVal LeaveSource As Boolean = True, Optional ByVal LeaveTarget As Boolean = False) As Shape

Parameters:

Name	Type	Description
TargetShape	Shape	Specifies the shape with which to trim
LeaveSource	Boolean	Specifies whether to keep an original of the trimmed shape.
LeaveTarget	Boolean	Specifies whether to keep the shape with which the trim was performed.

Remarks:

The Trim method trims a shape.

Examples:

The following VBA example creates text embossed on a texturized surface.

Sub Test()
  Const Offset As Double = 0.05
  Dim sBase As Shape, sLight As Shape, sDark As Shape
  Dim sRect As Shape
  Set sRect = ActiveLayer.CreateRectangle2(0.75, 4, 7, 3)
  Set sBase = ActiveLayer.CreateArtisticText(4.25, 4.75, "Bevel")
  With sBase.Text
    With .FontProperties
      .Name = "Arial"
      .Size = 150
      .Style = cdrBoldFontStyle
    End With
    .AlignProperties.Alignment = cdrCenterAlignment
  End With
  Set sLight = sBase.Duplicate(-Offset, Offset)
  Set sLight = sBase.Trim(sLight)
  sLight.Fill.UniformColor.CMYKAssign 20, 0, 20, 0
  Set sDark = sBase.Duplicate(Offset, -Offset)
  sDark.Fill.UniformColor.CMYKAssign 100, 0, 100, 80
  sBase.Trim sDark, False, False
  sRect.Fill.ApplyTextureFill "Ivy on a Wall", "Samples 7"
End Sub

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, 2023-v24.5, 2024-v25
Corel DESIGNER:	X7, 2017.1, 20.1, 2019.2, 2020.1, 2021.5, 2022-v24, 2022-v24.1, 2022-v24.2, 2023-v24.3, 2023-v24.5, 2024-v25