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

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

SYNOPSIS
       iiwwiiddggeettss::::pprroommppttddiiaalloogg pathName ?options?

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

SSTTAANNDDAARRDD OOPPTTIIOONNSS
       bbaacckkggrroouunndd         bboorrddeerrWWiiddtthh       ccuurrssoorr              eexxppoorrttSSeelleeccttiioonn
       ffoorreeggrroouunndd         hhiigghhlliigghhttCCoolloorr    hhiigghhlliigghhttTThhiicckknneessss  iinnsseerrttBBaacckkggrroouunndd
       iinnsseerrttBBoorrddeerrWWiiddtthh  iinnsseerrttOOffffTTiimmee     iinnsseerrttOOnnTTiimmee        iinnsseerrttWWiiddtthh
       rreelliieeff             sseelleeccttBBaacckkggrroouunndd  sseelleeccttBBoorrddeerrWWiiddtthh   sseelleeccttFFoorreeggrroouunndd

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

AASSSSOOCCIIAATTEEDD OOPPTTIIOONNSS
       sshhooww

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

       iinnvvaalliidd         tteexxttBBaacckkggrroouunndd tteexxttFFoonntt        vvaalliiddaattee

       See the "entryfield" widget manual entry for details on the above asso-
       ciated options.

       llaabbeellFFoonntt       llaabbeellPPooss       llaabbeellTTeexxtt

       See the "labeledwidget" widget manual entry for details  on  the  above
       associated options.

IINNHHEERRIITTEEDD OOPPTTIIOONNSS
       bbuuttttoonnBBooxxPPaaddXX   bbuuttttoonnBBooxxPPaaddYY  bbuuttttoonnBBooxxPPooss    ppaaddXX
       ppaaddYY            sseeppaarraattoorr      tthhiicckknneessss

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

       hheeiigghhtt          mmaasstteerr         mmooddaalliittyy        wwiiddtthh

       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.




DESCRIPTION
       The iiwwiiddggeettss::::pprroommppttddiiaalloogg command creates a prompt dialog  similar  to
       the  OSF/Motif standard prompt dialog composite widget.  The promptdia-
       log is derived from the dialog class and is composed  of  a  EntryField
       with commands to manipulate the dialog buttons.


MMEETTHHOODDSS
       The iiwwiiddggeettss::::pprroommppttddiiaalloogg 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 promptdialog widgets:

AASSSSOOCCIIAATTEEDD MMEETTHHOODDSS
       ddeelleettee          ggeett            iiccuurrssoorr         iinnddeexx
       iinnsseerrtt          ssccaann           sseelleeccttiioonn       xxvviieeww

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

       cclleeaarr

       See the "entryfield" widget manual entry for details on the above asso-
       ciated methods.

IINNHHEERRIITTEEDD MMEETTHHOODDSS
       aadddd             bbuuttttoonnccoonnffiigguurree                ddeeffaauulltthhiiddee
       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 "shell" 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::::pprroommppttddiiaalloogg 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::::pprroommppttddiiaalloogg command.


CCOOMMPPOONNEENNTTSS
       Name:           pprroommpptt
       Class:          EEnnttrryyffiieelldd

              The  prompt  component  is the entry field for user input in the
              prompt dialog.  See the "entryfield"  widget  manual  entry  for
              details on the prompt component item.


EEXXAAMMPPLLEE
               package require Iwidgets 4.0
               option add *textBackground white

               iwidgets::promptdialog .pd -modality global -title Password -labeltext Password: -show *
               .pd hide Apply

               if {[.pd activate]} {
                   puts "Password entered: [.pd get]"
               } else {
                   puts "Password prompt cancelled"
               }


AUTHOR       Mark L. Ulferts

KKEEYYWWOORRDDSS
       promptdialog, dialog, dialogshell, shell, widget



Tk                                                   iwidgets::promptdialog(1)