head	1.19;
access;
symbols
	core-8-5-9:1.15.2.2
	core-8-5-8:1.15.2.1
	macosx-cocoa-merge:1.19
	macosx-cocoa-premerge:1.19
	macosx-carbon-freeze:1.19
	core-8-5-7:1.15.2.1
	core-8-5-6:1.15.2.1
	core-8-6-b1:1.19
	core-8-6-a3:1.18
	core-8-5-5:1.15.2.1
	core-8-6-a2:1.17
	core-8-5-4:1.15.2.1
	core-8-5-3:1.15.2.1
	core-8-6-a1:1.16
	core-8-5-branch:1.15.0.2
	core-8-5-2:1.15
	core-8-5-1:1.14
	core-8-5-0:1.13
	core-8-5-b3:1.11
	core-8-5-b2:1.8
	core-8-5-b1:1.5
	core-stablilizer-merge:1.4
	core-stabilizer-branch:1.4.0.2
	core-stabilizer-merge:1.15.2.1
	core-8-5-a6:1.4;
locks; strict;
comment	@# @;


1.19
date	2008.10.27.13.38.51;	author dkf;	state Exp;
branches;
next	1.18;

1.18
date	2008.09.23.13.36.56;	author dkf;	state Exp;
branches;
next	1.17;

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

1.16
date	2008.05.09.18.35.00;	author patthoyts;	state Exp;
branches;
next	1.15;

1.15
date	2008.02.23.18.41.06;	author jenglish;	state Exp;
branches
	1.15.2.1;
next	1.14;

1.14
date	2008.01.29.15.38.00;	author dkf;	state Exp;
branches;
next	1.13;

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

1.12
date	2007.12.10.16.21.01;	author jenglish;	state Exp;
branches;
next	1.11;

1.11
date	2007.11.01.23.03.54;	author dkf;	state Exp;
branches;
next	1.10;

1.10
date	2007.11.01.10.59.42;	author dkf;	state Exp;
branches;
next	1.9;

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

1.8
date	2007.10.26.20.13.23;	author dgp;	state Exp;
branches;
next	1.7;

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

1.6
date	2007.10.22.14.33.13;	author dkf;	state Exp;
branches;
next	1.5;

1.5
date	2007.08.28.15.16.11;	author dkf;	state Exp;
branches;
next	1.4;

1.4
date	2006.12.17.21.09.46;	author jenglish;	state Exp;
branches
	1.4.2.1;
next	1.3;

1.3
date	2006.12.13.23.04.32;	author hobbs;	state Exp;
branches;
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.4.2.1
date	2007.09.04.17.44.21;	author dgp;	state Exp;
branches;
next	1.4.2.2;

1.4.2.2
date	2007.10.24.12.59.31;	author dgp;	state Exp;
branches;
next	1.4.2.3;

1.4.2.3
date	2007.10.27.04.23.14;	author dgp;	state Exp;
branches;
next	1.4.2.4;

1.4.2.4
date	2007.11.01.16.37.16;	author dgp;	state Exp;
branches;
next	1.4.2.5;

1.4.2.5
date	2007.11.02.14.51.39;	author dgp;	state Exp;
branches;
next	1.4.2.6;

1.4.2.6
date	2007.12.10.18.39.28;	author dgp;	state Exp;
branches;
next	1.4.2.7;

1.4.2.7
date	2008.01.29.17.35.48;	author dgp;	state Exp;
branches;
next	1.4.2.8;

1.4.2.8
date	2008.03.07.22.03.48;	author dgp;	state Exp;
branches;
next	1.4.2.9;

1.4.2.9
date	2008.06.25.16.46.02;	author dgp;	state Exp;
branches;
next	;

1.15.2.1
date	2008.05.11.00.31.01;	author patthoyts;	state Exp;
branches;
next	1.15.2.2;

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


desc
@@


