4D v13.4
DISABLE BUTTON
- 4D Language Reference
-
- Object Properties
-
- Object Properties
- DISABLE BUTTON
- ENABLE BUTTON
- OBJECT DUPLICATE
- OBJECT Get auto spellcheckNew
- OBJECT GET BEST SIZE
- OBJECT Get choice list name
- OBJECT GET COORDINATES
- OBJECT GET DRAG AND DROP OPTIONSNew
- OBJECT Get enabled
- OBJECT Get enterable
- OBJECT Get filter
- OBJECT Get focus rectangle invisibleNew
- OBJECT Get font
- OBJECT Get font size
- OBJECT Get font style
- OBJECT Get format
- OBJECT Get help tipNew
- OBJECT Get horizontal alignment
- OBJECT Get keyboard layoutNew
- OBJECT Get plain text
- OBJECT GET RESIZING OPTIONSNew
- OBJECT GET RGB COLORS
- OBJECT GET SCROLL POSITION
- OBJECT GET SCROLLBAR
- OBJECT GET SHORTCUTNew
- OBJECT Get styled text
- OBJECT GET STYLED TEXT ATTRIBUTES
- OBJECT GET SUBFORM CONTAINER SIZENew
- OBJECT GET SUBFORMNew
- OBJECT Get title
- OBJECT Get vertical alignmentNew
- OBJECT Get visible
- OBJECT MOVE
- OBJECT SET AUTO SPELLCHECKNew
- OBJECT SET CHOICE LIST NAME
- OBJECT SET COLOR
- OBJECT SET DRAG AND DROP OPTIONSNew
- OBJECT SET ENABLED
- OBJECT SET ENTERABLE
- OBJECT SET FILTER
- OBJECT SET FOCUS RECTANGLE INVISIBLENew
- OBJECT SET FONT
- OBJECT SET FONT SIZE
- OBJECT SET FONT STYLE
- OBJECT SET FORMAT
- OBJECT SET HELP TIPNew
- OBJECT SET HORIZONTAL ALIGNMENT
- OBJECT SET KEYBOARD LAYOUTNew
- OBJECT SET PLAIN TEXT
- OBJECT SET RESIZING OPTIONSNew
- OBJECT SET RGB COLORS
- OBJECT SET SCROLL POSITION
- OBJECT SET SCROLLBAR
- OBJECT SET SHORTCUTNew
- OBJECT SET STYLED TEXT
- OBJECT SET STYLED TEXT ATTRIBUTES
- OBJECT SET SUBFORMNew
- OBJECT SET TITLE
- OBJECT SET VERTICAL ALIGNMENTNew
- OBJECT SET VISIBLE
DISABLE BUTTON
| DISABLE BUTTON ( {* ;} object ) | ||||||||
| Parameter | Type | Description | ||||||
| * | Operator |
|
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) | |||||
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.
Product: 4D
Theme: Object Properties
Number:
193
Modified: 4D 2004.1
Modified: 4D v12
ENABLE BUTTON
OBJECT SET ENABLED
OBJECT SET TITLE
