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

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

SYNOPSIS
       iiwwiiddggeettss::::ddiiaalloogg pathName ?options?

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

SSTTAANNDDAARRDD OOPPTTIIOONNSS
       bbaacckkggrroouunndd      ccuurrssoorr         ffoorreeggrroouunndd

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

IINNHHEERRIITTEEDD OOPPTTIIOONNSS
       bbuuttttoonnBBooxxPPaaddXX   bbuuttttoonnBBooxxPPaaddYY  bbuuttttoonnBBooxxPPooss    ppaaddXX
       ppaaddYY            sseeppaarraattoorr      tthhiicckknneessss

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

       hheeiigghhtt          mmaasstteerr         mmooddaalliittyy        wwiiddtthh

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

       ttiittllee

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



DESCRIPTION
       The  iiwwiiddggeettss::::ddiiaalloogg  command  creates a dialog box providing standard
       buttons and a child site for  use  in  derived  classes.   The  buttons
       include ok, apply, cancel, and help.  Methods and Options exist to con-
       figure the buttons and their containing box.


MMEETTHHOODDSS
       The iiwwiiddggeettss::::ddiiaalloogg command creates a new Tcl command  whose  name  is
       pathName.  This command may be used to invoke various operations 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 dialog widgets:

IINNHHEERRIITTEEDD MMEETTHHOODDSS
       aadddd             bbuuttttoonnccoonnffiigguurree                ddeeffaauulltthhiiddee
       iinnddeexx           iinnsseerrtt         iinnvvookkee          sshhooww

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

       cchhiillddssiittee

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

       aaccttiivvaattee        cceenntteerr         ddeeaaccttiivvaattee

       See  the  "shell" manual entry for details on the above inherited meth-
       ods.


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::::ddiiaalloogg 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::::ddiiaalloogg command.


EEXXAAMMPPLLEE
               package require Iwidgets 4.0
               iwidgets::dialog .d -modality global
               .d buttonconfigure OK -command {puts OK; .d deactivate 1}
               .d buttonconfigure Apply -command {puts Apply}
               .d buttonconfigure Cancel -command {puts Cancel; .d deactivate 0}
               .d buttonconfigure Help -command {puts Help}

               listbox [.d childsite].lb -relief sunken
               pack [.d childsite].lb -expand yes -fill both

               if {[.d activate]} {
                   puts "Exit via OK button"
               } else {
                   puts "Exit via Cancel button"
               }


AUTHOR       Mark L. Ulferts

       Bret A. Schuhmacher

KKEEYYWWOORRDDSS
       dialog, dialogshell, shell, widget



Tk                                                         iwidgets::dialog(1)