pymel.core.general.selectPref¶

selectPref(*args, **kwargs)¶

This command controls state variables used to selection UI behavior.

Flags:

Long Name / Short Name		Argument Types	Properties
affectsActive / aa		bool
	Set affects-active toggle which when on causes the active list to be affected when changing between object and component selection mode.
allowHiliteSelection / ahs		bool
	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.
autoSelectContainer / asc		bool
	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.
autoUseDepth / aud		bool
	When enabled, useDepth and paintSelectWithDepth will be automatically enabled in shaded display mode and disabled in wireframe display mode.
clickBoxSize / cbs		int
	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.
clickDrag / cld		bool
	Set click/drag selection interaction on/off
containerCentricSelection / ccs		bool
	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.
disableComponentPopups / dcp		bool
	A separate preference to allow users to disable popup menus when selecting components. This pref is only meaningful if the popupMenuSelection pref is enabled.
expandPopupList / epl		bool
	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.
ignoreSelectionPriority / isp		bool
	If this is set, selection priority will be ignored when performing selection.
manipClickBoxSize / mcb		int
	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.
paintSelect / ps		bool
	When enabled, the select tool will use drag selection instead of marquee selection.
paintSelectRefine / psf		bool
paintSelectWithDepth / psd		bool
	When enabled, paint selection will not select components that are behind the surface in the current camera view.
popupMenuSelection / pms		bool
	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.
preSelectBackfacing / psb		bool
	When enabled preselection will highlight backfacing components whose normals face away from the camera.
preSelectClosest / psc		bool
	When enabled and the cursor is over a surface, preselection highlighting will try to preselect the closest component to the cursor regardless of distance.
preSelectDeadSpace / pds		int
	This value defines the size of the region around the cursor used for preselection highlighting when the cursor is outside the surface.
preSelectHilite / psh		bool
	When enabled, the closest component under the cursor will be highlighted to indicate that clicking will select that component.
preSelectHiliteSize / phs		float
	This value defines the size of the region around the cursor used for preselection highlighting. Within this region the closest component to the cursor will be highlighted.
preSelectSize / pss		int
preSelectTweakDeadSpace / pdt		int
	This value defines the size of the region around the cursor used for preselection highlighting when the cursor is outside the surface in tweak mode.
selectTypeChangeAffectsActive / stc		bool
selectionChildHighlightMode / sch		int
	Controls the highlighting of the children of a selected object. Valid modes are: 0: Always highlight children 1: Never highlight children 2: Use per-object Selection Child Highlightsetting. Default mode is (0): Always highlight children. For (2), each DAG object has an individual Selection Child Highlightboolean flag. By default, this flag will be TRUE. When mode (2) is enabled, the control is deferred to the selected object’s Selection Child Highlightflag.
singleBoxSelection / sbs		bool
	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.
straightLineDistance / sld		bool
trackSelectionOrder / tso		bool
	When enabled, the order of selected objects and components will be tracked. The ‘ls’ command will be able to return the active list in the order of selection which will allow scripts to be written that depend on the order.
useDepth / ud		bool
	When enabled, marquee selection will not select components that are behind the surface in the current camera view.
xformNoSelect / xns		bool
	Disable selection in xform tools Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.selectPref

Example:

import pymel.core as pm

pm.selectPref(popupMenuSelection=True,disableComponentPopups=True)