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

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

SYNOPSIS
       iiwwiiddggeettss::::ddiiaallooggsshheellll pathName ?options?

IINNHHEERRIITTAANNCCEE
       itk::Toplevel <- iwidgets::Shell <- iwidgets::Dialogshell

SSTTAANNDDAARRDD OOPPTTIIOONNSS
       bbaacckkggrroouunndd      ccuurrssoorr         ffoorreeggrroouunndd

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

IINNHHEERRIITTEEDD OOPPTTIIOONNSS
       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.


WWIIDDGGEETT-SSPPEECCIIFFIICC OOPPTTIIOONNSS
       Name:           bbuuttttoonnBBooxxPPaaddXX
       Class:          PPaadd
       Command-Line Switch:           -bbuuttttoonnbbooxxppaaddxx

              Specifies  a  non-negative padding distance to leave between the
              button group and the outer edge of  the  button  box  in  the  x
              direction.   The  value  may  be  given  in  any  of  the  forms
              accpetable to TTkkGGeettPPiixxeellss.  The default is 5 pixels.

       Name:           bbuuttttoonnBBooxxPPaaddYY
       Class:          PPaadd
       Command-Line Switch:           -bbuuttttoonnbbooxxppaaddyy

              Specifies a non-negative padding distance to leave  between  the
              button  group  and  the  outer  edge  of the button box in the y
              direction.   The  value  may  be  given  in  any  of  the  forms
              accpetable to TTkkGGeettPPiixxeellss.  The default is 5 pixels.

       Name:           bbuuttttoonnBBooxxPPooss
       Class:          PPoossiittiioonn
       Command-Line Switch:           -bbuuttttoonnbbooxxppooss

              Attaches  buttons to the given side of the dialog: nn, ss, ee or ww.
              The default is s.

       Name:           ppaaddXX
       Class:          PPaadd
       Command-Line Switch:           -ppaaddxx

              Specifies a padding distance for the childsite in  the  X-direc-
              tion  in  any  of  the  forms  acceptable  to TTkkGGeettPPiixxeellss.  The
              default is 10.

       Name:           ppaaddYY
       Class:          PPaadd
       Command-Line Switch:           -ppaaddyy

              Specifies a padding distance for the childsite in  the  Y-direc-
              tion  in  any  of  the  forms  acceptable  to TTkkGGeettPPiixxeellss.  The
              default is 10.

       Name:           sseeppaarraattoorr
       Class:          SSeeppaarraattoorr
       Command-Line Switch:           -sseeppaarraattoorr

              Specifies whether a line is drawn to separate the  buttons  from
              the  dialog  box  contents  in  any  of  the forms acceptable to
              TTccllGGeettBBoooolleeaann.  The default is true.

       Name:           tthhiicckknneessss
       Class:          TThhiicckknneessss
       Command-Line Switch:           -tthhiicckknneessss

              Specifies the thickness of the separator in  any  of  the  forms
              acceptable to TTkkGGeettPPiixxeellss.  The default is 3 pixels.



DESCRIPTION
       The iiwwiiddggeettss::::ddiiaallooggsshheellll command creates a dialog shell which is a top
       level widget composed of a button box, separator, and child site  area.
       The class also has methods to control button construction.


MMEETTHHOODDSS
       The  iiwwiiddggeettss::::ddiiaallooggsshheellll  command create 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 dialogshell widgets:

IINNHHEERRIITTEEDD MMEETTHHOODDSS
       aaccttiivvaattee        cceenntteerr         ddeeaaccttiivvaattee

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

AASSSSOOCCIIAATTEEDD MMEETTHHOODDSS
       aadddd             bbuuttttoonnccoonnffiigguurree                ddeeffaauullttddeelleettee
       hhiiddee            iinnddeexx          iinnsseerrtt          iinnvvookkee
       sshhooww

       See the "buttonbox" manual entry for details on the associated 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::::ddiiaallooggsshheellll command.

       pathName cchhiillddssiittee
              Returns the pathname of the child site widget.

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


CCOOMMPPOONNEENNTTSS
       Name:           ddsscchhiillddssiittee
       Class:          ffrraammee

              The dschildsite component is the user child site for the  dialog
              shell.   See  the "frame" widget manual entry for details on the
              dschildsite component item.

       Name:           sseeppaarraattoorr
       Class:          ffrraammee

              The separator component devides the area between the user  child
              site  and  the  button box.  See the "frame" widget manual entry
              for details on the separator component item.

       Name:           bbbbooxx
       Class:          BBuuttttoonnBBooxx

              The bbox component is the button box containing the buttons  for
              the  dialog  shell.  See the "ButtonBox" widget manual entry for
              details on the bbox component item.


EEXXAAMMPPLLEE
               package require Iwidgets 4.0
               iwidgets::dialogshell .ds -modality none

               .ds add OK -text "OK"
               .ds add Cancel -text "Cancel"
               .ds default OK

               .ds activate


AUTHOR       Mark L. Ulferts

KKEEYYWWOORRDDSS
       dialogshell, dialog, shell, widget



Tk                                                    iwidgets::dialogshell(1)