Specifies that an object is dimmed and does not respond to user action.
# Metadata
Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:
# Syntax
set the disabled of object to {true | false}
# Examples
set the disabled of button "Destroy Everything" to true
set the disabled of menu "View" to true
# Description
Use the disabled property to find out whether a control can respond to mouse clicks or keyboard presses.
Disabled buttons are drawn with gray borders and text to indicate that they cannot be clicked. Controls whose disabled property is true do not trigger messages such as mouseUp or mouseEnter, but they can respond to messages sent with the send command. If a disabled control is on top of an enabled control, the disabled control is transparent to clicks, and clicking sends the appropriate messages to the enabled control underneath.
A disabled control cannot receive the focus.
You can set the disabled property of a menu by specifying the menu name or number. menu items in disabled menus are drawn in gray text and cannot be chosen.
The disabled property of an object is the logical inverse of that object enabled property. When the enabled is true, the disabled is false, and vice versa.
# Tags
ui,
# See