Go to: Synopsis. Return value. Flags. Python examples.


whatsNewHighlight([highlightColor=[float, float, float]], [highlightOn=boolean], [showStartupDialog=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

whatsNewHighlight is undoable, queryable, and NOT editable.

This command is used to toggle the What's New highlighting feature, and the display of the settings dialog for the feature that appears on startup.

Return value


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


highlightColor, highlightOn, showStartupDialog
Long name (short name) Argument types Properties
highlightOn(ho) boolean createquery
Toggle the What's New highlighting feature. When turned on, menu items and buttons introduced in the latest version will be highlighted.
highlightColor(hc) [float, float, float] createquery
Set the color of the What's New highlight. The arguments correspond to the red, green, and blue color components. Each color component ranges in value from 0.0 to 1.0.
showStartupDialog(ssd) boolean createquery
Set whether the settings dialog for this feature appears on startup.

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.

Python examples

import maya.cmds as cmds

#    Turn on What's New highlighting if not already on.
if not cmds.whatsNewHighlight(query=True, highlightOn=True):

#    Turn off What's New highlighting startup dialog if it is set to appear.
if cmds.whatsNewHighlight(query=True, showStartupDialog=True):