18.18 The Toplevel Widget (Perl in a Nutshell)

18.18 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.

18.18.1 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.


18.17 The Frame Widget		VIII. Win32