| **Navigation:**  [[introduction.htm|Language Reference]] > 13 - Built-in Functions >====== DISABLE (dim a control) ====== | [[directory  get file directory .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[display  write use variables to screen .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

{{newc7.jpg|NewC7.jpg}}

**DISABLE(**// //[ //first control// ] [,// last control //] **)**

{{blk2blue.jpg|blk2blue.jpg}}

| **DISABLE** | Dims controls on the window. |
| //first control// | Field number or field equate label of a control, or the first control in a range of controls. If omitted, defaults to zero (0). |
| //last control// | Field number or field equate label of the last control in a range of controls. |

The **DISABLE** statement disables a control or a range of controls on an APPLICATION or WINDOW structure. When disabled, the control appears dimmed on screen.

**Example:**

**Screen WINDOW,PRE(Scr)**

**        ENTRY(@N3),USE(Ctl:Code)**

**        ENTRY(@S30),USE(Ctl:Name)**

**        BUTTON('OK'),USE(?OkButton),KEY(EnterKey)**

**        BUTTON('Cancel'),USE(?CanxButton),KEY(EscKey)**

**       END**

** CODE**

** OPEN(Screen)**

** DISABLE(?Ctl:Code)        !Disable a control**

** DISABLE(?Ctl:Code,?Ctl:Name)    !Disable range of controls**

** DISABLE(2)             !Disable the second control**

**See Also:**

[[enable  re activate dimmed control .htm|ENABLE]]

[[hide  blank a control .htm|HIDE]]

[[unhide  show hidden control .htm|UNHIDE]]