summaryrefslogtreecommitdiffstats
path: root/doc/ttk_intro.n
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ttk_intro.n')
-rw-r--r--doc/ttk_intro.n9
1 files changed, 8 insertions, 1 deletions
diff --git a/doc/ttk_intro.n b/doc/ttk_intro.n
index c85bc83..d3cebc9 100644
--- a/doc/ttk_intro.n
+++ b/doc/ttk_intro.n
@@ -1,10 +1,11 @@
+'\" -*- nroff -*-
'\"
'\" 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_intro.n,v 1.10 2007/12/13 15:23:44 dgp Exp $
+'\" RCS: @(#) $Id: ttk_intro.n,v 1.11 2008/06/30 22:57:03 dkf Exp $
'\"
.so man.macros
.TH ttk::intro n 8.5 Tk "Tk Themed Widget"
@@ -13,6 +14,7 @@
ttk::intro \- Introduction to the Tk theme engine
.BE
.SH "OVERVIEW"
+.PP
The Tk themed widget set is based on a revised and enhanced version
of TIP #48 (http://tip.tcl.tk/48) specified style engine.
The main concepts are described below.
@@ -23,6 +25,7 @@ Widget class bindings are primarily responsible for
maintaining the widget state and invoking callbacks;
all aspects of the widgets appearance is
.SH "THEMES"
+.PP
A \fItheme\fR is a collection of elements and styles
that determine the look and feel of the widget set.
Themes can be used to:
@@ -39,6 +42,7 @@ Blend in with the rest of the desktop (Gnome, KDE, Java)
.IP \(bu
And, of course: eye candy.
.SH "ELEMENTS"
+.PP
An \fIelement\fR displays an individual part of a widget.
For example, a vertical scrollbar widget contains \fBuparrow\fR,
\fBdownarrow\fR, \fBtrough\fR and \fBslider\fR elements.
@@ -68,6 +72,7 @@ The default setting specified by \fBstyle configure\fR; or
.IP \(bu
The element's built-in default value for the option.
.SH "LAYOUTS"
+.PP
A \fIlayout\fR specifies which elements make up a widget
and how they are arranged.
The layout engine uses a simplified version of the \fBpack\fR
@@ -90,6 +95,7 @@ By default, the layout for a widget is the same as its class name.
Some widgets may override this (for example, the \fBttk::scrollbar\fR
widget chooses different layouts based on the \fB\-orient\fR option).
.SH "STATES"
+.PP
In standard Tk, many widgets have a \fB\-state\fR option
which (in most cases) is either \fBnormal\fR or \fBdisabled\fR.
Some widgets support additional states, such
@@ -135,6 +141,7 @@ but not by much).
.PP
\fINote to self: rewrite that paragraph. It's horrible.\fR
.SH "STYLES"
+.PP
Each widget is associated with a \fIstyle\fR,
which specifies values for element options.
Style names use a recursive dotted notation like layouts and elements;