NAME
messagedialog - Create and manipulate a message dialog
widget
SYNOPSIS
messagedialog pathName ?options?
INHERITANCE
itk::Toplevel <- Shell <- Dialogshell <- Dialog <- Mes
sagedialog
STANDARD OPTIONS
background bitmap cursor font
foreground image text
See the "options" manual entry for details on the standard
options.
INHERITED OPTIONS
buttonBoxPadX buttonBoxPadY buttonBoxPos padX
padY separator thickness
See the "dialogshell" widget manual entry for details on
the above inherited options.
master modality
See the "shell" widget manual entry for details on the
above inherited options.
title
See the "Toplevel" widget manual entry for details on the
above inherited options.
WIDGET-SPECIFIC OPTIONS
Name: imagePos
Class: Position
Command-Line Switch: -imagepos
Specifies the image position relative to the mes
sage text: n, s, e, or w. The default is w.
Name: textPadX
Class: Pad
Command-Line Switch: -textpadx
Specifies a non-negative value indicating how much
extra space to request for the message text in the
X direction. The value may have any of the forms
acceptable to Tk_GetPixels.
Class: Pad
Command-Line Switch: -textpady
Specifies a non-negative value indicating how much
extra space to request for the message text in the
X direction. The value may have any of the forms
acceptable to Tk_GetPixels.
_________________________________________________________________
DESCRIPTION
The messagedialog command creates a message dialog compos
ite widget. The messagedialog is derived from the Dialog
class and is composed of an image and associated message
text with commands to manipulate the dialog buttons.
METHODS
The messagedialog command creates a new Tcl command whose
name is pathName. This command may be used to invoke var
ious operations on the widget. It has the following gen
eral form:
pathName option ?arg arg ...?
Option and the args determine the exact behavior of the
command. The following commands are possible for message
dialog widgets:
INHERITED METHODS
add buttonconfigure defaulthide
insert invoke show
See the "buttonbox" widget manual entry for details on the
above inherited methods.
childsite
See the "dialogshell" widget manual entry for details on
the above inherited methods.
activate center deactivate
See the "dialogshell" widget manual entry for details on
the above inherited methods.
WIDGET-SPECIFIC METHODS
pathName cget option
Returns the current value of the configuration
option given by option. Option may have any of the
values accepted by the messagedialog command.
Query or modify the configuration options of the
widget. If no option is specified, returns a list
describing all of the available options for path
Name (see Tk_ConfigureInfo for information on the
format of this list). If option is specified with
no value, then the command returns a list describ
ing the one named option (this list will be identi
cal to the corresponding sublist of the value
returned if no option is specified). If one or
more option-value pairs are specified, then the
command modifies the given widget option(s) to have
the given value(s); in this case the command
returns an empty string. Option may have any of
the values accepted by the messagedialog command.
COMPONENTS
Name: image
Class: Label
The image component is the bitmap or image of the
message dialog. See the "label" widget manual
entry for details on the image component item.
Name: message
Class: Label
The message component provides the textual portion
of the message dialog. See the "label" widget man
ual entry for details on the message component
item.
EXAMPLE
#
# Standard question message dialog used for confirmation.
#
messagedialog .md -title "Message Dialog" -text "Are you sure ?" \
-bitmap questhead -modality global
.md buttonconfigure OK -text Yes
.md buttonconfigure Cancel -text No
if {[.md activate]} {
.md configure -text "Are you really sure ?"
if {[.md activate]} {
puts stdout "Yes"
} else {
puts stdout "No"
}
} else {
puts stdout "No"
}
#
# Copyright notice with automatic deactivation.
#
messagedialog .cr -title "Copyright" -bitmap @dsc.xbm -imagepos n \
-text "Copyright 1995 DSC Communications Corporation\n \
All rights reserved"
.cr hide Cancel
.cr activate
after 10000 ".cr deactivate"
AUTHOR
Mark L. Ulferts
KEYWORDS
messagedialog, dialog, dialogshell, shell, widget
Man(1) output converted with
man2html