1.19
log
@Tweaking for better readability.
@
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_combobox.n,v 1.18 2008/09/23 13:36:56 dkf Exp $
'\"
.so man.macros
.TH ttk::combobox n 8.5 Tk "Tk Themed Widget"
.BS
.SH NAME
ttk::combobox \- text field with popdown selection list
.SH SYNOPSIS
\fBttk::combobox\fR \fIpathName \fR?\fIoptions\fR?
.BE
.SH DESCRIPTION
.PP
A \fBttk::combobox\fR combines a text field with a pop-down list of values;
the user may select the value of the text field from among the 
values in the list.
.SO ttk_widget
\-class	\-cursor	\-takefocus
\-style
.SE
.\" ALSO: Other entry widget options
.SH "WIDGET-SPECIFIC OPTIONS"
.OP \-exportselection exportSelection ExportSelection
Boolean value.
If set, the widget selection is linked to the X selection.
.OP \-justify justify Justify
Specifies how the text is aligned within the widget.
Must be one of \fBleft\fR, \fBcenter\fR, or \fBright\fR.
.OP \-height height Height
Specifies the height of the pop-down listbox, in rows.
.OP \-postcommand postCommand PostCommand
A Tcl script to evaluate immediately before displaying the listbox.
The \fB\-postcommand\fR script may specify the \fB\-values\fR to display.
.OP \-state state State
One of \fBnormal\fR, \fBreadonly\fR, or \fBdisabled\fR.
In the \fBreadonly\fR state,
the value may not be edited directly, and 
the user can only select one of the \fB\-values\fR from the
dropdown list.
In the \fBnormal\fR state, 
the text field is directly editable.
In the \fBdisabled\fR state, no interaction is possible.
.OP \-textvariable textVariable TextVariable
Specifies the name of a variable whose value is linked 
to the widget value.
Whenever the variable changes value the widget value is updated,
and vice versa.
.OP \-values values Values
Specifies the list of values to display in the drop-down listbox.
.OP \-width width Width
Specifies an integer value indicating the desired width of the entry window,
in average-size characters of the widget's font.
.SH "WIDGET COMMAND"
.PP
The following subcommands are possible for combobox widgets:
'\".TP
'\"\fIpathName \fBcget\fR \fIoption\fR
'\"Returns the current value of the specified \fIoption\fR.
'\"See \fIttk::widget(n)\fR.
'\".TP
'\"\fIpathName \fBconfigure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?
'\"Modify or query widget options.
'\"See \fIttk::widget(n)\fR.
.TP
\fIpathName \fBcurrent\fR ?\fInewIndex\fR?
If \fInewIndex\fR is supplied, sets the combobox value 
to the element at position \fInewIndex\fR in the list of \fB\-values\fR.
Otherwise, returns the index of the current value in the list of
\fB\-values\fR or \fB\-1\fR if the current value does not appear in the list.
.TP
\fIpathName \fBget\fR
Returns the current value of the combobox.
'\".TP
'\"\fIpathName \fBidentify \fIx y\fR
'\"Returns the name of the element at position \fIx\fR, \fIy\fR.
'\"See \fIttk::widget(n)\fR.
'\".TP
'\"\fIpathName \fBinstate \fIstateSpec\fR ?\fIscript\fR?
'\"Test the widget state.
'\"See \fIttk::widget(n)\fR.
.TP
\fIpathName \fBset\fR \fIvalue\fR
Sets the value of the combobox to \fIvalue\fR.
'\".TP
'\"\fIpathName \fBstate\fR ?\fIstateSpec\fR?
'\"Modify or query the widget state.
'\"See \fIttk::widget(n)\fR.
.PP
The combobox widget also supports the following \fBttk::entry\fR
widget subcommands (see \fIttk::entry(n)\fR for details):
.DS
.ta 5.5c 11c
\fBbbox\fR	\fBdelete\fR	\fBicursor\fR
\fBindex\fR	\fBinsert\fR	\fBselection\fR
\fBxview\fR
.DE
The combobox widget also supports the following generic \fBttk::widget\fR
widget subcommands (see \fIttk::widget(n)\fR for details):
.DS
.ta 5.5c 11c
\fBcget\fR	\fBconfigure\fR	\fBidentify\fR
\fBinstate\fR	\fBstate\fR
.DE
.SH "VIRTUAL EVENTS"
.PP
The combobox widget generates a \fB<<ComboboxSelected>>\fR virtual event
when the user selects an element from the list of values.
If the selection action unposts the listbox,
this event is delivered after the listbox is unposted.
.SH "SEE ALSO"
ttk::widget(n), ttk::entry(n)
.SH KEYWORDS
choice, entry, list box, text box, widget
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.18
log
@Fix [Bug 2118116]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.17 2008/06/30 22:57:03 dkf Exp $
d33 1
a33 1
One of \fBleft\fR, \fBcenter\fR, or \fBright\fR.
d59 10
a68 8
.TP
\fIpathName \fBcget\fR \fIoption\fR
Returns the current value of the specified \fIoption\fR.
See \fIttk::widget(n)\fR.
.TP
\fIpathName \fBconfigure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?
Modify or query widget options.
See \fIttk::widget(n)\fR.
d78 8
a85 8
.TP
\fIpathName \fBidentify \fIx y\fR
Returns the name of the element at position \fIx\fR, \fIy\fR.
See \fIttk::widget(n)\fR.
.TP
\fIpathName \fBinstate \fIstateSpec\fR ?\fIscript\fR?
Test the widget state.
See \fIttk::widget(n)\fR.
d89 4
a92 4
.TP
\fIpathName \fBstate\fR ?\fIstateSpec\fR?
Modify or query the widget state.
See \fIttk::widget(n)\fR.
d94 2
a95 2
The combobox widget also supports the following \fIttk::entry\fR
widget commands (see \fIttk::entry(n)\fR for details):
d102 7
@


