Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.
reorderContainer([back=boolean], [front=boolean], [relative=int])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
reorderContainer is undoable, queryable, and editable.
This command reorders (moves) objects relative to their siblings in
a container.
For relative moves, both positive and negative numbers may be
specified. Positive numbers move the object forward and
negative numbers move the object backward amoung its
siblings. When an object is at the end (beginning) of the list
of siblings, a relative move of 1 (-1) will put the object at
the beginning (end) of the list of siblings. That is,
relative moves will wrap if necessary.
Only nodes within one container can be moved at a time.
Note: The container command's -nodeList flag will return a sorted list of
contained nodes. To see the effects of reordering, use the -unsortedOrder flag
in conjunction with the -nodeList flag.
In query mode, return type is based on queried flag.
node, container, reorder
container
back, front, relative
| Long name (short name) |
Argument types |
Properties |
front(f)
|
boolean
|
  
|
|
Move object(s) to front of container contents list
|
|
back(b)
|
boolean
|
|
|
Move object(s) to back of container contents list
|
|
relative(r)
|
int
|
|
|
Move object(s) relative to other container contents
|
|
|
Flag can appear in Create mode of command
|
Flag can appear in Edit mode of command
|
|
Flag can appear in Query mode of command
|
Flag can have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
# create a container
cmds.sphere( n='sphere1' )
cmds.sphere( n='sphere2' )
cmds.sphere( n='sphere3' )
cmds.sphere( n='sphere4' )
cmds.container( addNode=['sphere1', 'sphere2', 'sphere3', 'sphere4'], n='sphereCon' )
# The container sphereCon contains sphere1, sphere2, sphere3 and sphere4.
# The command below moves sphere2 before sphere1.
cmds.reorderContainer( 'sphere2', r=-1 )
# make sphere1 the first sibling
cmds.reorderContainer( 'sphere1', front=True )
# move sphere3 forward 2 siblings. Moving it forward one
# sibling would put it at the end. Moving it forward again
# puts it at the beginning.
cmds.reorderContainer( 'sphere3', r=2 )