307 lines
8.5 KiB
HTML
307 lines
8.5 KiB
HTML
<HTML>
|
|
<HEAD><TITLE>ComboBox</TITLE></HEAD>
|
|
<BODY BGCOLOR=white>
|
|
<DL><DT><I><A HREF="#descr">NAME</A></I></DT>
|
|
<DD><B>ComboBox</B>
|
|
- ComboBox widget
|
|
</DD></DL>
|
|
<DL>
|
|
<DT><I>CREATION</I></DT>
|
|
<DD><A HREF="#descr"><B>ComboBox</B></A> <I>pathName</I> ?<I>option value...</I>?</DD>
|
|
</DL>
|
|
<DL>
|
|
<DT><I><A HREF="ArrowButton.html">OPTIONS from <B>ArrowButton</B></A></I></DT>
|
|
<DD><TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0>
|
|
<TR>
|
|
<TD> -background or -bg</TD>
|
|
<TD> -disabledforeground</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -foreground or -fg</TD>
|
|
<TD> -state</TD>
|
|
</TR>
|
|
</TABLE></DD>
|
|
</DL>
|
|
<DL>
|
|
<DT><I><A HREF="Entry.html">OPTIONS from <B>Entry</B></A></I></DT>
|
|
<DD><TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0>
|
|
<TR>
|
|
<TD> -command</TD>
|
|
<TD> -disabledforeground</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -dragenabled</TD>
|
|
<TD> -dragendcmd</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -dragevent</TD>
|
|
<TD> -draginitcmd</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -dragtype</TD>
|
|
<TD> -dropcmd</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -dropenabled</TD>
|
|
<TD> -dropovercmd</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -droptypes</TD>
|
|
<TD> -editable</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -entrybg (see <B>-background</B>)</TD>
|
|
<TD> -entryfg (see <B>-foreground</B>)</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -exportselection</TD>
|
|
<TD> -font</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -helptext</TD>
|
|
<TD> -helptype</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -helpvar</TD>
|
|
<TD> -highlightbackground</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -highlightcolor</TD>
|
|
<TD> -highlightthickness</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -insertbackground</TD>
|
|
<TD> -insertborderwidth</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -insertofftime</TD>
|
|
<TD> -insertontime</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -insertwidth</TD>
|
|
<TD> -justify</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -selectbackground</TD>
|
|
<TD> -selectborderwidth</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -selectforeground</TD>
|
|
<TD> -show</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -state</TD>
|
|
<TD> -takefocus</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -text</TD>
|
|
<TD> -textvariable</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -width</TD>
|
|
<TD> -xscrollcommand</TD>
|
|
</TR>
|
|
</TABLE></DD>
|
|
</DL>
|
|
<DL>
|
|
<DT><I><A HREF="LabelFrame.html">OPTIONS from <B>LabelFrame</B></A></I></DT>
|
|
<DD><TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0>
|
|
<TR>
|
|
<TD> -background or -bg</TD>
|
|
<TD> -borderwidth or -bd</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -disabledforeground</TD>
|
|
<TD> -foreground or -fg</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -helptext</TD>
|
|
<TD> -helptype</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -helpvar</TD>
|
|
<TD> -label (see <B>-text</B>)</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -labelanchor (see <B>-anchor</B>)</TD>
|
|
<TD> -labelfont (see <B>-font</B>)</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -labelheight (see <B>-height</B>)</TD>
|
|
<TD> -labeljustify (see <B>-justify</B>)</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -labelwidth (see <B>-width</B>)</TD>
|
|
<TD> -name</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -padx</TD>
|
|
<TD> -pady</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -relief</TD>
|
|
<TD> -side</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -state</TD>
|
|
<TD> -underline</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -wraplength</TD>
|
|
</TABLE></DD>
|
|
</DL>
|
|
<DL>
|
|
<DT><I><A HREF="#wso">WIDGET-SPECIFIC OPTIONS</A></I></DT>
|
|
<DD><TABLE CELLSPACING=0 CELLSPACING=0 BORDER=0>
|
|
<TR>
|
|
<TD> <A HREF="#-height">-height</A></TR>
|
|
<TD> <A HREF="#-modifycmd">-modifycmd</A></TR>
|
|
</TR>
|
|
<TR>
|
|
<TD> <A HREF="#-postcommand">-postcommand</A></TR>
|
|
<TD> <A HREF="#-values">-values</A></TR>
|
|
</TR>
|
|
</TABLE></DD>
|
|
</DL>
|
|
<DL>
|
|
<DT><I><A HREF="#wc">WIDGET COMMAND</A></I></DT>
|
|
<DD><I>pathName</I> <A HREF="#bind"><B>bind</B></A>
|
|
?<I>arg...</I>?
|
|
</DD>
|
|
<DD><I>pathName</I> <A HREF="#cget"><B>cget</B></A>
|
|
<I>option</I>
|
|
</DD>
|
|
<DD><I>pathName</I> <A HREF="#configure"><B>configure</B></A>
|
|
?<I>option</I>? ?<I>value</I> <I>option</I> <I>value</I> ...?
|
|
</DD>
|
|
<DD><I>pathName</I> <A HREF="#getvalue"><B>getvalue</B></A>
|
|
</DD>
|
|
<DD><I>pathName</I> <A HREF="#setvalue"><B>setvalue</B></A>
|
|
<I>index</I>
|
|
</DD>
|
|
</DL>
|
|
<BR><HR WIDTH="100%"><BR>
|
|
<B><A NAME="descr"></A>DESCRIPTION</B><BR>
|
|
<P>
|
|
|
|
ComboBox widget enables the user to select a value among a list given by the <B>values</B> option.
|
|
The list of possible values can be popped by pressing the ArrowButton or by clicking in the entry
|
|
when <B>editable</B> value of the ComboBox is <B>false</B>.<BR>
|
|
If <B>editable</B> value of the ComboBox is <B>true</B> and the entry has the focus, the user can
|
|
press the top and bottom arrow keys to modify its value. If the current value exactly match a value in the list,
|
|
then the previous (for top arrow key) or then next (for bottom arrow key) value in the list is displayed.
|
|
If the current value match the beginning of a value in the list, then this value is displayed.
|
|
If the current value doesnt match anything, then the first value is displayed.
|
|
|
|
</P>
|
|
<BR><HR WIDTH="50%"><BR>
|
|
<B><A NAME="wso">WIDGET-SPECIFIC OPTIONS</A></B><BR>
|
|
<DL><DT><A NAME="-height"><B>-height</B></A></DT>
|
|
<DD>
|
|
|
|
Specifies the desired height for the window, in lines. If zero or less, then the desired
|
|
height for the window is made just large enough to hold all the elements in the listbox.
|
|
</DD>
|
|
</DL>
|
|
<DL><DT><A NAME="-modifycmd"><B>-modifycmd</B></A></DT>
|
|
<DD>
|
|
|
|
Specifies a Tcl command called when the user modify the value of the ComboBox by selecting it in the listbox or pressing arrow key.
|
|
</DD>
|
|
</DL>
|
|
<DL><DT><A NAME="-postcommand"><B>-postcommand</B></A></DT>
|
|
<DD>
|
|
|
|
Specifies a Tcl command called before the listbox of the ComboBox is mapped.
|
|
</DD>
|
|
</DL>
|
|
<DL><DT><A NAME="-values"><B>-values</B></A></DT>
|
|
<DD>
|
|
|
|
Specifies the values to display in the listbox of the ComboBox.
|
|
</DD>
|
|
</DL>
|
|
<HR WIDTH="50%"><BR>
|
|
<B><A NAME="wc">WIDGET COMMAND</A></B><BR>
|
|
<DL><DT><A NAME="bind"><I>pathName</I> <B>bind</B></A>
|
|
?<I>arg...</I>?
|
|
</DT><DD>
|
|
|
|
Set bindings on the entry widget.
|
|
|
|
</DD></DL>
|
|
<DL><DT><A NAME="cget"><I>pathName</I> <B>cget</B></A>
|
|
<I>option</I>
|
|
</DT><DD>
|
|
|
|
Returns the current value of the configuration option given by <I>option</I>.
|
|
<I>Option</I> may have any of the values accepted by the creation command.
|
|
</DD></DL>
|
|
<DL><DT><A NAME="configure"><I>pathName</I> <B>configure</B></A>
|
|
?<I>option</I>? ?<I>value</I> <I>option</I> <I>value</I> ...?
|
|
</DT><DD>
|
|
|
|
Query or modify the configuration options of the widget. If no <I>option</I> is specified,
|
|
returns a list describing all of the available options for <I>pathName</I>.
|
|
If <I>option</I> is specified with no <I>value</I>, then the command returns a list
|
|
describing the one named <I>option</I> (this list will be identical to the corresponding
|
|
sublist of the value returned if no <I>option</I> is specified). If one or
|
|
more <I>option-value</I> pairs are specified, then the command modifies the given widget
|
|
option(s) to have the given value(s); in this case the command returns an empty string.
|
|
<I>Option</I> may have any of the values accepted by the creation command.
|
|
Read-only options are not be modified.
|
|
|
|
</DD></DL>
|
|
<DL><DT><A NAME="getvalue"><I>pathName</I> <B>getvalue</B></A>
|
|
</DT><DD>
|
|
|
|
Returns the index of the current text of the ComboBox in the list of values,
|
|
or -1 if it doesn't match any value.
|
|
|
|
</DD></DL>
|
|
<DL><DT><A NAME="setvalue"><I>pathName</I> <B>setvalue</B></A>
|
|
<I>index</I>
|
|
</DT><DD>
|
|
|
|
Set the text of the ComboBox to the value indicated by <I>index</I> in the list of values.
|
|
<I>index</I> may be specified in any of the following forms:
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT>
|
|
<B>last</B>
|
|
<DD>
|
|
Specifies the last element of the list of values.
|
|
<DT><B>first</B>
|
|
<DD>
|
|
Specifies the first element of the list of values.
|
|
<DT>
|
|
<B>next</B>
|
|
<DD>
|
|
Specifies the element following the current (ie returned by <B>getvalue</B>) in the list
|
|
of values.
|
|
<DT><B>previous</B>
|
|
<DD>
|
|
Specifies the element preceding the current (ie returned by <B>getvalue</B>) in the list
|
|
of values.
|
|
<DT>
|
|
@<I>number</I>
|
|
<DD>
|
|
Specifies the integer index in the list of values.
|
|
</DL>
|
|
|
|
</DD></DL>
|
|
<HR><BR><B>BINDINGS</B><BR><BR>
|
|
|
|
When Entry of the ComboBox has the input focus, it has the following bindings, in addition
|
|
to the default Entry bindings:
|
|
<UL>
|
|
<LI>Page up set the value of the ComboBox to the first value.
|
|
<LI>Page down set the value of the ComboBox to the last value.
|
|
<LI>Arrow up set the value of the ComboBox to the previous value.
|
|
<LI>Arrow down set the value of the ComboBox to the next value.
|
|
</UL>
|
|
If the listbox is not mapped and ComboBox is not editable or disabled,
|
|
mouse button 1 on the Entry cause the listbox to popup, as if the user press the ArrowButton.
|
|
|
|
</BODY></HTML>
|