selectionConnection is undoable, queryable, and editable.
This command creates a named selectionConnection object. This object
is simply a shared selection list. It may be used by editors to
share their highlight data. For example, an outliner may attach its
selected list to one of these objects, and a graph editor may use the
same object as a list source. Then, the graph editor would only
display objects that are selected in the outliner.
In query mode, return type is based on queried flag.
Long name (short name) |
Argument types |
Properties |
|
-activeCacheList(-atc)
|
|
|
|
Specifies that this connection should reflect the cache that objects
on the active list belong to.
|
|
-activeCharacterList(-acl)
|
|
|
|
Specifies that this connection should reflect the characters that objects
on the active list belong to.
|
|
-activeList(-act)
|
|
|
|
Specifies that this connection should reflect the active
list (geometry objects and keys).
|
|
-addScript(-as)
|
script
|
|
|
Specify a script to be called when something is added to the
selection.
|
|
-addTo(-add)
|
string
|
|
|
The name of a selection connection that should be added to this
list of connections.
|
|
-characterList(-cl)
|
|
|
|
Specifies that this connection should reflect all the characters in
the world.
|
|
-clear(-clr)
|
|
|
|
Remove everything from the selection connection.
|
|
-connectionList(-lst)
|
|
|
|
Specifies that this connection should contain a list of selection
connections.
|
|
-defineTemplate(-dt)
|
string
|
|
|
Puts the command in a mode where any other flags and arguments are
parsed and added to the command template specified in the argument.
They will be used as default arguments in any subsequent
invocations of the command when templateName is set as the
current template.
|
|
-deselect(-d)
|
name
|
|
|
Remove something from the selection.
|
|
-editor(-ed)
|
string
|
|
|
Specifies that this connection should reflect the -mainListConnection
of the specified editor.
|
|
-exists(-ex)
|
|
|
|
Returns whether the
specified object exists or not. Other flags are ignored.
|
|
-filter(-f)
|
string
|
|
|
Optionally specifies an itemFilter for this connection.
An empty string ("") clears the current filter.
If a filter is specified, all the information going into
the selectionConnection must first pass through the filter
before being accepted.
NOTE: filters can only be attached to regular selectionConnections.
They cannot be attached to any connection created using
the -act, -mdl, -key, -wl, -sl, -cl, -lst, -obj, or -ren flags.
We strongly recommend that you do not attach filters to a
selectionConnection --- it is better to attach your filter
to the editor that is using the selectionConnection instead.
|
|
-findObject(-fo)
|
name
|
|
|
Find a selection connection in this list that wraps the specified
object.
|
|
-global(-g)
|
boolean
|
|
|
A global selection connection cannot be deleted by any script
commands.
|
|
-highlightList(-hl)
|
|
|
|
Specifies that this connection is being used as a highlight list.
|
|
-identify(-id)
|
|
|
|
Find out what type of selection connection this is. May be:
activeList | modelList | keyframeList | worldList | objectList
listList | editorList | connection | unknown
|
|
-keyframeList(-key)
|
|
|
|
Specifies that this connection should reflect the animation
portion of the active list.
|
|
-lock(-lck)
|
boolean
|
|
|
For activeList connections, locking the connection means that
it will not listen to activeList changes.
|
|
-modelList(-mdl)
|
|
|
|
Specifies that this connection should reflect the modeling
(i.e. excluding keys) portion of the active list.
|
|
-object(-obj)
|
name
|
|
|
Specifies that this connection should wrap around the specified
object (which may be a set). Query will return all the members of the
selection connection (if the connection wraps a set, the set members will
be returned)
|
|
-parent(-p)
|
string
|
|
|
The name of a UI object this should be attached to. When the
parent is destroyed, the selectionConnection will auto-delete.
If no parent is specified, the connection is created in the
current controlLayout.
|
|
-remove(-rm)
|
string
|
|
|
The name of a selection connection that should be removed from
this list of connections.
|
|
-removeScript(-rs)
|
script
|
|
|
Specify a script to be called when something is removed from
the selection.
|
|
-select(-s)
|
name
|
|
|
Add something to the selection. This does not replace the
existing selection.
|
|
-setList(-sl)
|
|
|
|
Specifies that this connection should reflect all the sets in
the world.
|
|
-switch(-sw)
|
|
|
|
Acts as a modifier to -connectionList which sets the list of objects
to be the first non-empty selection connection. selection connections
are tested in the order in which they are added.
|
|
-useTemplate(-ut)
|
string
|
|
|
Forces the command to use a command template other than
the current one.
|
|
-worldList(-wl)
|
|
|
|
Specifies that this connection should reflect all objects
in the world.
|
|