head	1.13;
access;
symbols
	core-8-5-9:1.10
	core-8-5-8:1.10
	macosx-cocoa-merge:1.13
	macosx-cocoa-premerge:1.13
	macosx-carbon-freeze:1.13
	core-8-5-7:1.10
	core-8-5-6:1.10
	core-8-6-b1:1.12
	core-8-6-a3:1.12
	core-8-5-5:1.10
	core-8-6-a2:1.11
	core-8-5-4:1.10
	core-8-5-3:1.10
	core-8-6-a1:1.10
	core-8-4-19:1.5.8.1
	core-8-5-branch:1.10.0.2
	core-8-5-2:1.10
	core-8-4-18:1.5.8.1
	core-8-5-1:1.10
	core-8-4-17:1.5.8.1
	core-8-5-0:1.10
	core-8-5-b3:1.9
	core-8-5-b2:1.8
	core-8-4-16:1.5.8.1
	core-8-5-b1:1.8
	core-stablilizer-merge:1.8
	core-stabilizer-branch:1.8.0.2
	core-stabilizer-merge:1.10
	core-8-4-15:1.5.8.1
	core-8-5-a6:1.8
	core-8-5-a5:1.8
	core-8-4-14:1.5.8.1
	core-8-5-a4:1.8
	core-8-4-13:1.5.8.1
	core-8-4-12:1.5.8.1
	core-8-4-11:1.5.8.1
	core-8-5-a3:1.8
	core-8-4-10:1.5.8.1
	core-8-4-9-branch:1.5.8.1.0.2
	core-8-5-a2:1.8
	core-8-4-9:1.5.8.1
	core-8-4-8:1.5.8.1
	core-8-4-7:1.5
	core-8-5-a1:1.5
	core-8-4-6:1.5
	core-8-4-5:1.5
	mistachkin-dev-branch:1.5.0.10
	core-8-4-4:1.5
	core-8-4-3:1.5
	core-8-4-branch:1.5.0.8
	core-8-4-2:1.5
	core-8-4-1:1.5
	core-8-3-5:1.4.2.1
	core-8-4-0:1.5
	macosx-8-4-merge-2002-08-31-trunk:1.5
	macosx-8-4-premerge-2002-08-31-branch:1.5
	macosx-8-4-premerge-2002-08-31-trunk:1.5
	macosx-8-4-merge-2002-08-30-branch:1.5
	macosx-8-4-merge-2002-08-30-trunk:1.5
	macosx-8-4-merge-2002-08-20-branch:1.5
	macosx-8-4-merge-2002-08-20-trunk:1.5
	core-8-4-b2:1.5
	core-8-4-b1:1.5
	macosx-premerge-6-9-02:1.5
	core-8-4-a4:1.5
	core-8-3-4:1.4.2.1
	macosx-8-4-branch:1.5.0.6
	macosx-8-4-branchpoint:1.5
	core-8-4-a3:1.5
	core-8-3-3:1.4.2.1
	dgp-privates-into-namespace:1.5.0.4
	tclpro-1-5-0:1.4
	core-8-4-win-speedup:1.5.0.2
	core-8-4-a2:1.5
	tclpro-1-4-1:1.4
	tclpro-1-4-0:1.4
	core-8-3-2:1.4
	ajuba-ajuba2-2-1-base:1.4
	ajuba-ajuba2-2-0:1.4
	core-8-4-a1:1.5
	core-8-3-1-branch:1.4.0.2
	core-8-3-1:1.4
	scriptics-sc-2-0-b5:1.4
	scriptics-sc-2-0-fixed:1.4
	scriptics-sc-2-0-b2:1.4
	scriptics-sc-2-0-b1:1.4
	core-8-3-0:1.4
	core-8-3-b2:1.4
	core-8-3-b1:1.4
	scriptics-sc-1-1:1.3
	scriptics-sc-1-1-b1:1.3
	core-8-2-3:1.3
	scriptics-sc-1-1-branch:1.3.0.10
	scriptics-sc-1-1-base:1.3
	scriptics-sc-1-0:1.3
	scriptics-sc-1-0-branch:1.3.0.8
	scriptics-sc-1-0-base:1.3
	core-8-2-2:1.3
	core-8-2-1:1.3
	scriptics-bc-1-0-b1:1.3
	core-8-2-1-branch:1.3.0.6
	scriptics-tclpro-1-3-0:1.3
	core-8-2-0:1.3
	core-8-2-b3-branch:1.3.0.4
	core-8-2-b3-base:1.3
	scriptics-tclpro-1-3-b4:1.3
	core-8-2-b2:1.3
	scriptics-tclpro-1-3-b3:1.3
	core-8-2-b1:1.3
	scriptics-tclpro-1-3-b2:1.3
	merge-to-mainline-5/21/99:1.3
	scriptics-tclpro-1-3-b2-branch:1.3.0.2
	core-8-1-1:1.3
	scriptics-tclpro-1-3-b1:1.3
	core-8-1-1-base:1.3
	core-8-1-0:1.3
	merge-to-mainline-4-29-99:1.3
	merge-to-mainline-4-23-99:1.3
	core-8-1-branch-old:1.1.0.4
	core-8-0-6-branch:1.2.0.6
	core-8-0-6-base:1.2
	core-8-0-5:1.2
	core-8-1-b3:1.1.4.1
	core-8-1-b2:1.1.4.1
	dev-8-1-stubs-branch:1.1.4.1.0.2
	dev-stubs-branch:1.2.0.4
	scriptics-tclpro-1-2:1.2
	scriptics-tclpro-1-2-b2:1.2
	core-8-1-merge-2/10/99:1.2
	core-8-0-5-branch:1.2.0.2
	core-8-0-5-base:1.2
	scriptics-tclpro-1-2-b1:1.2
	scriptics-tclpro-1-2-a1:1.2
	core-8-1-b1:1.1.4.1
	core-8-0-4:1.2
	core-8-1-a2:1.1
	core-8-0-2:1.1
	core-8-0-3:1.2;
