Syntax
'DESTROY'(0)
Description
The 'DESTROY' mnemonic destroys all graphical elements in the current
context. All contexts are initially empty, or clear, and contain no window
and graphical elements that must reside inside of a window. To restore
a context to a clear state (destroying the context's window and any of
its contents), issue the 'DESTROY'(0) mnemonic after selecting the context.
Any context may be reused as many times as desired in this way.
The number 0 in 'DESTROY'(0) is used because many of the mnemonics that
work with the SYSGUI device use an ID parameter to operate on an element
inside a window, such as a control or a child window. In some cases, the
ID parameter can also be used to represent menu items. For most mnemonics,
the number 0 is used as a shorthand for the window itself. For example,
'DESTROY'(1) would destroy whatever element inside the window has the
ID of 1, while 'DESTROY'(0) would destroy the window and all of its contents.
Issuing 'DESTROY'(0) in a context that is already empty does not cause
an error, but it has no effect.
|
Parameter |
Description |
|
(0) |
An ID for the window itself and not what is inside the window. DESTROY(0) destroys the window. |