|
|
|
|
|
|
|
|
|
|
version 2004.1 (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 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.
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
|
|
|
|
|
|
|
|
|
|