locks; strict;
comment	@# @;


1.13
date	2009.04.04.16.18.37;	author dkf;	state Exp;
branches;
next	1.12;

1.12
date	2008.09.23.13.36.45;	author dkf;	state Exp;
branches;
next	1.11;

1.11
date	2008.06.30.22.57.03;	author dkf;	state Exp;
branches;
next	1.10;

1.10
date	2007.12.13.15.23.43;	author dgp;	state Exp;
branches;
next	1.9;

1.9
date	2007.10.29.16.04.13;	author dkf;	state Exp;
branches;
next	1.8;

1.8
date	2004.10.28.10.22.51;	author dkf;	state Exp;
branches
	1.8.2.1;
next	1.7;

1.7
date	2004.05.29.19.00.32;	author jenglish;	state Exp;
branches;
next	1.6;

1.6
date	2004.05.24.21.23.23;	author dkf;	state Exp;
branches;
next	1.5;

1.5
date	2000.04.27.18.28.58;	author ericm;	state Exp;
branches
	1.5.8.1;
next	1.4;

1.4
date	99.09.02.17.02.12;	author hobbs;	state Exp;
branches
	1.4.2.1;
next	1.3;

1.3
date	99.04.16.01.51.09;	author stanton;	state Exp;
branches;
next	1.2;

1.2
date	98.09.14.18.22.58;	author stanton;	state Exp;
branches;
next	1.1;

1.1
date	98.04.01.09.39.54;	author rjohnson;	state Exp;
branches
	1.1.4.1;
next	;

1.1.4.1
date	98.09.30.02.16.23;	author stanton;	state Exp;
branches;
next	1.1.4.2;

1.1.4.2
date	99.04.09.21.04.44;	author surles;	state Exp;
branches;
next	;

1.4.2.1
date	2001.04.04.07.23.48;	author hobbs;	state Exp;
branches;
next	;

1.5.8.1
date	2004.10.28.10.19.29;	author dkf;	state Exp;
branches;
next	;

1.8.2.1
date	2007.11.01.16.37.15;	author dgp;	state Exp;
branches;
next	;


desc
@@


