A function that can be used in Formulas.

Syntax and semantics

selected$# ( )

return a list of the full names of all currently selected objects.

selected$# (type$)

return a list of the given names of all currently selected objects of type type$.

Pitfall

You cannot normally use this function to cycle through all selected objects, because if two objects happen to have the same full name, you will select the same object twice. To cycle through all selected objects, use selected# instead, because the IDs are guaranteed to be unique.

Example

Assume that at the start of the following script, the list of objects is empty:

At this point, the list of objects will contain three objects, which will look as follows (ID, type name, given name), where the two that stand selected are given in bold:

The full names of the two selected objects are Sound sine377 and PointProcess sine377_sine377, respectively, and this is what selected$# ( ) will show:

or

We can also just list the given names of the selected Sound objects:

or of the selected Pitch objects (there should be none):

or of the selected PointProcess objects:

Note that here we see only the given names (not the full names), because the type names are already known.

Test

An automated test:

Links to this page

• Functions
• What's new?