head	1.17;
access;
symbols
	core-8-5-9:1.13.2.2
	core-8-5-8:1.13.2.1
	macosx-cocoa-merge:1.17
	macosx-cocoa-premerge:1.17
	macosx-carbon-freeze:1.17
	core-8-5-7:1.13
	core-8-5-6:1.13
	core-8-6-b1:1.17
	core-8-6-a3:1.17
	core-8-5-5:1.13
	core-8-6-a2:1.16
	core-8-5-4:1.13
	core-8-5-3:1.13
	core-8-6-a1:1.15
	core-8-5-branch:1.13.0.2
	core-8-5-2:1.13
	core-8-5-1:1.12
	core-8-5-0:1.12
	core-8-5-b3:1.9
	core-8-5-b2:1.6
	core-8-5-b1:1.3
	core-stablilizer-merge:1.3
	core-stabilizer-branch:1.3.0.2
	core-stabilizer-merge:1.13
	core-8-5-a6:1.3;
locks; strict;
comment	@# @;


1.17
date	2008.09.23.13.36.57;	author dkf;	state Exp;
branches;
next	1.16;

1.16
date	2008.06.30.22.57.03;	author dkf;	state Exp;
branches;
next	1.15;

1.15
date	2008.05.27.20.47.16;	author patthoyts;	state Exp;
branches;
next	1.14;

1.14
date	2008.04.09.09.28.05;	author patthoyts;	state Exp;
branches;
next	1.13;

1.13
date	2008.03.16.22.37.45;	author dkf;	state Exp;
branches
	1.13.2.1;
next	1.12;

1.12
date	2007.12.13.15.23.44;	author dgp;	state Exp;
branches;
next	1.11;

1.11
date	2007.12.12.15.51.22;	author jenglish;	state Exp;
branches;
next	1.10;

1.10
date	2007.12.05.16.38.15;	author jenglish;	state Exp;
branches;
next	1.9;

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

1.8
date	2007.10.30.21.29.59;	author dkf;	state Exp;
branches;
next	1.7;

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

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

1.5
date	2007.10.24.14.32.59;	author dkf;	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.32;	author dgp;	state Exp;
branches;
next	1.3.2.2;

1.3.2.2
date	2007.10.27.04.23.15;	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	2007.12.05.18.11.41;	author dgp;	state Exp;
branches;
next	1.3.2.5;

1.3.2.5
date	2007.12.13.06.28.47;	author dgp;	state Exp;
branches;
next	1.3.2.6;

1.3.2.6
date	2008.03.26.20.09.31;	author dgp;	state Exp;
branches;
next	;

1.13.2.1
date	2009.05.14.00.53.04;	author patthoyts;	state Exp;
branches;
next	1.13.2.2;

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


desc
@@


