summaryrefslogtreecommitdiffstats
path: root/doc/ttk_widget.n
diff options
context:
space:
mode:
authordonal.k.fellows@manchester.ac.uk <dkf>2007-10-29 16:04:11 (GMT)
committerdonal.k.fellows@manchester.ac.uk <dkf>2007-10-29 16:04:11 (GMT)
commit5eaf68c490e9e7de82be2e6e47fc397a91bc691e (patch)
treef1b13d0b63bdcb785dc2718534eb209b9796d50b /doc/ttk_widget.n
parent2c668436acdb25704f5a702b57ff4c764eb6f99e (diff)
downloadtk-5eaf68c490e9e7de82be2e6e47fc397a91bc691e.zip
tk-5eaf68c490e9e7de82be2e6e47fc397a91bc691e.tar.gz
tk-5eaf68c490e9e7de82be2e6e47fc397a91bc691e.tar.bz2
Lots more GOOBE stuff. Now works with 'make html'!
Diffstat (limited to 'doc/ttk_widget.n')
-rw-r--r--doc/ttk_widget.n62
1 files changed, 38 insertions, 24 deletions
diff --git a/doc/ttk_widget.n b/doc/ttk_widget.n
index b2e2e0b..f6cf9db 100644
--- a/doc/ttk_widget.n
+++ b/doc/ttk_widget.n
@@ -4,7 +4,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: ttk_widget.n,v 1.8 2007/10/26 20:13:23 dgp Exp $
+'\" RCS: @(#) $Id: ttk_widget.n,v 1.9 2007/10/29 16:04:14 dkf Exp $
'\"
.so man.macros
.TH ttk_widget n 8.5 Tk "Tk Themed Widget"
@@ -61,7 +61,10 @@ that is visible in the window, and the second fraction indicates
the information just after the last portion that is visible.
.br
Typically the \fBxScrollCommand\fR option consists of the path name
-of a \fBscrollbar\fR widget followed by ``set'', e.g. ``.x.scrollbar set''.
+of a \fBscrollbar\fR widget followed by
+.QW set ,
+e.g.
+.QW ".x.scrollbar set" .
This will cause the scrollbar to be updated whenever the view in the
window changes.
.br
@@ -69,17 +72,17 @@ If this option is set to the empty string (the default),
then no command is be executed.
.OP \-yscrollcommand yScrollCommand ScrollCommand
A command prefix, used to communicate with vertical scrollbars.
-See the description of \fB-xscrollcommand\fR above for details.
+See the description of \fB\-xscrollcommand\fR above for details.
.SH "LABEL OPTIONS"
The following options are supported by labels, buttons,
and other button-like widgets:
.OP \-text text Text
Specifies a text string to be displayed inside the widget
-(unless overridden by \fB-textvariable\fR).
+(unless overridden by \fB\-textvariable\fR).
.OP \-textvariable textVariable Variable
Specifies the name of variable whose value will be used
-in place of the \fB-text\fR resource.
+in place of the \fB\-text\fR resource.
.OP \-underline underline Underline
If set, specifies the integer index (0-based) of a character to underline
in the text string.
@@ -94,7 +97,7 @@ the widget is in a particular state or combination of states.
All images in the list should have the same size.
.OP \-compound compound Compound
Specifies how to display the image relative to the text,
-in the case both \fB-text\fR and \fB-image\fR are present.
+in the case both \fB\-text\fR and \fB\-image\fR are present.
Valid values are:
.RS
.IP text
@@ -116,15 +119,14 @@ If greater than zero, specifies how much space, in character widths,
to allocate for the text label.
If less than zero, specifies a minimum width.
If zero or unspecified, the natural width of the text label is used.
-
.SH "COMPATIBILITY OPTIONS"
.OP \-state state State
May be set to \fBnormal\fR or \fBdisabled\fR
to control the \fBdisabled\fR state bit.
-This is a ``write-only'' option: setting it changes the
-widget state, but the \fBstate\fR widget command does
-not affect the state option.
-
+This is a
+.QW write-only
+option: setting it changes the widget state, but the \fBstate\fR
+widget command does not affect the state option.
.SH COMMANDS
.TP
\fIpathName \fBcget\fR \fIoption\fR
@@ -174,24 +176,37 @@ Widget state flags include:
.TP
\fBactive\fR
The mouse cursor is over the widget
-and pressing a mouse button will cause some action to occur.
-(aka "prelight" (Gnome), "hot" (Windows), "hover").
+and pressing a mouse button will cause some action to occur. (aka
+.QW prelight
+(Gnome),
+.QW hot
+(Windows),
+.QW hover ).
.TP
\fBdisabled\fR
-Widget is disabled under program control
-(aka "unavailable", "inactive")
+Widget is disabled under program control (aka
+.QW unavailable ,
+.QW inactive )
.TP
\fBfocus\fR
Widget has keyboard focus
.TP
\fBpressed\fR
-Widget is being pressed (aka "armed" in Motif).
+Widget is being pressed (aka
+.QW armed
+in Motif).
.TP
\fBselected\fR
-"On", "true", or "current" for things like checkbuttons and radiobuttons.
+.QW On ,
+.QW true ,
+or
+.QW current
+for things like checkbuttons and radiobuttons.
.TP
\fBbackground\fR
-Windows and the Mac have a notion of an "active" or foreground window.
+Windows and the Mac have a notion of an
+.QW active
+or foreground window.
The \fBbackground\fR state is set for widgets in a background window,
and cleared for those in the foreground window.
.TP
@@ -200,9 +215,11 @@ Widget should not allow user modification.
.TP
\fBalternate\fR
A widget-specific alternate display format.
-For example, used for checkbuttons and radiobuttons
-in the "tristate" or "mixed" state,
-and for buttons with \fB-default active\fR.
+For example, used for checkbuttons and radiobuttons in the
+.QW tristate
+or
+.QW mixed
+state, and for buttons with \fB\-default active\fR.
.TP
\fBinvalid\fR
The widget's value is invalid.
@@ -212,7 +229,6 @@ entry widget value failed validation.)
A \fIstate specification\fR or \fIstateSpec\fR is a list
of state names, optionally prefixed with an exclamation point (!)
indicating that the bit is off.
-
.SH EXAMPLES
.CS
set b [ttk::button .b]
@@ -226,9 +242,7 @@ $b instate {pressed !disabled} { .b invoke }
# Reenable widget:
$b state !disabled
.CE
-
.SH "SEE ALSO"
ttk_intro(n), style(n)
-
.SH KEYWORDS
state, configure, option