destroy manual page - Built-In Commands

## Tcl/Tk Documentation > Tk Commands, version 8.6.18 > destroy

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

### NAME

destroy — Destroy one or more windows

### SYNOPSIS

destroy ?window window ...?

### DESCRIPTION

This command deletes the windows given by the window arguments, plus all of their descendants. If a window “.” is deleted then all windows will be destroyed and the application will (normally) exit. The windows are destroyed in order, and if an error occurs in destroying a window the command aborts without destroying the remaining windows. No error is returned if window does not exist.

### EXAMPLE

Destroy all checkbuttons that are direct children of the given widget:

    proc killCheckbuttonChildren {parent} {
       foreach w [winfo children $parent] {
          if {[winfo class $w] eq "Checkbutton"} {
             destroy $w
          }
       }
    }

### KEYWORDS

application, destroy, window
Copyright © 1990 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.