4D v14.3

DISABLE BUTTON

Home

 
4D v14.3
DISABLE BUTTON

DISABLE BUTTON 


 

DISABLE BUTTON ( {* ;} object ) 
Parameter Type   Description
Operator in If specified, object is an Object Name (String) If omitted, object is a Variable
object  Form object in 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.

 
PROPERTIES 

Product: 4D
Theme: Objects (Forms)
Number: 193

This command is deprecated and should not be used anymore

 
HISTORY 

Modified: 4D 2004.1
Modified: 4D v12

 
SEE ALSO 

ENABLE BUTTON
OBJECT SET ENABLED
OBJECT SET TITLE

 
ARTICLE USAGE

4D Language Reference ( 4D v12.4)
4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)

Inherited from : DISABLE BUTTON ( 4D v11 SQL Release 6)