The Toplevel Widget

Create a toplevel widget, displayed independently from the main window with the same decoration as the window system, using the Toplevel method.

The standard configuration options that apply to Toplevel are: -background, -bg, -borderwidth, -bw, -cursor, -height, -highlightbackground, -highlightcolor, -highlightthickness, -relief, -takefocus, and -width.

Other options are:

  • -class => name
  • The class associated with the Toplevel widget.
  • -colormap => $window
  • Specifies another window to share the colormap with. You can point to another window or use the value new to specify a new colormap. Default is undef.
  • -screen => screen
  • The screen to place the toplevel widget on.
  • -visual => type n
  • For the X Window System, changes the depth of colors.

Toplevel Methods

In addition to cget and configure, the following methods are supported by the Toplevel widget. Note that since the MainWindow is a Toplevel widget, each of these methods applies to the MainWindow as well.

  • aspect
  • Returns the constraints to the aspect of the window. The four-item list returned corresponds to the minimum width, the minimum height, the maximum width, and the maximum height.
  • client
  • Assigns a name to the toplevel window.
  • colormapwindows
  • For the X Window System, passes a list of windows to the window manager that have private colormaps. Controls the WM_COLORMAP_WINDOWS property.
  • command
  • For the X Window System, returns the command used to start the application.
  • deiconify
  • Displays an iconified window.
  • focusmodel
  • Gives up the keyboard focus to another window.
  • frame
  • Returns the ID of the parent widget as a hexadecimal string.
  • geometry
  • For the X Window System, gets the geometry of the Toplevel widget.
  • grid
  • Changes the size of the Toplevel's grid.
  • group
  • Makes the widget the group leader of a set of related windows.
  • iconbitmap
  • Identifies a bitmap to use as an icon when the window is iconified.
  • iconify
  • Iconifies the window.
  • iconmask
  • Specifies a mask for the icon bitmap.
  • iconname
  • Assigns text to be associated with the icon.
  • iconposition
  • Specifies a position for the icon on the desktop.
  • iconwindow
  • Specifies a widget to use in place of an icon when iconified.
  • maxsize
  • Specifies the largest size for the window.
  • minsize
  • Specifies the smallest size for the window.
  • overrideredirect
  • Removes window decorations from the window.
  • positionfrom
  • Returns either program or user to tell you whether the user or window manager requested its current position.
  • protocol
  • Given one of the window managers WM_DELETE_WINDOW, WM_SAVE_YOURSELF, or WM_TAKE_FOCUS, allows you to define a callback to execute when an associated event is detected.
  • resizable
  • Takes Boolean values representing whether the window can be resized in width and height, respectively.
  • sizefrom
  • Returns either program or user to tell you whether the user or window manager requested its current size.
  • state
  • Returns normal, iconic, or withdrawn, indicating the current state of the window.
  • title
  • Changes the title at the top of the window.
  • transient
  • Indicates to the window manager that the window is transient.
  • withdraw
  • Makes the window nonvisible.