|
|
|
|
|
|
|
|
|
|
version 6.0 (Modified)
DISABLE BUTTON ({*; }object)
| Parameter | Type | Description | |
| * |  | If specified, object is an Object Name (String) | |
| If omitted, object is a Variable | |||
| object | Form Object | | Object Name (if * is specified), or |
| Variable (if * is omitted) |
Description
The command DISABLE BUTTON 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: It is not practical to use this command with an object that is assigned an automatic action, because 4D changes the state of the control when needed.
Examples
1. This example disables the button bValidate:
DISABLE BUTTON(bValidate)
2. This example disables all form objects that have names containing "btn":
DISABLE BUTTON(*;"@btn@")
3. See example for the command BUTTON TEXT.
See Also
|
|
|
|
|
|
|
|
|
|