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



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

displayAffected is undoable, queryable, and NOT editable.

Turns on/off the special coloring of objects that are affected by the objects that are currently in the selection list.

If one of the curves in a loft were selected and this feature were turned on, then the lofted surface would be highlighted because it is affected by the loft curve.

Return value


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


currentUnit, displayColor, displayCull, displayLevelOfDetail, displayPref, displayRGBColor, displaySmoothness, displayStats, displaySurface, hide, refresh, showHidden, toggle

Python examples

import maya.cmds as cmds

# Turn on the display of affected objects
cmds.displayAffected( True )

# Query whether the display of affected objects is turned on:
cmds.displayAffected( query=True )