1.13
log
@Fix [Bug 1881896]
@
text
@'\"
'\" Copyright (c) 1996 Sun Microsystems, Inc.
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\" 
'\" RCS: @@(#) $Id: messageBox.n,v 1.12 2008/09/23 13:36:45 dkf Exp $
'\" 
.so man.macros
.TH tk_messageBox n 4.2 Tk "Tk Built-In Commands"
.BS
'\" Note:  do not modify the .SH NAME line immediately below!
.SH NAME
tk_messageBox \- pops up a message window and waits for user response.
.SH SYNOPSIS
\fBtk_messageBox \fR?\fIoption value ...\fR?
.BE
.SH DESCRIPTION
.PP
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 \fB\-type\fR options).  After the message window is
popped up, \fBtk_messageBox\fR waits for the user to select one of the
buttons. Then it returns the symbolic name of the selected button.
.PP
The following option-value pairs are supported:
.TP
\fB\-default\fR \fIname\fR
.
\fIName\fR gives the symbolic name of the default button for
this message window (
.QW ok ,
.QW cancel ,
and so on). See \fB\-type\fR
for a list of the symbolic names.  If this option is not specified,
the first button in the dialog will be made the default.
.TP
\fB\-detail\fR \fIstring\fR
.
Specifies an auxiliary message to the main message given by the
\fB\-message\fR option. The message detail will be presented beneath the main
message and, where supported by the OS, in a less emphasized font than the
main message.
.TP
\fB\-icon\fR \fIiconImage\fR
.
Specifies an icon to display. \fIIconImage\fR must be one of the
following: \fBerror\fR, \fBinfo\fR, \fBquestion\fR or
\fBwarning\fR. If this option is not specified, then the info icon will be
displayed.
.TP
\fB\-message\fR \fIstring\fR
.
Specifies the message to display in this message box. This option is ignored
on Mac OS X, where platform guidelines forbid the use of a title on this kind
of dialog.
.TP
\fB\-parent\fR \fIwindow\fR
.
Makes \fIwindow\fR the logical parent of the message box. The message
box is displayed on top of its parent window.
.TP
\fB\-title\fR \fItitleString\fR
.
Specifies a string to display as the title of the message box. The
default value is an empty string.
.TP
\fB\-type\fR \fIpredefinedType\fR
.
Arranges for a predefined set of buttons to be displayed. The
following values are possible for \fIpredefinedType\fR:
.RS
.TP 18
\fBabortretryignore\fR
.
Displays three buttons whose symbolic names are \fBabort\fR,
\fBretry\fR and \fBignore\fR.
.TP 18
\fBok\fR
.
Displays one button whose symbolic name is \fBok\fR.
.TP 18
\fBokcancel\fR
.
Displays two buttons whose symbolic names are \fBok\fR and \fBcancel\fR.
.TP 18
\fBretrycancel\fR
.
Displays two buttons whose symbolic names are \fBretry\fR and \fBcancel\fR.
.TP 18
\fByesno\fR
.
Displays two buttons whose symbolic names are \fByes\fR and \fBno\fR.
.TP 18
\fByesnocancel\fR
.
Displays three buttons whose symbolic names are \fByes\fR, \fBno\fR
and \fBcancel\fR.
.RE
.PP
.SH EXAMPLE
.PP
.CS
set answer [\fBtk_messageBox\fR \-message "Really quit?" \e
        \-icon question \-type yesno \e
        \-detail "Select \e"Yes\e" to make the application exit"]
switch \-\- $answer {
    yes exit
    no {\fBtk_messageBox\fR \-message "I know you like this application!" \e
            \-type ok}
}
.CE
.SH KEYWORDS
message box
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.12
log
@Fix [Bug 2118116]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.11 2008/06/30 22:57:03 dkf Exp $
d30 1
d40 1
d42 2
a43 2
\fB\-message\fR option.  Where supported by the underlying OS, the
message detail will be presented in a less emphasized font than the
d47 1
d54 4
a57 1
Specifies the message to display in this message box.
d60 1
d65 1
d70 1
d76 1
d81 1
d85 1
d89 1
d93 1
d97 1
@


1.11
log
@Minor doc updates (removing out of date changebars, improving typedef formatting,
 etc.)
@
text
@a0 1
'\" -*- nroff -*-
d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.10 2007/12/13 15:23:43 dgp Exp $
d101 3
@


1.10
log
@merge stable branch onto HEAD
@
text
@d1 1
d8 1
a8 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.8.2.1 2007/11/01 16:37:15 dgp Exp $
a18 1

d27 1
a27 1

d35 1
a35 1
and so on). See \fB\-type\fR 
a39 1
.VS 8.5
a43 1
.VE 8.5
d89 1
a99 1

@


1.9
log
@Lots more GOOBE stuff. Now works with 'make html'!
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.8 2004/10/28 10:22:51 dkf Exp $
@


