summaryrefslogtreecommitdiffstats
path: root/doc/listbox.n
diff options
context:
space:
mode:
authorhobbs <hobbs>2002-06-21 02:38:54 (GMT)
committerhobbs <hobbs>2002-06-21 02:38:54 (GMT)
commit093ba20aa9429d1193d14f69c01efa197fb23b02 (patch)
tree614fdb1ec8759677a120bdac4fb4edd69daa4b17 /doc/listbox.n
parentee7d851982f1cba4efafa2b2246864b17c11bad6 (diff)
downloadtk-093ba20aa9429d1193d14f69c01efa197fb23b02.zip
tk-093ba20aa9429d1193d14f69c01efa197fb23b02.tar.gz
tk-093ba20aa9429d1193d14f69c01efa197fb23b02.tar.bz2
* doc/listbox.n:
* generic/tkListbox.c (DisplayListbox): * mac/tkMacDefault.h: TIP #94 implementation adding -activestyle * tests/listbox.test: option to the listbox. This adds the ability * unix/tkUnixDefault.h: to have listboxes look native on Windows, and * win/tkWinDefault.h: "nicer" elsewhere using the 'dotbox' style.
Diffstat (limited to 'doc/listbox.n')
-rw-r--r--doc/listbox.n35
1 files changed, 22 insertions, 13 deletions
diff --git a/doc/listbox.n b/doc/listbox.n
index cd1067c..7326497 100644
--- a/doc/listbox.n
+++ b/doc/listbox.n
@@ -5,10 +5,10 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: listbox.n,v 1.8 2000/08/25 06:58:32 ericm Exp $
+'\" RCS: @(#) $Id: listbox.n,v 1.9 2002/06/21 02:38:54 hobbs Exp $
'\"
.so man.macros
-.TH listbox n 8.0 Tk "Tk Built-In Commands"
+.TH listbox n 8.4 Tk "Tk Built-In Commands"
.BS
'\" Note: do not modify the .SH NAME line immediately below!
.SH NAME
@@ -16,15 +16,24 @@ listbox \- Create and manipulate listbox widgets
.SH SYNOPSIS
\fBlistbox\fR \fIpathName \fR?\fIoptions\fR?
.SO
-\-background \-height \-selectforeground
-\-borderwidth \-highlightbackground \-setgrid
-\-cursor \-highlightcolor \-state
-\-disabledforeground \-highlightthickness \-takefocus
-\-exportselection \-relief \-width
-\-font \-selectbackground \-xscrollcommand
-\-foreground \-selectborderwidth \-yscrollcommand
+\-activestyle \-height \-selectforeground
+\-background \-highlightbackground \-setgrid
+\-borderwidth \-highlightcolor \-state
+\-cursor \-highlightthickness \-takefocus
+\-disabledforeground \-relief \-width
+\-exportselection \-selectbackground \-xscrollcommand
+\-font \-selectborderwidth \-yscrollcommand
+\-foreground
.SE
.SH "WIDGET-SPECIFIC OPTIONS"
+.VS 8.4
+.OP \-activestyle activeStyle ActiveStyle
+Specifies the style in which to draw the active element. This must be
+one of \fBdotbox\fR (show a focus ring around the active element),
+\fBnone\fR (nospecial indication of active element) or
+\fBunderline\fR (underline the active element).
+The default is \fBunderline\fR.
+.VS 8.4
.OP \-height height Height
Specifies the desired height for the window, in lines.
If zero or less, then the desired height for the window is made just
@@ -100,8 +109,8 @@ to the first element in the listbox.
.TP 12
\fBactive\fR
Indicates the element that has the location cursor. This element
-will be displayed with an underline when the listbox has the
-keyboard focus, and it is specified with the \fBactivate\fR
+will be displayed as specified by \fB\-activestyle\fR when the listbox
+has the keyboard focus, and it is specified with the \fBactivate\fR
widget command.
.TP 12
\fBanchor\fR
@@ -145,8 +154,8 @@ Sets the active element to the one indicated by \fIindex\fR.
If \fIindex\fR is outside the range of elements in the listbox
then the closest element is activated.
.VE
-The active element is drawn with an underline when the widget
-has the input focus, and its index may be retrieved with the
+The active element is drawn as specified by \fB\-activestyle\fR when the
+widget has the input focus, and its index may be retrieved with the
index \fBactive\fR.
.TP
\fIpathName \fBbbox\fR \fIindex\fR