diff options
author | dgp <dgp@users.sourceforge.net> | 2007-10-24 12:59:29 (GMT) |
---|---|---|
committer | dgp <dgp@users.sourceforge.net> | 2007-10-24 12:59:29 (GMT) |
commit | e45899dfe4a136045461e8d0a243333b8ea5772d (patch) | |
tree | 355358c10e10a1d3a4082cb6e6a24a379af08bd8 /doc/ttk_combobox.n | |
parent | 1716dd0b177db2823c1a9db54804b2ff72749534 (diff) | |
download | tk-e45899dfe4a136045461e8d0a243333b8ea5772d.zip tk-e45899dfe4a136045461e8d0a243333b8ea5772d.tar.gz tk-e45899dfe4a136045461e8d0a243333b8ea5772d.tar.bz2 |
merge updates from HEAD
Diffstat (limited to 'doc/ttk_combobox.n')
-rw-r--r-- | doc/ttk_combobox.n | 87 |
1 files changed, 42 insertions, 45 deletions
diff --git a/doc/ttk_combobox.n b/doc/ttk_combobox.n index 027c661..c18f8a5 100644 --- a/doc/ttk_combobox.n +++ b/doc/ttk_combobox.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_combobox.n,v 1.4.2.1 2007/09/04 17:44:21 dgp Exp $ +'\" RCS: @(#) $Id: ttk_combobox.n,v 1.4.2.2 2007/10/24 12:59:31 dgp Exp $ '\" .so man.macros .TH ttk_combobox n 8.5 Tk "Tk Themed Widget" @@ -18,94 +18,91 @@ ttk_combobox \- text field with popdown selection list .SH DESCRIPTION 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. +the user may select the value of the text field from among the values in the +list. .SO -\-class \-cursor \-takefocus \-style +\-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. +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. -One of \fBleft\fR, \fBcenter\fR, or \fBright\fR. +Specifies how the text is aligned within the widget. 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. +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. +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. +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. .BE - .SH "WIDGET COMMAND" .TP \fIpathName \fBcget\fR \fIoption\fR -Returns the current value of the specified \fIoption\fR. -See \fIttk_widget(n)\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. +. +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. +. +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, -or the empty string if the coordinates are outside the window. +. +Returns the name of the element at position \fIx\fR, \fIy\fR, or the empty +string if the coordinates are outside the window. .TP \fIpathName \fBinstate \fIstateSpec\fR ?\fIscript\fR? -Test the widget state. -See \fIttk_widget(n)\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. +. +Modify or query the widget state. See \fIttk_widget(n)\fR. .PP -The combobox widget also supports the following \fIttk::entry\fR -widget commands (see \fIttk_entry(n)\fR for details): +The combobox widget also supports the following \fIttk::entry\fR widget +commands (see \fIttk_entry(n)\fR for details): .DS .ta 5.5c 11c bbox delete icursor index insert selection xview .DE - .SH "VIRTUAL EVENTS" -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. - +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. .SH "SEE ALSO" ttk_widget(n), ttk_entry(n) .SH KEYWORDS |