selectPref

Go to: Synopsis. Return value. Related. Flags. MEL examples.

Synopsis

selectPref [-affectsActive boolean] [-allowHiliteSelection boolean] [-autoSelectContainer boolean] [-clickBoxSize uint] [-clickDrag boolean] [-containerCentricSelection boolean] [-disableComponentPopups boolean] [-expandPopupList boolean] [-ignoreSelectionPriority boolean] [-manipClickBoxSize uint] [-popupMenuSelection boolean] [-singleBoxSelection boolean] [-xformNoSelect boolean]

selectPref is undoable, queryable, and NOT editable.

Return value

In query mode, return type is based on queried flag.

Related

Flags

Long name (short name)	Argument types	Properties
-singleBoxSelection(-sbs)	boolean
Set single box selection on/off. This flag indicates whether just single object will be selected when the user box (marquee) selects several objects if flag set to true. Otherwise, all those objects inside the box will be selected.
-clickBoxSize(-cbs)	uint
When click selecting, this value defines the size of square picking region surrounding the cursor. The size of the square is twice the specified value. That is, the value defines the amount of space on all four sides of the cursor position. The size must be positive.
-manipClickBoxSize(-mcb)	uint
When selecting a manipulator, this value defines the size of square picking region surrounding the cursor. The size of the square is twice the specified value. That is, the value defines the amount of space on all four sides of the cursor position. The size must be positive.
-clickDrag(-cld)	boolean
Set click/drag selection interaction on/off
-affectsActive(-aa)	boolean
Set affects-active toggle which when on causes the active list to be affected when changing between object and component selection mode.
-xformNoSelect(-xns)	boolean
Disable selection in xform tools
-allowHiliteSelection(-ahs)	boolean
When in component selection mode, allow selection of objects for editing. If an object is selected for editing, it appears in the hilite color and its selectable components are automatically displayed.
-ignoreSelectionPriority( -isp)	boolean
If this is set, selection priority will be ignored when performing selection.
-popupMenuSelection(-pms)	boolean
If this is set, a popup menu will be displayed and used to determine the object to select. The menu lists the current user box (marquee) of selected candidate objects.
-expandPopupList(-epl)	boolean
When in popup selection mode, if this is set then all selection items that contain multiple objects or components will be be expanded such that each object or component will be a single new selection item.
-disableComponentPopups( -dcp)	boolean
A separate preference to allow users to disable popup menus when selecting components. This pref is only meaningful if the popupMenuSelection pref is enabled.
-containerCentricSelection( -ccs)	boolean
When enabled, selecting any DAG node in a container in the viewport will select the container's root transform if there is one. If there is no root transform then the highest DAG node in the container will be selected. There is no effect when selecting nodes which are not in a container.
-autoSelectContainer(-asc)	boolean
When enabled, with container centric selection also on, whenever the root transform is selected in the viewport, the container node will automatically be selected as well.

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 be used more than once in a command.

MEL examples

// enable popup menu selection except for components
//
selectPref -popupMenuSelection true -disableComponentPopups true;