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

1mSYNOPSIS0m
       1mtk_messageBox 22m?4moption24m 4mvalue24m 4m...24m?


1mDESCRIPTION0m
       This  procedure  creates and displays a message window with an applica-
       tion-specified message, an icon and a set of buttons.  Each of the but-
       tons in the message window is identified by a unique symbolic name (see
       the 1m-type 22moptions).  After the message window is popped up, 1mtk_message-0m
       1mBox  22mwaits  for  the user to select one of the buttons. Then it returns
       the symbolic name of the selected button.

       The following option-value pairs are supported:

       1m-default 4m22mname0m
              4mName24m gives the symbolic name of the default button for this mes-
              sage window ('ok', 'cancel', and so on). See 1m-type 22mfor a list of
              the symbolic names.  If this option is not specified, the  first
              button in the dialog will be made the default.

       1m-icon 4m22miconImage0m
              Specifies  an icon to display. 4mIconImage24m must be one of the fol-
              lowing: 1merror22m, 1minfo22m, 1mquestion 22mor 1mwarning22m. If this option is  not
              specified, then the info icon will be displayed.

       1m-message 4m22mstring0m
              Specifies the message to display in this message box.

       1m-parent 4m22mwindow0m
              Makes  4mwindow24m the logical parent of the message box. The message
              box is displayed on top of its parent window.

       1m-title 4m22mtitleString0m
              Specifies a string to display as the title of the  message  box.
              The default value is an empty string.

       1m-type 4m22mpredefinedType0m
              Arranges  for  a  predefined set of buttons to be displayed. The
              following values are possible for 4mpredefinedType24m:

              1mabortretryignore  22mDisplays three buttons  whose  symbolic  names
                                are 1mabort22m, 1mretry 22mand 1mignore22m.

              1mok                22mDisplays one button whose symbolic name is 1mok22m.

              1mokcancel          22mDisplays two buttons whose symbolic names  are
                                1mok 22mand 1mcancel22m.

              1mretrycancel       22mDisplays  two buttons whose symbolic names are
                                1mretry 22mand 1mcancel22m.

              1myesno             22mDisplays two buttons whose symbolic names  are
                                1myes 22mand 1mno22m.

              1myesnocancel       22mDisplays  three  buttons  whose symbolic names
                                are 1myes22m, 1mno 22mand 1mcancel22m.


1mEXAMPLE0m
              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}
              }


1mKEYWORDS0m