1.17
log
@Minor doc updates (removing out of date changebars, improving typedef formatting,
 etc.)
@
text
@a0 1
'\" -*- nroff -*-
d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.16 2008/05/09 18:35:00 patthoyts Exp $
d110 3
@


1.16
log
@Document the identify command as present on all ttk widgets
@
text
@d1 1
d8 1
a8 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.15 2008/02/23 18:41:06 jenglish Exp $
d19 1
d102 1
@


1.15
log
@Arrange to deliver <<ComboboxSelected>> event after listbox is unposted,
as intended [Bug 1890211].  Clarified documentation.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.14 2008/01/29 15:38:00 dkf Exp $
d77 2
a78 2
Returns the name of the element at position \fIx\fR, \fIy\fR,
or the empty string if the coordinates are outside the window.
@


1.15.2.1
log
@Backported documentation fixes from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.16 2008/05/09 18:35:00 patthoyts Exp $
d77 2
a78 2
Returns the name of the element at position \fIx\fR, \fIy\fR.
See \fIttk::widget(n)\fR.
@


1.15.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_combobox.n,v 1.19 2008/10/27 13:38:51 dkf Exp $
a17 1
.PP
d32 1
a32 1
Must be one of \fBleft\fR, \fBcenter\fR, or \fBright\fR.
d58 8
a65 10
.PP
The following subcommands are possible for combobox widgets:
'\".TP
'\"\fIpathName \fBcget\fR \fIoption\fR
'\"Returns the current value of the specified \fIoption\fR.
'\"See \fIttk::widget(n)\fR.
'\".TP
'\"\fIpathName \fBconfigure\fR ?\fIoption\fR? ?\fIvalue option value ...\fR?
'\"Modify or query widget options.
'\"See \fIttk::widget(n)\fR.
d75 8
a82 8
'\".TP
'\"\fIpathName \fBidentify \fIx y\fR
'\"Returns the name of the element at position \fIx\fR, \fIy\fR.
'\"See \fIttk::widget(n)\fR.
'\".TP
'\"\fIpathName \fBinstate \fIstateSpec\fR ?\fIscript\fR?
'\"Test the widget state.
'\"See \fIttk::widget(n)\fR.
d86 4
a89 4
'\".TP
'\"\fIpathName \fBstate\fR ?\fIstateSpec\fR?
'\"Modify or query the widget state.
'\"See \fIttk::widget(n)\fR.
d91 2
a92 2
The combobox widget also supports the following \fBttk::entry\fR
widget subcommands (see \fIttk::entry(n)\fR for details):
a98 7
The combobox widget also supports the following generic \fBttk::widget\fR
widget subcommands (see \fIttk::widget(n)\fR for details):
.DS
.ta 5.5c 11c
\fBcget\fR	\fBconfigure\fR	\fBidentify\fR
\fBinstate\fR	\fBstate\fR
.DE
a99 1
.PP
a107 3
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.14
log
@Adjusted handling of the standard options part of the Ttk manual pages so
that they are documented in the correct location. [Bug 1876493]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.13 2007/12/13 15:23:44 dgp Exp $
d102 2
a103 1
This event is generated after the listbox is unposted.
@