1.17
log
@Fix [Bug 2118116]
@
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_style.n,v 1.16 2008/06/30 22:57:03 dkf Exp $
'\" 
.so man.macros
.TH ttk::style n 8.5 Tk "Tk Themed Widget"
.BS
.SH NAME
ttk::style \- Manipulate style database
.SH SYNOPSIS
\fBttk::style\fR \fIoption\fR ?\fIargs\fR?
.BE
.SH NOTES
.PP
See also the Tcl'2004 conference presentation,
available at http://tktable.sourceforge.net/tile/tile-tcl2004.pdf
.SH DEFINITIONS
.PP
Each widget is assigned a \fIstyle\fR,
which specifies the set of elements making up the widget
and how they are arranged, along with dynamic and default
settings for element options.
By default, the style name is the same as the widget's class;
this may be overridden by the \fB\-style\fR option. 
.PP
A \fItheme\fR is a collection of elements and styles 
which controls the overall look and feel of an application.
.SH DESCRIPTION
.PP
The \fBttk::style\fR command takes the following arguments:
.TP
\fBttk::style configure \fIstyle\fR ?\fI\-option\fR ?\fIvalue option value...\fR? ?
Sets the default value of the specified option(s) in \fIstyle\fR.
.TP
\fBttk::style map \fIstyle\fR ?\fI\-option\fB { \fIstatespec value...\fB }\fR?
Sets dynamic values of the specified option(s) in \fIstyle\fR.
Each \fIstatespec / value\fR pair is examined in order;
the value corresponding to the first matching \fIstatespec\fR
is used.
.TP
\fBttk::style lookup \fIstyle\fR \fI\-option \fR?\fIstate \fR?\fIdefault\fR??
Returns the value specified for \fI\-option\fR in style \fIstyle\fR
in state \fIstate\fR, using the standard lookup rules for element options.
\fIstate\fR is a list of state names; if omitted, 
it defaults to all bits off (the
.QW normal
state).
If the \fIdefault\fR argument is present, it is used as a fallback
value in case no specification for \fI\-option\fR is found.
.\" Otherwise -- signal error? return empty string? Leave unspecified for now. 
.TP
\fBttk::style layout \fIstyle\fR ?\fIlayoutSpec\fR?
Define the widget layout for style \fIstyle\fR.  
See \fBLAYOUTS\fR below for the format of \fIlayoutSpec\fR.
If \fIlayoutSpec\fR is omitted, return the layout specification
for style \fIstyle\fR.
.TP 
\fBttk::style element create\fR \fIelementName\fR \fItype\fR ?\fIargs...\fR?
Creates a new element in the current theme of type \fItype\fR.
The only cross-platform built-in element type is \fIimage\fR 
(see \fBttk_image\fR(n)) but themes may define other element types 
(see \fBTtk_RegisterElementFactory\fR). On suitable versions of Windows
an element factory is registered to create Windows theme elements
(see \fBttk_vsapi\fR(n)).
.TP 
\fBttk::style element names\fR
Returns the list of elements defined in the current theme.
.TP 
\fBttk::style element options \fIelement\fR
Returns the list of \fIelement\fR's options.
.TP
\fBttk::style theme create\fR \fIthemeName\fR ?\fB\-parent \fIbasedon\fR? ?\fB\-settings \fIscript...\fR ?
Creates a new theme.  It is an error if \fIthemeName\fR already exists.
If \fB\-parent\fR is specified, the new theme will inherit
styles, elements, and layouts from the parent theme \fIbasedon\fR.
If \fB\-settings\fR is present, \fIscript\fR is evaluated in the
context of the new theme as per \fBttk::style theme settings\fR.
.TP
\fBttk::style theme settings \fIthemeName\fR \fIscript\fR
Temporarily sets the current theme to \fIthemeName\fR, 
evaluate \fIscript\fR, then restore the previous theme.
Typically \fIscript\fR simply defines styles and elements,
though arbitrary Tcl code may appear.
.TP
\fBttk::style theme names\fR
Returns a list of all known themes.
.TP
\fBttk::style theme use\fR ?\fIthemeName\fR?
Without an argument the result is the name of the current theme.
Otherwise this command sets the current theme to \fIthemeName\fR,
and refreshes all widgets.
.SH LAYOUTS
.PP
A \fIlayout\fR specifies a list of elements, each followed
by one or more options specifying how to arrange the element.
The layout mechanism uses a simplified version of the \fBpack\fR
geometry manager: given an initial cavity,
each element is allocated a parcel.
Valid options are:
.TP 
\fB\-side \fIside\fR
Specifies which side of the cavity to place the element;
one of \fBleft\fR, \fBright\fR, \fBtop\fR, or \fBbottom\fR.
If omitted, the element occupies the entire cavity.
.TP
\fB\-sticky\fR \fB[\fInswe\fB]\fR
Specifies where the element is placed inside its allocated parcel.
.TP
\fB\-children { \fIsublayout... \fB}\fR
Specifies a list of elements to place inside the element.
.\" Also: -border, -unit, -expand: may go away.
.PP
For example:
.CS
ttk::style layout Horizontal.TScrollbar {
    Scrollbar.trough \-children {
        Scrollbar.leftarrow \-side left
        Scrollbar.rightarrow \-side right
        Horizontal.Scrollbar.thumb \-side left \-sticky ew
    }
}
.CE
.SH "SEE ALSO"
ttk::intro(n), ttk::widget(n), photo(n), ttk_image(n)
.SH KEYWORDS
style, theme, appearance
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.16
log
@Minor doc updates (removing out of date changebars, improving typedef formatting,
 etc.)