1.8
log
@Assorted minor documentation fixes
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.7 2004/05/29 19:00:32 jenglish Exp $
d32 4
a35 1
this message window ('ok', 'cancel', and so on). See \fB\-type\fR 
d95 1
a95 1
switch -- $answer {
@


1.8.2.1
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.8 2004/10/28 10:22:51 dkf Exp $
d32 1
a32 4
this message window (
.QW ok ,
.QW cancel ,
and so on). See \fB\-type\fR 
d92 1
a92 1
switch \-\- $answer {
@


1.7
log
@Fix minor markup errors (backslash is \e, not \b).
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.6 2004/05/24 21:23:23 dkf Exp $
d89 1
a89 1
set answer [tk_messageBox \-message "Really quit?" \e
d94 1
a94 1
    no {tk_messageBox \-message "I know you like this application!" \e
@


1.6
log
@Finish off the TIP#152 implementation with Win implementation, tests & docs.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.5 2000/04/27 18:28:58 ericm Exp $
d89 3
a91 3
set answer [tk_messageBox \-message "Really quit?" \b
        \-icon question \-type yesno \b
        \-detail "Select \b"Yes\b" to make the application exit"]
d94 1
a94 1
    no {tk_messageBox \-message "I know you like this application!" \b
@


1.5
log
@* doc/keysyms.n: Man page enumerating keysyms [RFE: 1645].

* doc/colors.n: Man page enumerating valid color names [RFE: 1645].

* doc/cursors.n: Man page enumerating valid cursor values [RFE: 1645].

* library/msgbox.tcl: Corrected Unix tk_messageBox implementation
to make the first button the default when no default is specified
[Bug: 2218].

* doc/messageBox.n: Updated documentation with regards to
selection of default button when none is specified (now it will
use the first button as the default in that case) [Bug: 2218].
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.4 1999/09/02 17:02:12 hobbs Exp $
d36 8
d89 3
a91 1
set answer [tk_messageBox \-message "Really quit?" \-type yesno \-icon question]
d94 2
a95 1
    no {tk_messageBox \-message "I know you like this application!" \-type ok}
@


1.5.8.1
log
@Backport of documentation fixes
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.5 2000/04/27 18:28:58 ericm Exp $
d81 1
a81 1
set answer [\fBtk_messageBox\fR \-message "Really quit?" \-type yesno \-icon question]
d84 1
a84 2
    no {\fBtk_messageBox\fR \-message "I know you like this application!" \e
            \-type ok}
@


1.4
log
@1999-09-01  Jeff Hobbs  <hobbs@@scriptics.com>

	* win/tkWinDraw.c:
	* unix/tkUnixDraw.c: fixed header style for TkpDrawHighlightBorder
	* generic/tkCanvas.c: fixed GC error (bg <> fg) in tkCanvas.c
	(from code added to support TkpDrawHighlightBorder) [Bug: 2676]
	* unix/aclocal.m4: added -bnoentry to the AIX-* flags
	* generic/tkCursor.c: fixed equality error in GetCursorFromObj
	[Bug: 2562]
	* library/msgbox.tcl: changed the behavior of tk_messageBox on
	Unix to be more Windows like in handling of <Return> and the
	default button
	* library/button.tcl:
	* library/clrpick.tcl:
	* library/comdlg.tcl:
	* library/console.tcl:
	* library/dialog.tcl:
	* library/entry.tcl:
	* library/focus.tcl:
	* library/listbox.tcl:
	* library/menu.tcl:
	* library/msgbox.tcl:
	* library/palette.tcl:
	* library/safetk.tcl:
	* library/scale.tcl:
	* library/scrlbar.tcl:
	* library/tearoff.tcl:
	* library/text.tcl:
	* library/tk.tcl:
	* library/tkfbox.tcl:
	* library/xmfbox.tcl: updated commands to use [string] ops
	instead of expr equality operators
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.3 1999/04/16 01:51:09 stanton Exp $
d33 2
a34 3
for a list of the symbolic names.  If the message box has just one
button it will automatically be made the default, otherwise if this
option is not specified, there won't be any default button.
@


1.4.2.1
log
@doc cleanup and clarifications from 8.4aCVS backport
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.5 2000/04/27 18:28:58 ericm Exp $
d33 3
a35 2
for a list of the symbolic names.  If this option is not specified,
the first button in the dialog will be made the default.
@


1.3
log
@* Merged 8.1 branch into the main trunk
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id$
d40 1
a40 1
\fBwarning\fR. If this option is not specified, then no icon will be
@


1.2
log
@Replaced SCCS strings, fixed binary files
@
text
@d83 1
a83 1
case $answer {
@


1.1
log
@Initial revision
@
text
@d7 1
a7 1
'\" SCCS: @@(#) messageBox.n 1.5 96/09/19 17:02:40
@


1.1.4.1
log
@Merged 8.0.3 changes into 8.1
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.2 1998/09/14 18:22:58 stanton Exp $
@


1.1.4.2
log
@fixed doc bug 901
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: messageBox.n,v 1.1.4.1 1998/09/30 02:16:23 stanton Exp $
d83 1
a83 1
switch -- $answer {
@


