disabledIcon

Specifies an image to display in a button when the button is disabled.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.1 Security:

# Syntax

set the disabledIcon of button to {imageID | imageName}

# Examples

set the disabledIcon of button "Boss Key" to "Innocent Spreadsheet"

# Description

Use the disabledIcon property to change a button appearance when it is disabled.

When the button's enabled property is set to false, the disabledIcon is displayed within the button rectangle.

If a button's showIcon property is false, the setting of its disabledIcon property has no effect.

# Tags

ui,

# See

- **keyword:** image, button - **property:** ID, name - **command:** disable - **function:** stacks - **glossary:** property, current stack - **object:** button