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 isundef
. -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 non-visible.