head	1.13;
access;
symbols
	core-8-5-9:1.9.2.2
	core-8-5-8:1.9.2.1
	macosx-cocoa-merge:1.13
	macosx-cocoa-premerge:1.13
	macosx-carbon-freeze:1.13
	core-8-5-7:1.9.2.1
	core-8-5-6:1.9.2.1
	core-8-6-b1:1.13
	core-8-6-a3:1.12
	core-8-5-5:1.9.2.1
	core-8-6-a2:1.11
	core-8-5-4:1.9.2.1
	core-8-5-3:1.9.2.1
	core-8-6-a1:1.10
	core-8-5-branch:1.9.0.2
	core-8-5-2:1.9
	core-8-5-1:1.9
	core-8-5-0:1.8
	core-8-5-b3:1.7
	core-8-5-b2:1.5
	core-8-5-b1:1.3
	core-stablilizer-merge:1.3
	core-stabilizer-branch:1.3.0.2
	core-stabilizer-merge:1.9.2.1
	core-8-5-a6:1.3;
locks; strict;
comment	@# @;


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

1.12
date	2008.09.23.13.36.57;	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	2008.05.09.18.35.00;	author patthoyts;	state Exp;
branches;
next	1.9;

1.9
date	2008.01.29.15.38.00;	author dkf;	state Exp;
branches
	1.9.2.1;
next	1.8;

1.8
date	2007.12.13.15.23.44;	author dgp;	state Exp;
branches;
next	1.7;

1.7
date	2007.11.01.10.59.43;	author dkf;	state Exp;
branches;
next	1.6;

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

1.5
date	2007.10.26.20.13.23;	author dgp;	state Exp;
branches;
next	1.4;

1.4
date	2007.10.23.15.44.36;	author dkf;	state Exp;
branches;
next	1.3;

1.3
date	2006.12.13.23.04.33;	author hobbs;	state Exp;
branches
	1.3.2.1;
next	1.2;

1.2
date	2006.11.15.13.29.17;	author dkf;	state Exp;
branches;
next	1.1;

1.1
date	2006.10.31.01.42.25;	author hobbs;	state Exp;
branches;
next	;

1.3.2.1
date	2007.10.24.12.59.31;	author dgp;	state Exp;
branches;
next	1.3.2.2;

1.3.2.2
date	2007.10.27.04.23.14;	author dgp;	state Exp;
branches;
next	1.3.2.3;

1.3.2.3
date	2007.11.01.16.37.16;	author dgp;	state Exp;
branches;
next	1.3.2.4;

1.3.2.4
date	2008.01.29.17.35.50;	author dgp;	state Exp;
branches;
next	1.3.2.5;

1.3.2.5
date	2008.06.25.16.46.02;	author dgp;	state Exp;
branches;
next	;

1.9.2.1
date	2008.05.11.00.31.03;	author patthoyts;	state Exp;
branches;
next	1.9.2.2;

1.9.2.2
date	2010.08.26.02.06.09;	author hobbs;	state Exp;
branches;
next	;


desc
@@


1.13
log
@Add mentions of Toolbutton style to relevant ttk manpages.
@
text
@'\"
'\" Copyright (c) 2004 Joe English
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\" 
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.12 2008/09/23 13:36:57 dkf Exp $
'\" 
.so man.macros
.TH ttk::menubutton n 8.5 Tk "Tk Themed Widget"
.BS
.SH NAME
ttk::menubutton \- Widget that pops down a menu when pressed
.SH SYNOPSIS
\fBttk::menubutton\fR \fIpathName \fR?\fIoptions\fR?
.BE
.SH DESCRIPTION
.PP
A \fBttk::menubutton\fR widget displays a textual label and/or image,
and displays a menu when pressed.
.SO ttk_widget
\-class	\-compound	\-cursor
\-image	\-state	\-style
\-takefocus	\-text	\-textvariable
\-underline	\-width
.SE
.SH "WIDGET-SPECIFIC OPTIONS"
.OP \-direction direction Direction
Specifies where the menu is to be popped up relative 
to the menubutton.  
One of: \fBabove\fR, \fBbelow\fR, \fBleft\fR, \fBright\fR,
or \fBflush\fR.  The default is \fBbelow\fR.  
\fBflush\fR pops the menu up directly over the menubutton.
.OP \-menu menu Menu
Specifies the path name of the menu associated with the menubutton.
To be on the safe side, the menu ought to be a direct child of the
menubutton.
.\" not documented: may go away:
.\" .OP \-anchor anchor Anchor
.\" .OP \-padding padding Pad
.SH "WIDGET COMMAND"
.PP
Menubutton widgets support the standard 
\fBcget\fR, \fBconfigure\fR, \fBidentify\fR, \fBinstate\fR, and \fBstate\fR 
methods.  No other widget methods are used.
.SH "STANDARD STYLES"
.PP
\fBTtk::menubutton\fR widgets support the \fBToolbutton\fR style in all
standard themes, which is useful for creating widgets for toolbars.
.SH "SEE ALSO"
ttk::widget(n), menu(n), menubutton(n)
.SH "KEYWORDS"
widget, button, menu
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.12
log
@Fix [Bug 2118116]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.11 2008/06/30 22:57:03 dkf Exp $
d46 4
@


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: ttk_menubutton.n,v 1.10 2008/05/09 18:35:00 patthoyts Exp $
d50 3
@