1.13
log
@merge stable branch onto HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.4.2.6 2007/12/10 18:39:28 dgp Exp $
d21 3
a23 2
.SO
\-class	\-cursor	\-takefocus	\-style
@


1.12
log
@Remove extra .BEs that got added by mistake somewhere.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.11 2007/11/01 23:03:54 dkf Exp $
@


1.11
log
@Fix .DS/.DE to work better when transformed to a table
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.10 2007/11/01 10:59:42 dkf Exp $
a55 1
.BE
@


1.10
log
@Make documentation use the name that scripts use as much as possible.
[Bug 1640073]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.9 2007/10/29 16:04:14 dkf Exp $
d95 3
a97 3
bbox	delete	icursor
index	insert	selection
xview
@


1.9
log
@Lots more GOOBE stuff. Now works with 'make html'!
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.8 2007/10/26 20:13:23 dgp Exp $
d10 1
a10 1
.TH ttk_combobox n 8.5 Tk "Tk Themed Widget"
a11 1
.\" Use _ instead of :: as the name becomes a filename on install
d13 1
a13 1
ttk_combobox \- text field with popdown selection list
a16 1

a24 1

a56 1

d61 1
a61 1
See \fIttk_widget(n)\fR.
d65 1
a65 1
See \fIttk_widget(n)\fR.
d82 1
a82 1
See \fIttk_widget(n)\fR.
d89 1
a89 1
See \fIttk_widget(n)\fR.
d92 1
a92 1
widget commands (see \fIttk_entry(n)\fR for details):
a98 1

a102 1

d104 1
a104 1
ttk_widget(n), ttk_entry(n)
@


1.8
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_combobox.n,v 1.5 2007/08/28 15:16:11 dkf Exp $
d39 1
a39 1
The \fB-postcommand\fR script may specify the \fB-values\fR to display.
d44 1
a44 1
the user can only select one of the \fB-values\fR from the
d73 3
a75 3
to the element at position \fInewIndex\fR in the list of \fB-values\fR.
Otherwise, returns the index of the current value in the list of \fB-values\fR
or \fB-1\fR if the current value does not appear in the list.
@


1.7
log
@Rendering-with-groff GOOBE.
@
text
@d6 2
a7 2
'\"
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.6 2007/10/22 14:33:13 dkf Exp $
d21 2
a22 2
the user may select the value of the text field from among the values in the
list.
d24 1
a24 2
\-class	\-cursor	\-takefocus
\-style
d27 1
d30 2
a31 1
Boolean value. If set, the widget selection is linked to the X selection.
d33 2
a34 2
Specifies how the text is aligned within the widget. One of \fBleft\fR,
\fBcenter\fR, or \fBright\fR.
d38 2
a39 2
A Tcl script to evaluate immediately before displaying the listbox. The
\fB\-postcommand\fR script may specify the \fB\-values\fR to display.
d41 8
a48 5
One of \fBnormal\fR, \fBreadonly\fR, or \fBdisabled\fR. In the \fBreadonly\fR
state, the value may not be edited directly, and the user can only select one
of the \fB\-values\fR from the dropdown list. In the \fBnormal\fR state, the
text field is directly editable. In the \fBdisabled\fR state, no interaction
is possible.
d50 4
a53 3
Specifies the name of a variable whose value is linked to the widget value.
Whenever the variable changes value the widget value is updated, and vice
versa.
d60 1
d64 2
a65 3
.
Returns the current value of the specified \fIoption\fR. See
\fIttk_widget(n)\fR.
d68 2
a69 2
.
Modify or query widget options. See \fIttk_widget(n)\fR.
d72 4
a75 5
.
If \fInewIndex\fR is supplied, sets the combobox value to the element at
position \fInewIndex\fR in the list of \fB\-values\fR. Otherwise, returns the
index of the current value in the list of \fB\-values\fR or \fB\-1\fR if the
current value does not appear in the list.
a77 1
.
d81 2
a82 3
.
Returns the name of the element at position \fIx\fR, \fIy\fR, or the empty
string if the coordinates are outside the window.
d85 2
a86 2
.
Test the widget state. See \fIttk_widget(n)\fR.
a88 1
.
d92 2
a93 2
.
Modify or query the widget state. See \fIttk_widget(n)\fR.
d95 2
a96 2
The combobox widget also supports the following \fIttk::entry\fR widget
commands (see \fIttk_entry(n)\fR for details):
d103 1
d105 4
a108 3
The combobox widget generates a \fB<<ComboboxSelected>>\fR virtual event when
the user selects an element from the list of values. This event is generated
after the listbox is unposted.
@


