These docs are for v1.0. Click to read the latest docs for v1.2.

FINDSHAPEBYLABEL

Finds a shape using its unique shape identifier. Shape can exist anywhere in the document. To get a shape's identifier use LABEL.

Syntax

=FINDSHAPEBYLABEL(identifier)

=#identifier

Arguments

ArgumentTypeDescription
identifierStringThe identifier of the shape to find

Examples

TextIdentifierName
"Shape 1""xyz123""Ringo Starr"

=FINDSHAPEBYLABEL('xyz123')"Shape 1"
Returns a reference to Shape 1

=#'xyz123'"Shape 1"
Alternate syntax to return a reference to Shape 1

=FINDSHAPEBYLABEL('xyz123')."Name""Ringo Starr"
Returns the "Name" property from Shape 1

=FINDSHAPEBYLABEL('abc789')#ERROR!
Error if no shape with that identifier exists