Command: wdelete

Syntax

wdelete <window> {,<window> ... }

Description

Delete one or more open windows. Deleting a window removes it from view and deletes all associated data. The window then becomes free to be used for another purpose.

Parameters

• <window>
  The window tone deleted.

Switches

• -all
  Delete all windows.

Notes

If the window is not currently in use, no action is taken.

A window can also be deleted by window manager mouse action.

A delete procedure (window.delete) may be defined for a window. This will be executed automatically before window deletion. When such a procedure exists, wdelete must be called within it for the window to be actually removed.

When a top-level window is deleted, all user-defined window identifiers which reference it and any of its sub-windows are set to null. This is not true when just a subwindow is specifically deleted without its parent.

Examples

Delete one window (specifically by number).

wdelete win1

Delete two windows by name.

wdelete my_wina, my_winb

Delete a window. References to it are nullified.

window mywin = win1
tell mywin; # Will display "win1"
wdelete win1
tell mywin; # Will display "null"

See Also