shapeExists()

Synopsis

bool shapeExists(string graphicsName);

Parameters

Return value

TRUE: Element exists

FALSE: Element does not exist

Errors

Missing/incorrect argument

Description

The function returns whether a graphics element exists in the panel.

The use of an empty string ("") as "shapeName" parameter will reference the shape itself. (See Example 2)

Example

main()
{
  if(!shapeExists("textfield"))
  {
    DebugN("Graphics element text field does not exist!");
  }
  if(!shapeExists("langlist1"))
  {
    DebugN("Graphics element langlist1 does not exist!");
  }
}

Example 2

The example is started in a script belonging to the object "Elipsis1" and checks whether the shape exists with an empty string parameter.

main()
{
  bool ret;
  ret = shapeExists("");
  DebugTN("return value: " + ret); //returns "TRUE"
}

Assignment

Graphics

Availability

UI