@
text
@a0 1
'\" -*- nroff -*-
d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.15 2008/05/27 20:47:16 patthoyts Exp $
d131 3
@


1.15
log
@[ttk::style theme use] without an argument now returns the current theme
@
text
@d1 1
d8 1
a8 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.14 2008/04/09 09:28:05 patthoyts Exp $
d19 1
d23 1
d34 1
d98 1
@


1.14
log
@Improved the element factory documentation and cross-links
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.13 2008/03/16 22:37:45 dkf Exp $
d89 4
a92 2
\fBttk::style theme use\fR \fIthemeName\fR
Sets the current theme to \fIthemeName\fR, and refreshes all widgets.
@


1.13
log
@Correct cross-reference
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.12 2007/12/13 15:23:44 dgp Exp $
d61 5
a65 3
The only built-in element type is \fIimage\fR (see \fBttk_image\fR(n)),
although themes may define other element types 
(see \fBTtk_RegisterElementFactory\fR).
@


1.13.2.1
log
@Backported support for the Vista theme.
This requires the vsapi element engine, the hover state and the theme script definition.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.13 2008/03/16 22:37:45 dkf Exp $
d61 3
a63 5
The only cross-platform built-in element type is \fIimage\fR 
(see \fBttk_image\fR(n)) but themes may define other element types 
(see \fBTtk_RegisterElementFactory\fR). On suitable versions of Windows
an element factory is registered to create Windows theme elements
(see \fBttk_vsapi\fR(n)).
@


1.13.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_style.n,v 1.17 2008/09/23 13:36:57 dkf Exp $
a17 1
.PP
a20 1
.PP
a30 1
.PP
d89 2
a90 4
\fBttk::style theme use\fR ?\fIthemeName\fR?
Without an argument the result is the name of the current theme.
Otherwise this command sets the current theme to \fIthemeName\fR,
and refreshes all widgets.
a91 1
.PP
a124 3
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.12
log
@merge stable branch onto HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.3.2.5 2007/12/13 06:28:47 dgp Exp $
d61 1
a61 1
The only built-in element type is \fIimage\fR (see \fIimage(n)\fR),
d120 1
a120 1
ttk::intro(n), ttk::widget(n), photo(n)
@


1.11
log
@Various minor updates to ttk_* manpages.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.10 2007/12/05 16:38:15 jenglish Exp $
@


1.10
log
@* doc/ttk_style.n: Remove nonsense about "this manpage has
not yet been written"; everything supported is documented.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.9 2007/11/01 10:59:44 dkf Exp $
d24 1
a24 1
settings for element resources.
d33 1
a33 1
\fBttk::style configure \fIstyle\fR ?\fI\-option\fR? ?\fIvalue option value...\fR?
d36 1
a36 1
\fBttk::style map \fIstyle\fR ?\fI\-option\fB { \fIstatespec value\fB }\fR ... ?
d85 1
a85 1
Returns a list of the available themes.
d102 1
a102 1
\fB\-sticky [\fInswe\fB]\fR
d105 1
a105 1
\fB\-children {\fIsublayout... \fB}\fR
@


1.9
log
@Make documentation use the name that scripts use as much as possible.
[Bug 1640073]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.8 2007/10/30 21:29:59 dkf Exp $
d13 1
a13 1
ttk::style \- Control overall look and feel of widgets
d18 1
a18 3
.PP
This manpage has not been written yet.
Please see the Tcl'2004 conference presentation,
a20 1
.PP
@


1.8
log
@More documentation improvements
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.7 2007/10/29 16:04:14 dkf Exp $
d10 1
a10 1
.TH ttk_style n 8.5 Tk "Tk Themed Widget"
d13 1
a13 1
ttk_style \- Control overall look and feel of widgets
d123 1
a123 1
ttk_intro(n), ttk_widget(n), photo(n)
@


