DESTROY (remove a control)

Top  Previous  Next

 

DESTROY( [ first control ] [, last control ] )

DESTROY

Removes window controls.

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 DESTROY statement removes a control, or range of controls, from an APPLICATION or WINDOW structure. When removed, the control's resources are returned to the operating system.

DESTROYing a GROUP, OPTION, MENU, TAB, or SHEET control also destroys all controls contained within it.

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)

DESTROY(?Ctl:Code)              !Remove a control

DESTROY(?Ctl:Code,?Ctl:Name)    !Remove range of controls

DESTROY(2)                      !Remove the second control

 

See Also:

CREATE