Tk Built-In Commands                                tkdialog(1T)





NAME
     tkdialog - Create modal dialog and wait for response

SYNOPSIS
     tkdialog window title text bitmap default string string ...



DESCRIPTION
     This procedure is part of the Tk script library.  Its  argu-
     ments describe a dialog box:

     window
          Name of top-level window to use for dialog.  Any exist-
          ing window by this name is destroyed.

     title
          Text to appear in the window manager's  title  bar  for
          the dialog.

     text Message to appear in the top portion of the dialog box.

     bitmap
          If non-empty, specifies a bitmap to display in the  top
          portion  of  the  dialog,  to the left of the text.  If
          this is an empty string then no bitmap is displayed  in
          the dialog.

     default
          If this is an integer greater than or  equal  to  zero,
          then it gives the index of the button that is to be the
          default button for the dialog (0 for the leftmost  but-
          ton,  and so on).  If less than zero or an empty string
          then there won't be any default button.

     string
          There will be one button for each of  these  arguments.
          Each  string  specifies text to display in a button, in
          order from left to right.

     After creating a dialog box, tkdialog waits for the user to
     select  one  of the buttons either by clicking on the button
     with the mouse or by typing return  to  invoke  the  default
     button  (if any).  Then it returns the index of the selected
     button:  0 for the leftmost button, 1 for the button next to
     it,  and  so on.  If the dialog's window is destroyed before
     the user selects one of the buttons, then -1 is returned.

     While waiting for the user  to  respond,  tkdialog  sets  a
     local  grab.   This  prevents the user from interacting with



Tk                      Last change: 4.1                        1






Tk Built-In Commands                                tkdialog(1T)



     the application in any way except to invoke the dialog box.

EXAMPLE
          set reply [tkdialog .foo "The Title" "Do you want to say yes?" \
                  questhead 0 Yes No "I'm not sure"]


SEE ALSO
     tkmessageBox(1T)


KEYWORDS
     bitmap, dialog, modal

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWTk         
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for Tk is available on http:/opensolaris.org.



























Tk                      Last change: 4.1                        2