iwidgets::messagedialog(1)      [incr Widgets]      iwidgets::messagedialog(1)





NAME
       iwidgets::messagedialog - Create and manipulate a message dialog widget

SYNOPSIS
       iwidgets::::messagedialog pathName ?options?

INHERITANCE
       itk::Toplevel <-  iwidgets::Shell  <-  iwidgets::Dialogshell  <-  iwid-
       gets::Dialog <- iwidgets::Messagedialog

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 inher-
       ited 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 acceptable to TkGetPixels.

       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 acceptable to TkGetPixels.




DESCRIPTION
       The  iwidgets::::messagedialog command creates a message dialog composite
       widget.  The messagedialog is derived from the Dialog class and is com-
       posed  of an image and associated message text with commands to manipu-
       late the dialog buttons.


METHODS
       The iwidgets::::messagedialog command creates a  new  Tcl  command  whose
       name  is  pathName.   This command may be used to invoke various opera-
       tions on the widget.  It has the following general form:

              pathName option ?arg arg ...?

       Option and the args determine the exact behavior of the  command.   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 inher-
       ited 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 iwid-
              gets::::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 avail-
              able options for pathName (see TkConfigureInfo 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 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 iwidgets::::messagedialog command.


COMPONENTS
       Name:           image
       Class:          Label

              The image component is the bitmap or image of the  message  dia-
              log.   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  mes-
              sage dialog.  See the "label" widget manual entry for details on
              the message component item.


EXAMPLE
               package require Iwidgets 4.0
               #
               # Standard question message dialog used for confirmation.
               #
               iwidgets::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"
               }

               destroy .md

               #
               # Copyright notice with automatic deactivation.
               #
               iwidgets::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



Tk                                                  iwidgets::messagedialog(1)