1.10
log
@Document the identify command as present on all ttk widgets
@
text
@d1 1
d8 1
a8 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.9 2008/01/29 15:38:00 dkf Exp $
d19 1
d43 1
@


1.9
log
@Adjusted handling of the standard options part of the Ttk manual pages so
that they are documented in the correct location. [Bug 1876493]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.8 2007/12/13 15:23:44 dgp Exp $
d42 1
a42 1
\fBcget\fR, \fBconfigure\fR, \fBinstate\fR, and \fBstate\fR 
@


1.9.2.1
log
@Backported documentation fixes from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.10 2008/05/09 18:35:00 patthoyts Exp $
d42 1
a42 1
\fBcget\fR, \fBconfigure\fR, \fBidentify\fR, \fBinstate\fR, and \fBstate\fR 
@


1.9.2.2
log
@        Major backport of 8.6 Ttk for 8.5.9.  Most changes were only being
        committed to head (8.6), although they could apply for 8.5 as well.
        This re-sync makes future work easier to maintain and adds some
        useful work for 8.5 users. Notable changes:
        - Lots of code cleanup
        - Some bug fixes never backported
        - Addition of ttk::spinbox
        - minor color changes
        - Improved Vista/7 styling
        - Move to tile version 0.8.6 (pseudo-package)
        - ABI and API compatible (even $w identify)
        - minor new features (extended $w identify)
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.13 2008/12/04 15:47:22 dkf Exp $
a17 1
.PP
a40 1
.PP
a43 4
.SH "STANDARD STYLES"
.PP
\fBTtk::menubutton\fR widgets support the \fBToolbutton\fR style in all
standard themes, which is useful for creating widgets for toolbars.
a47 3
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.8
log
@merge stable branch onto HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.3.2.3 2007/11/01 16:37:16 dgp Exp $
d20 5
a24 4
.SO
\-class	\-compound	\-cursor	\-image
\-state	\-style	\-takefocus	\-text
\-textvariable	\-underline	\-width
@


1.7
log
@Make documentation use the name that scripts use as much as possible.
[Bug 1640073]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.6 2007/10/30 21:29:59 dkf Exp $
@


1.6
log
@More documentation improvements
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.5 2007/10/26 20:13:23 dgp Exp $
d10 1
a10 1
.TH ttk_menubutton n 8.5 Tk "Tk Themed Widget"
a11 1
.\" Use _ instead of :: as the name becomes a filename on install
d13 1
a13 1
ttk_menubutton \- Widget that pops down a menu when pressed
d44 1
a44 1
ttk_widget(n), menu(n), menubutton(n)
@


