set_name


Description:

public bool set_name (string? name)

Sets the name for the element.

If null is given for name, then the library will instead generate a new name based on the type name of the element, such as the name "uriclip3" for a UriClip, and will set that name instead.

If this already has a timeline, you should not call this function with name set to null.

You should ensure that, within each Timeline, every element has a unique name. If you call this function with name as null, then the library should ensure that the set generated name is unique from previously **generated** names. However, if you choose a name that interferes with the naming conventions of the library, the library will attempt to ensure that the generated names will not conflict with the chosen name, which may lead to a different name being set instead, but the uniqueness between generated and user-chosen names is not guaranteed.

Parameters:

this

A TimelineElement

name

The name this should take

Returns:

true if name or a generated name for this could be set.