iwidgets2.2.0 User Commands - messagedialog
NAME
     messagedialog -  Create  and  manipulate  a  message  dialog
     widget
SYNOPSIS
     messagedialog pathName ?options?
INHERITANCE
     itk::Toplevel <- Shell <-  Dialogshell  <-  Dialog  <-  Mes-
     sagedialog
STANDARD OPTIONS
     anchor          background     bitmap          cursor
     font            foreground     image           justify
     text            wrapLength
     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       title
     See the "shell" 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  message
          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 accept-
          able to Tk_GetPixels.
     Name:           textPadY
     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 accept-
          able to Tk_GetPixels.
DESCRIPTION
     The messagedialog command creates a message dialog composite
     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 vari-
     ous operations on the widget.  It has the following  general
     form:
          pathName option ?arg arg ...?
     Option and the args determine the exact behavior of the com-
     mand.  The following commands are possible for messagedialog
     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.
     pathName configure ?option? ?value option value ...?
          Query  or  modify  the  configuration  options  of  the
          widget.   If  no  option  is  specified, returns a list
          describing all of the available  options  for  pathName
          (see  Tk_ConfigureInfo for information on the format of
          this list).  If option is specified with no value, then
          the  command  returns  a  list describing the one named
          option (this list will be identical to the  correspond-
          ing  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  mes-
          sage  dialog.   See the "label" widget manual entry for
          details on the image component item.
     Name:           msg
     Class:          Label
          The msg component provides the textual portion  of  the
          message  dialog.   See  the "label" widget manual entry
          for details on the msg component item.
EXAMPLE
           #
           # Standard question message dialog used for confirmation.
           #
           messagedialog .md -title "Message Dialog" -text "Are you sure ?" \
                          -bitmap questhead -modality global
           .md hide Help
           .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"
           }
           destroy .md
           #
           # 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 Apply
           .cr hide Cancel
           .cr hide Help
           .cr activate
           after 10000 ".cr deactivate"
AUTHOR
     Mark L. Ulferts
KEYWORDS
     messagedialog, dialog, dialogshell, shell, widget