Main Toolbar

The following methods are associated with 3ds Max’s main toolbar:

Methods

enableUndo <boolean>

Enables or disables the Undo icon.

In 3ds Max 2010 and higher, the Undo icons are no longer on the Main Toolbar, but are still affected by this method. When the argument is false, the Undo and Redo icons will cause no action if pressed.

hitByNameDlg()

Opens the standard 3ds Max Select By Name dialog allowing users to select objects.

Returns false if the user cancels out of the Select by Name dialog, true otherwise.

See also Picking Scene Nodes by Name for a MAXScript method with more control over the filtering and display of the dialog.

toolMode.uniformScale()

Set scale mode to Uniform Scale.

toolMode.nonUniformScale()

Set scale mode to Non-uniform Scale.

toolMode.squashScale()

Set scale mode to Squash.

toolMode.coordsys { <mode_name> | <node> }

Sets the Reference Coordinate System.

Providing a node as argument is equivalent to using the "Pick" option of the drop-down list in the UI.

Valid <mode_name> values are:

Name	Notes
#view	View Reference Coordinate System
#screen	Screen Reference Coordinate System
#world	World Reference Coordinate System
#parent	Parent Reference Coordinate System
#gimbal	Gimbal Reference Coordinate System
#local	Local Reference Coordinate System
#grid	Grid Reference Coordinate System
#working_pivot	Working Pivot Reference Coordinate System

getRefCoordSys() setRefCoordSys <mode_name>

Get and set the Reference Coordinate System.

Valid <mode_name> values are:

Name	Notes
#hybrid	View
#screen	Screen
#world	World
#parent	Parent
#local	Local
#object	Pick object or Grid - not valid for setRefCoordSys()

enableRefCoordSys <boolean>

Enables or disables the Reference Coordinate System drop-down list.

getCoordCenter() setCoordCenter <name>

Get and set the Coordinate System Center.

Valid <name> values are:

Name	Notes
#local	Use Pivot Point Center
#selection	Use Selection Center
#system	Use Transform Coordinate Center

enableCoordCenter <boolean>

Enables or disables the Coordinate System Center icon.

toolMode.pivotCenter()

Sets Coordinate System Center to Pivot Point Center.

toolMode.selectionCenter()

Sets Coordinate System Center to Selection Center.

toolMode.transformCenter()

Sets Coordinate System Center to Transform Coordinate Center.

getNumAxis()

This method reflects the Coordinate System Center state.

If it is set to Pivot Point Center then this method returns #individual otherwise #all .

setToolBtnState <name> <boolean>

Set the specified tool buttons on or off.

This method does not put into the mode, it just changes the state of the tool button.

This method does not change the state of any button other than the specified button.

To set the actual tool mode, please see toolmode.commandmode

The valid <name> values are:

Name	Notes
#select	Select button on/off
#move	Move button on/off
#rotate	Rotate button on/off
#uscale	Scale button on/off - doesn’t change scale type
#nuscale	Scale button on/off - doesn’t change scale type
#squash	Scale button on/off - doesn’t change scale type

getToolbtnState <name>

Returns whether the specified tool button is on or off as a <boolean> value.

To get the actual tool mode, please see toolmode.commandmode

Valid <name> values are:

Name	Notes
#select	Returns True if the Select button is on
#move	Returns True if the Move button is on
#rotate	Returns True if the Rotate button is on
#uscale	Returns True if any of the Scale button states is on
#nuscale	Returns True if any of the Scale button states is on
#squash	Returns True if any of the Scale button states is on

The following methods deal with the Named Selection Set drop-down list. These methods are not intended for casual usage.

clearCurSelSet()

Clears the edit field of the Named Selection Set drop-down list.

Does not deselect the currently selected objects.

clearSubSelSets()

Clears the named selections from the Named Selection Set drop-down list.

The named selection sets still exist, they just don’t show in the drop-down list.

This command can be dangerous to use unless you are in Sub-Object mode in the Modify panel, as there is not a direct method to rebuild the Named Selection Set list.

When in Sub-Object mode in the Modify panel, the namedSelSetListChanged() method will rebuild the list.

namedSelSetListChanged()

When in Sub-Object mode in the Modify panel, this method will rebuild the named selection set list.

setCurNamedSelSet <string>

Sets the edit field of the Named Selection Set drop-down list to the specified string.

This method not change the current selection set or add the specified string to the named selection set list.

appendSubSelSet <string>

Appends the specified string to the Named Selection Set drop-down list.

This method not change the current selection set.

Modifiers in 3ds Max use this method to add sub-object named selection sets to the Named Selection Set drop-down list.

This is done whenever the selection level changes.

The following 3ds Max system global variables are associated with the Main Toolbar:

preferences.constantReferenceSystem

Lets you get and set whether to use a constant Reference System for the Move, Rotate, and Scale tools.

A Boolean value - true if Constant is on, false if off.

This variable matches the Constant check box in Customize menu > Preferences > General > Reference Coordinate System.

toolmode.commandmode

Get/set the 3ds Max command mode.

The value of the command mode is a <name> value if the command mode is a recognized command mode, otherwise the return value is an integer value.

The recognized command modes are:

Name
#SELECT
#MOVE
#ROTATE
#NUSCALE
#USCALE
#SQUASH
#VIEWPORT
#HIERARCHY
#CREATE
#MODIFY
#MOTION
#ANIMATION
#CAMERA
#NULL
#DISPLAY
#SPOTLIGHT
#PICK

When setting the 3ds Max command mode, only the following command modes are valid:

Name
#SELECT
#MOVE
#ROTATE
#NUSCALE
#USCALE
#SQUASH

toolmode.commandmodeID

Get the 3ds Max command mode as Integer ID.

Read-only.

Possible values are:

1 - Move

2 - Rotate

3 - Non-Uniform Scale

4 - Uniform Scale

5 - Squash Scale

6 - Select

toolmode.axisConstraints

Get/set the 3ds Max axis constraints.

The axis constraints values are:

Name
#X
#Y
#Z
#XY
#YZ
#ZX

toolMode.coordSysNode

A read/write variable containing a node value or undefined.

This variable reflects which node, if any, is the current reference coordinate system node.

Assignment to this variable must be a node value.

manipulateMode

Get/set the 3ds Max manipulate mode. When true , manipulate mode is active.

The following method affects all toolbars.

updateToolbarButtons()

Forces an update of all toolbar button states.

Main Toolbar

See Also