1.6
log
@Documentation improvements, all minor.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.5 2007/08/28 15:16:11 dkf Exp $
d24 2
a25 1
\-class	\-cursor	\-takefocus	\-style
a27 1

a54 1

a101 1

a105 1

@


1.5
log
@Assorted documentation improvements.
@
text
@d6 2
a7 2
'\" 
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.4 2006/12/17 21:09:46 jenglish Exp $
d21 2
a22 2
the user may select the value of the text field from among the 
values in the list.
d30 1
a30 2
Boolean value.
If set, the widget selection is linked to the X selection.
d32 2
a33 2
Specifies how the text is aligned within the widget.
One of \fBleft\fR, \fBcenter\fR, or \fBright\fR.
d37 2
a38 2
A Tcl script to evaluate immediately before displaying the listbox.
The \fB-postcommand\fR script may specify the \fB-values\fR to display.
d40 5
a44 8
One of \fBnormal\fR, \fBreadonly\fR, or \fBdisabled\fR.
In the \fBreadonly\fR state,
the value may not be edited directly, and 
the user can only select one of the \fB-values\fR from the
dropdown list.
In the \fBnormal\fR state, 
the text field is directly editable.
In the \fBdisabled\fR state, no interaction is possible.
d46 3
a48 4
Specifies the name of a variable whose value is linked 
to the widget value.
Whenever the variable changes value the widget value is updated,
and vice versa.
d59 3
a61 2
Returns the current value of the specified \fIoption\fR.
See \fIttk_widget(n)\fR.
d64 2
a65 2
Modify or query widget options.
See \fIttk_widget(n)\fR.
d68 5
a72 4
If \fInewIndex\fR is supplied, sets the combobox value 
to the element at position \fInewIndex\fR in the list of \fB-values\fR.
Otherwise, returns the index of the current value in the list of \fB-values\fR
or \fB-1\fR if the current value does not appear in the list.
d75 1
d79 3
a81 2
Returns the name of the element at position \fIx\fR, \fIy\fR,
or the empty string if the coordinates are outside the window.
d84 2
a85 2
Test the widget state.
See \fIttk_widget(n)\fR.
d88 1
d92 2
a93 2
Modify or query the widget state.
See \fIttk_widget(n)\fR.
d95 2
a96 2
The combobox widget also supports the following \fIttk::entry\fR
widget commands (see \fIttk_entry(n)\fR for details):
d105 3
a107 3
The combobox widget generates a \fB<<ComboboxSelected>>\fR virtual event
when the user selects an element from the list of values.
This event is generated after the listbox is unposted.
@