1.7
log
@Lots more GOOBE stuff. Now works with 'make html'!
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.6 2007/10/26 20:13:23 dgp Exp $
a16 1

a21 1

d36 1
a36 1
\fBttk::style configure \fIstyle\fR ?\fI\-option \fR?\fIvalue option value...\fR? ?
d39 1
a39 1
\fBttk::style map \fIstyle\fR ?\fI\-option\fR { \fIstatespec value\fR } ... ?
a91 1

d105 1
a105 1
\fB\-sticky \fI[nswe]\fR
d108 1
a108 1
\fB\-children \fI{ sublayout... }\fR
a121 1

a123 1

@


1.6
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_style.n,v 1.3 2006/12/13 23:04:33 hobbs Exp $
d31 1
a31 1
this may be overridden by the \fB-style\fR option. 
d38 1
a38 1
\fBttk::style configure \fIstyle\fR ?\fI-option \fR?\fIvalue option value...\fR? ?
d41 1
a41 1
\fBttk::style map \fIstyle\fR ?\fI-option\fR { \fIstatespec value\fR } ... ?
d47 2
a48 2
\fBttk::style lookup \fIstyle\fR \fI-option \fR?\fIstate \fR?\fIdefault\fR??
Returns the value specified for \fI-option\fR in style \fIstyle\fR
d51 3
a53 1
it defaults to all bits off (the ``normal'' state).
d55 2
a56 2
value in case no specification for \fI-option\fR is found.
.\" Otherwise -- signal error? return empty string?  Leave unspecified for now. 
d60 1
a60 1
See "\fBLAYOUTS\fR" below for the format of \fIlayoutSpec\fR.
d76 1
a76 1
\fBttk::style theme create\fR \fIthemeName\fR ?\fB-parent \fIbasedon\fR? ?\fB-settings \fIscript...\fR ?
d78 3
a80 3
If \fI-parent\fR is specified, the new theme will inherit
styles, elements, and layouts from the parent theme \fIbasedon\fB.
If \fI-settings\fR is present, \fIscript\fR is evaluated in the
d103 1
a103 1
\fB-side \fIside\fR
d108 1
a108 1
\fB-sticky \fI[nswe]\fR
d111 1
a111 1
\fB-children \fI{ sublayout... }\fR
d118 4
a121 4
    Scrollbar.trough -children {
        Scrollbar.leftarrow -side left
        Scrollbar.rightarrow -side right
        Horizontal.Scrollbar.thumb -side left -sticky ew
@


1.5
log
@Lots of improvements to look and feel of manual pages
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.4 2007/10/23 15:44:36 dkf Exp $
a17 1
.BS
d20 3
a22 4
This manpage has not been written yet. Please see the Tcl'2004 conference
presentation, available at
http://tktable.sourceforge.net/tile/tile-tcl2004.pdf
.BE
d26 6
a31 4
Each Ttk widget is assigned a \fIstyle\fR, which specifies the set of elements
making up the widget and how they are arranged, along with dynamic and default
settings for element resources. By default, the style name is the same as the
widget's class; this may be overridden by the \fB\-style\fR option.
d33 2
a34 2
A \fItheme\fR is a collection of elements and styles which controls the
overall look and feel of an application.
d38 1
a38 2
\fBttk::style configure \fIstyle\fR ?\fI\-option \fR?\fIvalue option value...\fR? ?
.
d41 13
a53 14
\fBttk::style map \fIstyle\fR ?\fI\-option\fR { \fIstatespec value\fR } ... ?
.
Sets dynamic values of the specified option(s) in \fIstyle\fR. Each
\fIstatespec / value\fR pair is examined in order; the value corresponding to
the first matching \fIstatespec\fR is used.
.TP
\fBttk::style lookup \fIstyle\fR \fI\-option \fR?\fIstate\fR? ?\fIdefault\fR?
.
Returns the value specified for \fI\-option\fR in style \fIstyle\fR in state
\fIstate\fR, using the standard lookup rules for element options. \fIstate\fR
is a list of state names; if omitted, it defaults to all bits off (the
.QW normal
state). If the \fIdefault\fR argument is present, it is used as a
fallback value in case no specification for \fI\-option\fR is found.
d57 5
a61 5
.
Define the widget layout for style \fIstyle\fR. See "\fBLAYOUTS\fR" below for
the format of \fIlayoutSpec\fR. If \fIlayoutSpec\fR is omitted, return the
layout specification for style \fIstyle\fR.
.TP
d63 4
a66 4
.
Creates a new element in the current theme of type \fItype\fR. The only
built-in element type is \fIimage\fR (see \fIttk_image(n)\fR), although themes
may define other element types (see \fBTtk_RegisterElementFactory\fR).
a68 1
.
a71 1
.
d74 6
a79 7
\fBttk::style theme create\fR \fIthemeName\fR ?\fB\-parent \fIbasedon\fR? ?\fB\-settings \fIscript...\fR ?
.
Creates a new theme. It is an error if \fIthemeName\fR already exists. If
\fI\-parent\fR is specified, the new theme will inherit styles, elements, and
layouts from the parent theme \fIbasedon\fB. If \fI\-settings\fR is present,
\fIscript\fR is evaluated in the context of the new theme as per \fBttk::style
theme settings\fR.
d82 4
a85 4
.
Temporarily sets the current theme to \fIthemeName\fR, evaluate \fIscript\fR,
then restore the previous theme. Typically \fIscript\fR simply defines styles
and elements, though arbitrary Tcl code may appear.
a87 1
.
a90 1
.
d92 1
d94 6
a99 4
A \fIlayout\fR specifies a list of elements, each followed by one or more
options specifying how to arrange the element. The layout mechanism uses a
simplified version of the \fBpack\fR geometry manager: given an initial
cavity, each element is allocated a parcel. Valid options are:
d101 4
a104 10
\fB\-side \fIside\fR
.
Specifies which side of the cavity to place the element; one of \fBleft\fR,
\fBright\fR, \fBtop\fR, or \fBbottom\fR. If omitted, the element occupies the
entire cavity.
.TP
\fB\-sticky \fI[nswe]\fR
.
Specifies where the element is placed inside its allocated parcel. The syntax
is as in the equivalently-named option to the \fBgrid\fR geometry manager.
d106 4
a109 2
\fB\-children \fI{ sublayout... }\fR
.
d112 2
a113 1
.SH EXAMPLE
d115 1
a115 1
\fBttk::style\fR layout Horizontal.TScrollbar {
d123 1
d126 1
@


1.4
log
@Rendering-with-groff GOOBE.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.3 2006/12/13 23:04:33 hobbs Exp $
d21 3
a23 3
This manpage has not been written yet.
Please see the Tcl'2004 conference presentation,
available at http://tktable.sourceforge.net/tile/tile-tcl2004.pdf
d28 4
a31 6
Each widget is assigned a \fIstyle\fR,
which specifies the set of elements making up the widget
and how they are arranged, along with dynamic and default
settings for element resources.
By default, the style name is the same as the widget's class;
this may be overridden by the \fB-style\fR option. 
d33 2
a34 2
A \fItheme\fR is a collection of elements and styles 
which controls the overall look and feel of an application.
d38 2
a39 1
\fBttk::style configure \fIstyle\fR ?\fI-option \fR?\fIvalue option value...\fR? ?
d42 14
a55 13
\fBttk::style map \fIstyle\fR ?\fI-option\fR { \fIstatespec value\fR } ... ?
Sets dynamic values of the specified option(s) in \fIstyle\fR.
Each \fIstatespec / value\fR pair is examined in order;
the value corresponding to the first matching \fIstatespec\fR
is used.
.TP
\fBttk::style lookup \fIstyle\fR \fI-option \fR?\fIstate \fR?\fIdefault\fR??
Returns the value specified for \fI-option\fR in style \fIstyle\fR
in state \fIstate\fR, using the standard lookup rules for element options.
\fIstate\fR is a list of state names; if omitted, 
it defaults to all bits off (the ``normal'' state).
If the \fIdefault\fR argument is present, it is used as a fallback
value in case no specification for \fI-option\fR is found.
d59 5
a63 5
Define the widget layout for style \fIstyle\fR.  
See "\fBLAYOUTS\fR" below for the format of \fIlayoutSpec\fR.
If \fIlayoutSpec\fR is omitted, return the layout specification
for style \fIstyle\fR.
.TP 
d65 4
a68 4
Creates a new element in the current theme of type \fItype\fR.
The only built-in element type is \fIimage\fR (see \fIimage(n)\fR),
although themes may define other element types 
(see \fBTtk_RegisterElementFactory\fR).
d71 1
d75 1
d78 7
a84 6
\fBttk::style theme create\fR \fIthemeName\fR ?\fB-parent \fIbasedon\fR? ?\fB-settings \fIscript...\fR ?
Creates a new theme.  It is an error if \fIthemeName\fR already exists.
If \fI-parent\fR is specified, the new theme will inherit
styles, elements, and layouts from the parent theme \fIbasedon\fB.
If \fI-settings\fR is present, \fIscript\fR is evaluated in the
context of the new theme as per \fBttk::style theme settings\fR.
d87 4
a90 4
Temporarily sets the current theme to \fIthemeName\fR, 
evaluate \fIscript\fR, then restore the previous theme.
Typically \fIscript\fR simply defines styles and elements,
though arbitrary Tcl code may appear.
d93 1
d97 1
d100 4
a103 6
A \fIlayout\fR specifies a list of elements, each followed
by one or more options specifying how to arrange the element.
The layout mechanism uses a simplified version of the \fBpack\fR
geometry manager: given an initial cavity,
each element is allocated a parcel.
Valid options are:
d105 10
a114 7
\fB-side \fIside\fR
Specifies which side of the cavity to place the element;
one of \fBleft\fR, \fBright\fR, \fBtop\fR, or \fBbottom\fR.
If omitted, the element occupies the entire cavity.
.TP
\fB-sticky \fI[nswe]\fR
Specifies where the element is placed inside its allocated parcel.
d116 2
a117 1
\fB-children \fI{ sublayout... }\fR
@


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 $
d18 1
d24 1
a93 1

d113 1
a113 2
.PP
For example:
d115 1
a115 1
ttk::style layout Horizontal.TScrollbar {
a122 1

a124 1

@


1.3.2.1
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.3 2006/12/13 23:04:33 hobbs Exp $
a17 1
.BS
a22 1
.BE
d92 1
d112 2
a113 1
.SH EXAMPLE
d115 1
a115 1
\fBttk::style\fR layout Horizontal.TScrollbar {
d123 1
d126 1
@


1.3.2.2
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.3.2.1 2007/10/24 12:59:32 dgp Exp $
d18 1
d24 1
a93 1

d113 1
a113 2
.PP
For example:
d115 1
a115 1
ttk::style layout Horizontal.TScrollbar {
a122 1

a124 1

@


1.3.2.3
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id$
d10 1
a10 1
.TH ttk::style n 8.5 Tk "Tk Themed Widget"
d13 1
a13 1
ttk::style \- Control overall look and feel of widgets
d17 1
d23 1
d31 1
a31 1
this may be overridden by the \fB\-style\fR option. 
d38 1
a38 1
\fBttk::style configure \fIstyle\fR ?\fI\-option\fR? ?\fIvalue option value...\fR?
d41 1
a41 1
\fBttk::style map \fIstyle\fR ?\fI\-option\fB { \fIstatespec value\fB }\fR ... ?
d47 2
a48 2
\fBttk::style lookup \fIstyle\fR \fI\-option \fR?\fIstate \fR?\fIdefault\fR??
Returns the value specified for \fI\-option\fR in style \fIstyle\fR
d51 1
a51 3
it defaults to all bits off (the
.QW normal
state).
d53 2
a54 2
value in case no specification for \fI\-option\fR is found.
.\" Otherwise -- signal error? return empty string? Leave unspecified for now. 
d58 1
a58 1
See \fBLAYOUTS\fR below for the format of \fIlayoutSpec\fR.
d74 1
a74 1
\fBttk::style theme create\fR \fIthemeName\fR ?\fB\-parent \fIbasedon\fR? ?\fB\-settings \fIscript...\fR ?
d76 3
a78 3
If \fB\-parent\fR is specified, the new theme will inherit
styles, elements, and layouts from the parent theme \fIbasedon\fR.
If \fB\-settings\fR is present, \fIscript\fR is evaluated in the
d92 1
d101 1
a101 1
\fB\-side \fIside\fR
d106 1
a106 1
\fB\-sticky [\fInswe\fB]\fR
d109 1
a109 1
\fB\-children {\fIsublayout... \fB}\fR
d116 4
a119 4
    Scrollbar.trough \-children {
        Scrollbar.leftarrow \-side left
        Scrollbar.rightarrow \-side right
        Horizontal.Scrollbar.thumb \-side left \-sticky ew
d123 1
d125 2
a126 1
ttk::intro(n), ttk::widget(n), photo(n)
@


1.3.2.4
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.3.2.3 2007/11/01 16:37:16 dgp Exp $
d13 1
a13 1
ttk::style \- Manipulate style database
d18 3
a20 1
See also the Tcl'2004 conference presentation,
d23 1
@


1.3.2.5
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.3.2.4 2007/12/05 18:11:41 dgp Exp $
d24 1
a24 1
settings for element options.
d33 1
a33 1
\fBttk::style configure \fIstyle\fR ?\fI\-option\fR ?\fIvalue option value...\fR? ?
d36 1
a36 1
\fBttk::style map \fIstyle\fR ?\fI\-option\fB { \fIstatespec value...\fB }\fR?
d85 1
a85 1
Returns a list of all known themes.
d102 1
a102 1
\fB\-sticky\fR \fB[\fInswe\fB]\fR
d105 1
a105 1
\fB\-children { \fIsublayout... \fB}\fR
@


1.3.2.6
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_style.n,v 1.3.2.5 2007/12/13 06:28:47 dgp Exp $
d61 1
a61 1
The only built-in element type is \fIimage\fR (see \fBttk_image\fR(n)),
d120 1
a120 1
ttk::intro(n), ttk::widget(n), photo(n), ttk_image(n)
@


1.2
log
@Convert \fP to \fR so that man-page scrapers have an easier time.
@
text
@d3 5
a7 1
'\" $Id: ttk_style.n,v 1.1 2006/10/31 01:42:25 hobbs Exp $
d13 1
a13 1
ttk::style \- Control overall look and feel of widgets
d17 1
d123 1
d125 2
a126 1
ttk_intro(n), ttk_widget(n), pixmap
@


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
@d3 1
a3 1
'\" $Id: style.n,v 1.12 2006/09/20 15:04:05 jenglish Exp $
d26 1
a26 1
this may be overridden by the \fB-style\fP option. 
d39 1
a39 1
the value corresponding to the first matching \fIstatespec\fP
d43 2
a44 2
Returns the value specified for \fI-option\fP in style \fIstyle\fP
in state \fIstate\fP, using the standard lookup rules for element options.
d47 2
a48 2
If the \fIdefault\fP argument is present, it is used as a fallback
value in case no specification for \fI-option\fP is found.
d73 2
a74 2
If \fI-settings\fR is present, \fIscript\fP is evaluated in the
context of the new theme as per \fBttk::style theme settings\fP.
d76 1
a76 1
\fBttk::style theme settings \fIthemeName\fP \fIscript\fP
d79 1
a79 1
Typically \fIscript\fP simply defines styles and elements,
d89 1
a89 1
A \fIlayout\fP specifies a list of elements, each followed
d91 1
a91 1
The layout mechanism uses a simplified version of the \fBpack\fP
d98 1
a98 1
one of \fBleft\fP, \fBright\fP, \fBtop\fP, or \fBbottom\fP.
@

