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