1.5
log
@        * doc/*.1:              Revert doc changes that broke
        * doc/*.3:              `make html` so we can get the release
        * doc/*.n:              out the door.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.3 2006/12/13 23:04:33 hobbs Exp $
a17 1

a25 1

d30 3
a32 3
One of: \fIabove\fR, \fIbelow\fR, \fIleft\fR, \fIright\fR,
or \fIflush\fR.  The default is \fIbelow\fR.  
\fIflush\fR pops the menu up directly over the menubutton.
a39 1

a43 1

a45 1

@


1.4
log
@Rendering-with-groff GOOBE.
@
text
@d23 3
a25 4
\-class	\-compound	\-cursor
\-image	\-state	\-style
\-takefocus	\-text	\-textvariable
\-underline	\-width
d27 1
d42 1
d47 1
d50 1
@


1.3
log
@	* unix/Makefile.in (install-doc): intentionally skip ttk_dialog.n
	installation (not for public consumption)

	* doc/scrollbar.n, doc/button.n, doc/checkbutton.n:
	* doc/entry.n, doc/frame.n, doc/label.n, doc/labelframe.n:
	* doc/menu.n, doc/menubutton.n, doc/panedwindow.n:
	* doc/radiobutton.n, doc/scrollbar.n, doc/ttk_*: revamp ttk docs
	to use consist nroff format (not 100% consistent with classic
	widget docs).  Add more man page cross-linking "SEE ALSO".
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: popup.n,v 1.4 2004/06/21 20:59:29 dkf Exp $
d23 4
a26 3
\-class	\-compound	\-cursor	\-image
\-state	\-style	\-takefocus	\-text
\-textvariable	\-underline	\-width
a27 1

a41 1

a45 1

a47 1

@


1.3.2.1
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.3 2006/12/13 23:04:33 hobbs Exp $
d23 3
a25 4
\-class	\-compound	\-cursor
\-image	\-state	\-style
\-takefocus	\-text	\-textvariable
\-underline	\-width
d27 1
d42 1
d47 1
d50 1
@


1.3.2.2
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.3.2.1 2007/10/24 12:59:31 dgp Exp $
d23 4
a26 3
\-class	\-compound	\-cursor	\-image
\-state	\-style	\-takefocus	\-text
\-textvariable	\-underline	\-width
a27 1

a41 1

a45 1

a47 1

@


1.3.2.3
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id$
d10 1
a10 1
.TH ttk::menubutton n 8.5 Tk "Tk Themed Widget"
d12 1
d14 1
a14 1
ttk::menubutton \- Widget that pops down a menu when pressed
d18 1
d27 1
d32 3
a34 3
One of: \fBabove\fR, \fBbelow\fR, \fBleft\fR, \fBright\fR,
or \fBflush\fR.  The default is \fBbelow\fR.  
\fBflush\fR pops the menu up directly over the menubutton.
d42 1
d47 1
d49 2
a50 1
ttk::widget(n), menu(n), menubutton(n)
@


1.3.2.4
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.8 2007/12/13 15:23:44 dgp Exp $
d20 4
a23 5
.SO ttk_widget
\-class	\-compound	\-cursor
\-image	\-state	\-style
\-takefocus	\-text	\-textvariable
\-underline	\-width
@


1.3.2.5
log
@merge updates from 8.5 branch
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_menubutton.n,v 1.3.2.4 2008/01/29 17:35:50 dgp Exp $
d42 1
a42 1
\fBcget\fR, \fBconfigure\fR, \fBidentify\fR, \fBinstate\fR, and \fBstate\fR 
@


1.2
log
@Convert \fP to \fR so that man-page scrapers have an easier time.
@
text
@d4 5
d12 1
d14 1
a14 1
ttk::menubutton \- Widget that pops down a menu when pressed
d18 1
d20 1
a20 1
A \fBmenubutton\fR widget displays a textual label and/or image,
d27 1
d42 1
d47 1
d49 2
a50 1
widget(n), keynav(n), menu(n)
@


1.1
log
@	* doc/ttk_Geometry.3, doc/ttk_Theme.3, doc/ttk_button.n:
	* doc/ttk_checkbutton.n, doc/ttk_combobox.n, doc/ttk_dialog.n:
	* doc/ttk_entry.n, doc/ttk_frame.n, doc/ttk_image.n:
	* doc/ttk_intro.n, doc/ttk_label.n, doc/ttk_labelframe.n:
	* doc/ttk_menubutton.n, doc/ttk_notebook.n, doc/ttk_panedwindow.n:
	* doc/ttk_progressbar.n, doc/ttk_radiobutton.n, doc/ttk_scrollbar.n:
	* doc/ttk_separator.n, doc/ttk_sizegrip.n, doc/ttk_style.n:
	* doc/ttk_treeview.n, doc/ttk_widget.n,:
	* generic/ttk/ttk.decls, generic/ttk/ttkBlink.c:
	* generic/ttk/ttkButton.c, generic/ttk/ttkCache.c:
	* generic/ttk/ttkClamTheme.c, generic/ttk/ttkClassicTheme.c:
	* generic/ttk/ttkDecls.h, generic/ttk/ttkDefaultTheme.c:
	* generic/ttk/ttkElements.c, generic/ttk/ttkEntry.c:
	* generic/ttk/ttkFrame.c, generic/ttk/ttkImage.c:
	* generic/ttk/ttkInit.c, generic/ttk/ttkLabel.c:
	* generic/ttk/ttkLayout.c, generic/ttk/ttkManager.c:
	* generic/ttk/ttkManager.h, generic/ttk/ttkNotebook.c:
	* generic/ttk/ttkPanedwindow.c, generic/ttk/ttkProgress.c:
	* generic/ttk/ttkScale.c, generic/ttk/ttkScroll.c:
	* generic/ttk/ttkScrollbar.c, generic/ttk/ttkSeparator.c:
	* generic/ttk/ttkSquare.c, generic/ttk/ttkState.c:
	* generic/ttk/ttkStubInit.c, generic/ttk/ttkStubLib.c:
	* generic/ttk/ttkTagSet.c, generic/ttk/ttkTheme.c:
	* generic/ttk/ttkTheme.h, generic/ttk/ttkThemeInt.h:
	* generic/ttk/ttkTrace.c, generic/ttk/ttkTrack.c:
	* generic/ttk/ttkTreeview.c, generic/ttk/ttkWidget.c:
	* generic/ttk/ttkWidget.h:
	* library/demos/ttk_demo.tcl, library/demos/ttk_iconlib.tcl:
	* library/demos/ttk_repeater.tcl:
	* library/ttk/altTheme.tcl, library/ttk/aquaTheme.tcl:
	* library/ttk/button.tcl, library/ttk/clamTheme.tcl:
	* library/ttk/classicTheme.tcl, library/ttk/combobox.tcl:
	* library/ttk/cursors.tcl, library/ttk/defaults.tcl:
	* library/ttk/dialog.tcl, library/ttk/entry.tcl:
	* library/ttk/fonts.tcl, library/ttk/icons.tcl:
	* library/ttk/keynav.tcl, library/ttk/menubutton.tcl:
	* library/ttk/notebook.tcl, library/ttk/panedwindow.tcl:
	* library/ttk/progress.tcl, library/ttk/scale.tcl:
	* library/ttk/scrollbar.tcl, library/ttk/sizegrip.tcl:
	* library/ttk/treeview.tcl, library/ttk/ttk.tcl:
	* library/ttk/utils.tcl, library/ttk/winTheme.tcl:
	* library/ttk/xpTheme.tcl:
	* macosx/ttkMacOSXTheme.c:
	* tests/ttk/all.tcl, tests/ttk/bwidget.test, tests/ttk/combobox.test:
	* tests/ttk/entry.test, tests/ttk/image.test:
	* tests/ttk/labelframe.test, tests/ttk/layout.test:
	* tests/ttk/misc.test, tests/ttk/notebook.test:
	* tests/ttk/panedwindow.test, tests/ttk/progressbar.test:
	* tests/ttk/scrollbar.test, tests/ttk/treetags.test:
	* tests/ttk/treeview.test, tests/ttk/ttk.test, tests/ttk/validate.test:
	* win/ttkWinMonitor.c, win/ttkWinTheme.c, win/ttkWinXPTheme.c:
	First import of Ttk themed Tk widgets as branched from tile 0.7.8

	* generic/tkInt.h, generic/tkWindow.c: add Ttk_Init call, copy
	tk classic widgets to ::tk namespace.
	* library/tk.tcl: add source of ttk/ttk.tcl, define $::ttk::library.
	* unix/Makefile.in, win/Makefile.in: add Ttk build bits
	* win/configure, win/configure.in: check for uxtheme.h (XP theme).
@
text
@d13 1
a13 1
A \fBmenubutton\fP widget displays a textual label and/or image,
@