1.4
log
@Add combobox -height option; only show scrollbar if the listbox
needs to scroll [#1032869].
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.3 2006/12/13 23:04:32 hobbs Exp $
d111 2
@


1.4.2.1
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.4 2006/12/17 21:09:46 jenglish Exp $
a110 2
.SH KEYWORDS
choice, entry, list box, text box, widget
@


1.4.2.2
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.4.2.1 2007/09/04 17:44:21 dgp Exp $
d21 2
a22 2
the user may select the value of the text field from among the values in the
list.
d24 1
a24 2
\-class	\-cursor	\-takefocus
\-style
d27 1
d30 2
a31 1
Boolean value. If set, the widget selection is linked to the X selection.
d33 2
a34 2
Specifies how the text is aligned within the widget. One of \fBleft\fR,
\fBcenter\fR, or \fBright\fR.
d38 2
a39 2
A Tcl script to evaluate immediately before displaying the listbox. The
\fB\-postcommand\fR script may specify the \fB\-values\fR to display.
d41 8
a48 5
One of \fBnormal\fR, \fBreadonly\fR, or \fBdisabled\fR. In the \fBreadonly\fR
state, the value may not be edited directly, and the user can only select one
of the \fB\-values\fR from the dropdown list. In the \fBnormal\fR state, the
text field is directly editable. In the \fBdisabled\fR state, no interaction
is possible.
d50 4
a53 3
Specifies the name of a variable whose value is linked to the widget value.
Whenever the variable changes value the widget value is updated, and vice
versa.
d60 1
d64 2
a65 3
.
Returns the current value of the specified \fIoption\fR. See
\fIttk_widget(n)\fR.
d68 2
a69 2
.
Modify or query widget options. See \fIttk_widget(n)\fR.
d72 4
a75 5
.
If \fInewIndex\fR is supplied, sets the combobox value to the element at
position \fInewIndex\fR in the list of \fB\-values\fR. Otherwise, returns the
index of the current value in the list of \fB\-values\fR or \fB\-1\fR if the
current value does not appear in the list.
a77 1
.
d81 2
a82 3
.
Returns the name of the element at position \fIx\fR, \fIy\fR, or the empty
string if the coordinates are outside the window.
d85 2
a86 2
.
Test the widget state. See \fIttk_widget(n)\fR.
a88 1
.
d92 2
a93 2
.
Modify or query the widget state. See \fIttk_widget(n)\fR.
d95 2
a96 2
The combobox widget also supports the following \fIttk::entry\fR widget
commands (see \fIttk_entry(n)\fR for details):
d103 1
d105 4
a108 3
The combobox widget generates a \fB<<ComboboxSelected>>\fR virtual event when
the user selects an element from the list of values. This event is generated
after the listbox is unposted.
@


1.4.2.3
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.4.2.2 2007/10/24 12:59:31 dgp Exp $
d21 2
a22 2
the user may select the value of the text field from among the 
values in the list.
d24 2
a25 1
\-class	\-cursor	\-takefocus	\-style
a27 1

d30 1
a30 2
Boolean value.
If set, the widget selection is linked to the X selection.
d32 2
a33 2
Specifies how the text is aligned within the widget.
One of \fBleft\fR, \fBcenter\fR, or \fBright\fR.
d37 2
a38 2
A Tcl script to evaluate immediately before displaying the listbox.
The \fB-postcommand\fR script may specify the \fB-values\fR to display.
d40 5
a44 8
One of \fBnormal\fR, \fBreadonly\fR, or \fBdisabled\fR.
In the \fBreadonly\fR state,
the value may not be edited directly, and 
the user can only select one of the \fB-values\fR from the
dropdown list.
In the \fBnormal\fR state, 
the text field is directly editable.
In the \fBdisabled\fR state, no interaction is possible.
d46 3
a48 4
Specifies the name of a variable whose value is linked 
to the widget value.
Whenever the variable changes value the widget value is updated,
and vice versa.
a54 1

d58 3
a60 2
Returns the current value of the specified \fIoption\fR.
See \fIttk_widget(n)\fR.
d63 2
a64 2
Modify or query widget options.
See \fIttk_widget(n)\fR.
d67 5
a71 4
If \fInewIndex\fR is supplied, sets the combobox value 
to the element at position \fInewIndex\fR in the list of \fB-values\fR.
Otherwise, returns the index of the current value in the list of \fB-values\fR
or \fB-1\fR if the current value does not appear in the list.
d74 1
d78 3
a80 2
Returns the name of the element at position \fIx\fR, \fIy\fR,
or the empty string if the coordinates are outside the window.
d83 2
a84 2
Test the widget state.
See \fIttk_widget(n)\fR.
d87 1
d91 2
a92 2
Modify or query the widget state.
See \fIttk_widget(n)\fR.
d94 2
a95 2
The combobox widget also supports the following \fIttk::entry\fR
widget commands (see \fIttk_entry(n)\fR for details):
a101 1

d103 3
a105 4
The combobox widget generates a \fB<<ComboboxSelected>>\fR virtual event
when the user selects an element from the list of values.
This event is generated after the listbox is unposted.

@


1.4.2.4
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id$
d10 1
a10 1
.TH ttk::combobox n 8.5 Tk "Tk Themed Widget"
d12 1
d14 1
a14 1
ttk::combobox \- text field with popdown selection list
d18 1
d27 1
d39 1
a39 1
The \fB\-postcommand\fR script may specify the \fB\-values\fR to display.
d44 1
a44 1
the user can only select one of the \fB\-values\fR from the
d60 1
d65 1
a65 1
See \fIttk::widget(n)\fR.
d69 1
a69 1
See \fIttk::widget(n)\fR.
d73 3
a75 3
to the element at position \fInewIndex\fR in the list of \fB\-values\fR.
Otherwise, returns the index of the current value in the list of
\fB\-values\fR or \fB\-1\fR if the current value does not appear in the list.
d86 1
a86 1
See \fIttk::widget(n)\fR.
d93 1
a93 1
See \fIttk::widget(n)\fR.
d96 1
a96 1
widget commands (see \fIttk::entry(n)\fR for details):
d103 1
d108 1
d110 1
a110 1
ttk::widget(n), ttk::entry(n)
@


1.4.2.5
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.4.2.4 2007/11/01 16:37:16 dgp Exp $
d95 3
a97 3
\fBbbox\fR	\fBdelete\fR	\fBicursor\fR
\fBindex\fR	\fBinsert\fR	\fBselection\fR
\fBxview\fR
@


1.4.2.6
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.4.2.5 2007/11/02 14:51:39 dgp Exp $
d56 1
@


1.4.2.7
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.13 2007/12/13 15:23:44 dgp Exp $
d21 2
a22 3
.SO ttk_widget
\-class	\-cursor	\-takefocus
\-style
@


1.4.2.8
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.4.2.7 2008/01/29 17:35:48 dgp Exp $
d102 1
a102 2
If the selection action unposts the listbox,
this event is delivered after the listbox is unposted.
@


1.4.2.9
log
@merge updates from 8.5 branch
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_combobox.n,v 1.4.2.8 2008/03/07 22:03:48 dgp Exp $
d77 2
a78 2
Returns the name of the element at position \fIx\fR, \fIy\fR.
See \fIttk::widget(n)\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 $
d35 2
@


1.2
log
@Convert \fP to \fR so that man-page scrapers have an easier time.
@
text
@d4 5
d12 1
d14 1
a14 1
ttk::combobox \- text field with popdown selection list
d17 6
d27 1
d58 1
a58 4
.SH DESCRIPTION
A combobox combines a text field with a pop-down list of values;
the user may select the value of the text field from among the 
values in the list.
d63 1
a63 1
See \fIwidget(n)\fR.
d67 1
a67 1
See \fIwidget(n)\fR.
d82 1
a82 1
\fIpathName \fBinstate \fIstatespec\fR ?\fIscript\fR?
d84 1
a84 1
See \fIwidget(n)\fR.
d91 1
a91 1
See \fIwidget(n)\fR.
d93 2
a94 2
The combobox widget also supports the following \fIentry\fR
widget commands (see \fIentry(n)\fR for details):
d101 1
d106 1
d108 1
a108 1
widget(n), entry(n)
@


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
@d21 1
a21 1
One of \fBleft\fP, \fBcenter\fP, or \fBright\fP.
d24 1
a24 1
The \fB-postcommand\fP script may specify the \fB-values\fP to display.
d26 2
a27 2
One of \fBnormal\fR, \fBreadonly\fR, or \fBdisabled\fP.
In the \fBreadonly\fP state,
d29 1
a29 1
the user can only select one of the \fB-values\fP from the
d31 1
a31 1
In the \fBnormal\fP state, 
d33 1
a33 1
In the \fBdisabled\fP state, no interaction is possible.
d52 2
a53 2
Returns the current value of the specified \fIoption\fP.
See \fIwidget(n)\fP.
d57 1
a57 1
See \fIwidget(n)\fP.
d60 1
a60 1
If \fInewIndex\fP is supplied, sets the combobox value 
d69 1
a69 1
Returns the name of the element at position \fIx\fP, \fIy\fP,
d74 1
a74 1
See \fIwidget(n)\fP.
d77 1
a77 1
Sets the value of the combobox to \fIvalue\fP.
d81 1
a81 1
See \fIwidget(n)\fP.
d83 2
a84 2
The combobox widget also supports the following \fIentry\fP
widget commands (see \fIentry(n)\fP for details):
d92 1
a92 1
The combobox widget generates a \fB<<ComboboxSelected>>\fP virtual event
@

