disabled

Typeproperty
DictionaryLCS
LibraryLiveCode Script
Syntax
set the disabled of <object> to {true | false}
Associationsfield, button, graphic, scrollbar, player, image, group
Summary

Specifies that an object is dimmed and does not respond to user action.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
set the disabled of button "Destroy Everything" to true
set the disabled of menu "View" to true
Values
NameTypeDescription
Value

The disabled of a control is true or false. By default, the disabled property of newly created controls is false.

RelatedKeyword: control, menu
Property: enabled
Message: mouseUp, mouseEnter
Command: disable, group, enable menu, send
Function: menus
Glossary: object, property, message, trigger, command, menu item, menu
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.

Setting a group's disabled property sets the disabled of each control in the group.

You can set the disabled property of a menu by specifying the menu's 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's enabled property. When the enabled is true, the disabled is false, and vice versa.

Tagsui