Layer.FindShape method - Developer Area

API Documentation > CorelDRAW > 2024-v25 > Layer > IVGLayer

Layer.FindShape method

Finds a single shape by its name, type or Static ID

Syntax:

Function FindShape(Optional ByVal Name As String, Optional ByVal Type As cdrShapeType = cdrNoShape, Optional ByVal StaticID As Long = 0, Optional ByVal Recursive As Boolean = True) As Shape

Parameters:

Name	Type	Description
Name	String	Specifies the name of the shape for which to search.
Type	cdrShapeType	Specifies the shape type, and returns cdrShapeType.
StaticID	Long	Specifies the shape's unique ID.
Recursive	Boolean	Specifies whether to iterate through all shapes.

Remarks:

The FindShape method locates a shape with specified properties on a layer. If the shape cannot be found, an empty reference (nothing) is returned.

Examples:

The following VBA example finds a rectangle named Frame and selects it.

Sub Test()
  Dim s As Shape
  Set s = ActiveLayer.FindShape(Name:="Frame", Type:=cdrRectangleShape)
  If s Is Nothing Then
    MsgBox "The rectangle 'Frame' cannot be found on layer " & ActiveLayer.Name
  Else
    s.CreateSelection
  End If
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