The DISABLE BUTTON command is declared obsolete in 4D beginning with version 12 and is kept only for compatibility reasons. Its overall scope, which includes all instances of the designated variable and not only those of the current form, does not correspond to those of the "Object Properties" command theme.
DISABLE BUTTON can be replaced favorably by the OBJECT SET ENABLED command.
The DISABLE BUTTON command disables the form objects specified by object.
A disabled button or object does not react to mouse clicks and shortcuts, and is displayed dimmed or grayed out.
Note: Disabling a button or an object does not prevent you from changing its value programmatically.
If you specify the optional * parameter, you indicate an object name (a string) in object. If you omit the optional * parameter, you indicate a field or a variable in object. In this case, you specify a field or variable reference (field or variable objects only) instead of a string. For more information about object names, see the section Object Properties.
This command (despite what its name suggests) can be applied to the following types of object:
- Button, Default Button, 3D Button, Invisible Button, Highlight Button
- Radio Button, 3D Radio Button, Radio Picture
- Check Box, 3D Check Box
- Pop-up menu, Drop-down List, Combo Box, Menu/Drop-down list
- Thermometer, Ruler
Note: This command has no effect with an object that is assigned an automatic action (4D changes the state of the control when needed), except for Validate and Cancel actions.
This example disables the button bValidate:
DISABLE BUTTON(bValidate)
This example disables all form objects that have names containing “btn”:
DISABLE BUTTON(*;"@btn@")
See example for the command OBJECT SET TITLE.