summaryrefslogtreecommitdiffstats
path: root/tk8.6/doc/ttk_style.n
diff options
context:
space:
mode:
Diffstat (limited to 'tk8.6/doc/ttk_style.n')
-rw-r--r--tk8.6/doc/ttk_style.n131
1 files changed, 0 insertions, 131 deletions
diff --git a/tk8.6/doc/ttk_style.n b/tk8.6/doc/ttk_style.n
deleted file mode 100644
index 985e3cd..0000000
--- a/tk8.6/doc/ttk_style.n
+++ /dev/null
@@ -1,131 +0,0 @@
-'\"
-'\" 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.
-'\"
-.TH ttk::style n 8.5 Tk "Tk Themed Widget"
-.so man.macros
-.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: