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

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

SYNOPSIS
       iiwwiiddggeettss::::mmeessssaaggeeddiiaalloogg pathName ?options?

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

SSTTAANNDDAARRDD OOPPTTIIOONNSS
       bbaacckkggrroouunndd      bbiittmmaapp         ccuurrssoorr          ffoonntt
       ffoorreeggrroouunndd      iimmaaggee          tteexxtt

       See the "options" manual entry for details on the standard options.

IINNHHEERRIITTEEDD OOPPTTIIOONNSS
       bbuuttttoonnBBooxxPPaaddXX   bbuuttttoonnBBooxxPPaaddYY  bbuuttttoonnBBooxxPPooss    ppaaddXX
       ppaaddYY            sseeppaarraattoorr      tthhiicckknneessss

       See  the  "dialogshell"  widget  manual  entry for details on the above
       inherited options.

       mmaasstteerr          mmooddaalliittyy

       See the "shell" widget manual entry for details on the above  inherited
       options.

       ttiittllee

       See  the "Toplevel" widget manual entry for details on the above inher-
       ited options.


WWIIDDGGEETT-SSPPEECCIIFFIICC OOPPTTIIOONNSS
       Name:           iimmaaggeePPooss
       Class:          PPoossiittiioonn
       Command-Line Switch:           -iimmaaggeeppooss

              Specifies the image position relative to the message text: nn, ss,
              ee, or ww.  The default is w.

       Name:           tteexxttPPaaddXX
       Class:          PPaadd
       Command-Line Switch:           -tteexxttppaaddxx

              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:           tteexxttPPaaddYY
       Class:          PPaadd
       Command-Line Switch:           -tteexxttppaaddyy

              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  iiwwiiddggeettss::::mmeessssaaggeeddiiaalloogg 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.


MMEETTHHOODDSS
       The iiwwiiddggeettss::::mmeessssaaggeeddiiaalloogg 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:


IINNHHEERRIITTEEDD MMEETTHHOODDSS
       aadddd             bbuuttttoonnccoonnffiigguurree                ddeeffaauulltthhiiddee
       iinnsseerrtt          iinnvvookkee         sshhooww

       See the "buttonbox" widget manual entry for details on the above inher-
       ited methods.

       cchhiillddssiittee

       See the "dialogshell" widget manual entry  for  details  on  the  above
       inherited methods.

       aaccttiivvaattee        cceenntteerr         ddeeaaccttiivvaattee

       See  the  "dialogshell"  widget  manual  entry for details on the above
       inherited methods.

WWIIDDGGEETT-SSPPEECCIIFFIICC MMEETTHHOODDSS
       pathName ccggeett option
              Returns the current value of the configuration option  given  by
              option.  Option may have any of the values accepted by the iiwwiidd-
              ggeettss::::mmeessssaaggeeddiiaalloogg command.

       pathName ccoonnffiigguurree ?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 TTkkCCoonnffiigguurreeIInnffoo 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 iiwwiiddggeettss::::mmeessssaaggeeddiiaalloogg command.


CCOOMMPPOONNEENNTTSS
       Name:           iimmaaggee
       Class:          LLaabbeell

              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:           mmeessssaaggee
       Class:          LLaabbeell

              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.


EEXXAAMMPPLLEE
               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

KKEEYYWWOORRDDSS
       messagedialog, dialog, dialogshell, shell, widget



Tk                                                  iwidgets::messagedialog(1)