Pmw.MegaToplevel() - base class for megawidgets within a toplevel
This class creates a megawidget contained within a toplevel window. It may be used directly to create a toplevel megawidget or it may be used as a base class for more specialised toplevel megawidgets, such as Pmw.Dialog. It creates a Tkinter.Toplevel component, named hull, to act as the container of the megawidget. The window class name for the hull widget is set to the most-specific class name for the megawidget. Derived classes specialise this widget by creating other widget components as children of the hull widget.
The megawidget may be used as either a normal toplevel window or
as a modal dialog. Use
withdraw() for normal use
deactivate() for modal dialog use. If the
window is deleted by the window manager while being shown
normally, the default behaviour is to destroy the window. If the
window is deleted by the window manager while the window is active
(ie: when used as a modal dialog), the window is deactivated.
usermodaldeletefunc() methods to
override these behaviours. Do not call
protocol() to set the
WM_DELETE_WINDOW window manager protocol directly if you want to
use this window as a modal dialog.
The currently active windows form a stack with the most recently activated window at the top of the stack. All mouse and keyboard events are sent to this top window. When it deactivates, the next window in the stack will start to receive events.
activate(). The default is None.
deactivate(). The default is None.
activate()method to control whether the window is made transient during modal dialogs. See the
activate()method. The default is None.
If the BLT extension to Tk is present, a busy cursor will be
displayed on other toplevel windows, using
activate() method does not return until the
method is called, when the window is withdrawn, the grab released
and the result returned.
If globalMode is false, the window will grab control of the pointer and keyboard, preventing any events from being delivered to any other toplevel windows within the application. If globalMode is true, the grab will prevent events from being delivered to any other toplevel windows regardless of application. Global grabs should be used sparingly, if at all.
If globalMode is 'nograb', then no grab is performed. If BLT
is present, this will allow mouse and keyboard events to be
received by other windows whose exclude busycursor attribute has
been set to true by a call to
Note that if 'nograb' is used and BLT is not present, then all
other windows will receive mouse and keyboard events. This is
because, in plain Tk, there is no way to specify that two windows
(only) receive events. If your application may be used without
BLT, then do not use 'nograb'.
When the window is displayed, it is positioned on the screen according to geometry which may be one of:
geometry = first+100+100will initially display the window at position (100,100). Other calls to
activate()will not change the previous position of the window.
If the BLT Tcl extension library is present, a clock cursor will be displayed until the window is deactivated.
If the activatecommand option is callable, it is called just before the window begins to wait for the result.
If the master option is not None, the window will become a transient window of master, which should be a toplevel window. If master has the special value of 'parent', the master is the toplevel window of the window's parent.
activate()is currently waiting for a result to be passed to it by a call to
activate()is waiting. It will withdraw the window, release the grab and cause the
activate()call to return with the value of result.
If the deactivatecommand option is callable, it is called just
deactivate() method returns.
show()will not move the window, whereas calling
deiconify()may change the window's position. (This may depend on the behaviour of the window manager.)
12 May 2000
Manual page last reviewed: 22 May 1998