Manual Pages for UNIX Operating System command usage for man tk_messageBox

Tk Built-In Commands                            tk_messageBox(1T)



_________________________________________________________________

NAME
     tk_messageBox - pops up a message window and waits for  user
     response.

SYNOPSIS
     tk_messageBox ?option value ...?
_________________________________________________________________


DESCRIPTION
     This procedure creates and displays a message window with an
     application-specified message, an icon and a set of buttons.
     Each of the buttons in the message window is identified by a
     unique  symbolic  name  (see  the -type options).  After the
     message window is popped up,  tk_messageBox  waits  for  the
     user  to select one of the buttons. Then it returns the sym-
     bolic name of the selected button.

     The following option-value pairs are supported:

     -default name
          Name gives the symbolic name of the default button  for
          this  message  window  ('ok', 'cancel', and so on). See
          -type for a list of the symbolic names.  If this option
          is  not  specified, the first button in the dialog will
          be made the default.

     -icon iconImage
          Specifies an icon to display. IconImage must be one  of
          the  following:  error,  info,  question or warning. If
          this option is not specified, then the info  icon  will
          be displayed.

     -message string
          Specifies the message to display in this message box.

     -parent window
          Makes window the logical parent of the message box. The
          message box is displayed on top of its parent window.

     -title titleString
          Specifies a string to display as the title of the  mes-
          sage box. The default value is an empty string.

     -type predefinedType
          Arranges  for  a  predefined  set  of  buttons  to   be
          displayed. The following values are possible for prede-
          finedType:

          abortretryignore  Displays three buttons whose symbolic



Tk                      Last change: 4.2                        1






Tk Built-In Commands                            tk_messageBox(1T)



                            names are abort, retry and ignore.

          ok                Displays one  button  whose  symbolic
                            name is ok.

          okcancel          Displays two buttons  whose  symbolic
                            names are ok and cancel.

          retrycancel       Displays two buttons  whose  symbolic
                            names are retry and cancel.

          yesno             Displays two buttons  whose  symbolic
                            names are yes and no.

          yesnocancel       Displays three buttons whose symbolic
                            names are yes, no and cancel.

EXAMPLE
          set answer [tk_messageBox -message "Really quit?" -type yesno -icon question]
          switch -- $answer {
              yes exit
              no {tk_messageBox -message "I know you like this application!" \
                      -type ok}
          }


KEYWORDS
     message box

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

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tk-8   |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

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












Tk                      Last change: 4.2                        2