Itcl Message Box Widget

The msgbox widget class provides a simple pop-up dialog which displays a text message and an optional bitmap, and allows the user to pop-down the dialog-box by clicking on a button.

Synopsis

msgbox pathName ?options?
create a new message box widget named pathName.
pathName option ?args...?
manipulate the message box widget named pathName.

Options

The msgbox class provides the same options as the dialog class, and additionally:

Name: text
Class: Text
Command-Line Switch: -text
Default: ""
The text of the message to be displayed.

Name: bitmap
Class: Bitmap
Command-Line Switch: -bitmap
Default: ""
The bitmap to be displayed to the left of the message. If set to the epmty string (the default), no bitmap is displayed.

Name: foreground
Class: Foreground
Command-Line Switch: -foreground
Default: black
The foreground colour of the text, button-text and bitmap.

Name: background
Class: Background
Command-Line Switch: -background
Default: #ccc
The background colour of the sub-widgets in the dialog box.

Name: relief
Class: Relief
Command-Line Switch: -relief
Default: raised
The 3D relief of the frames used to separate the button from the text and bitmap.

Name: borderWidth
Class: BorderWidth
Command-Line Switch: -borderwidth
Default: 1
The border-width of the frames used to separate the button from the text and bitmap.

Name: buttonText
Class: ButtonText
Command-Line Switch: -button
Default: Ok
The label of the button used to pop down the dialog box.

Name: aspect
Class: Aspect
Command-Line Switch: -aspect
Default: 500
The aspect of the message widget used to display the text of the dialog box.

Name: font
Class: Font
Command-Line Switch: -font
Default: -Adobe-Helvetica-Bold-R-Normal--*-120-*
The font in which the message is drawn.

Name: buttonFont
Class: Font
Command-Line Switch: -buttonfont
Default: -Adobe-Helvetica-Bold-R-Normal--*-120-*
The font in which the button's label is drawn.

Widget Command

The msgbox class provides the same operations as the dialog class:

pathName configure ?options...?
Configure the widget.

pathName center ?window?
Center the dialog relative to the given window. If no window is given, the dialog is centered relative to the root window.


Nat Pryce (np2@doc.ic.ac.uk)