org.gnu.gtk
public class Combo extends HBox
Deprecated:
This class is part of the java-gnome 2.x family of libraries,
which, due to their inefficiency and complexity, are no longer
being maintained and have been abandoned by the java-gnome
project. This class may in the future have an equivalent in
java-gnome 4.0, try looking for
org.gnome.gtk.Combo
.
You should be aware that there is a considerably different API
in the new library: the architecture is completely different
and most notably internals are no longer exposed to public view.
By default, the user can step through the items in the list by using the arrow keys, though this behavior can be turned off with the setUseArrows() method.
Normally the arrow keys are only active when the contents of the text entry field matches on of the items in the list. If the contents of the entry field do not match any of the items in the list items, then pressing the arrow keys does nothing. However, by calling the setUseArrowsAlways() method you can specify that the arrow keys be active always.
Constructor Summary | |
---|---|
Combo()
Construct a new Combo widget. | |
Combo(Handle handle)
Construct a new Combo from a handle to a native resource. |
Method Summary | |
---|---|
void | disableActivate()
Stops the Combo widget from showing the popup list when the Entry emits
the "activate" signal, i.e., when the return key is pressed. |
Entry | getEntry()
Get the Entry field that is a part of this combo. |
String | getText()
Retrieve the text from the combo. |
static Type | getType()
Retrieve the runtime type used by the GLib library. |
void | setCaseSensitive(boolean val)
Specifies whether the text entered into the Entry field and the text in
the line items are case sensitive.
|
void | setItemString(Item item, String itemValue)
Sets the string to place in the Entry field when a particular item is
selected. |
void | setPopupdownStrings(String[] values)
Convenience method to set all of the items in the popupdown list.
|
void | setUseArrorwsAlways(boolean val)
Specifies if the arrow keys will still work even if the current contents
of the Entry field do not match any of the items in the list.
|
void | setUseArrows(boolean val)
Specifies if the arrow (cursor) keys can be used to step through the
items in the list. |
void | setValueInList(boolean val, boolean okifEmpty)
Specifies whether the value entered in the text entry field must match
one of the values in the list. |
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Construct a new Combo widget.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Construct a new Combo from a handle to a native resource.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Stops the Combo widget from showing the popup list when the Entry emits the "activate" signal, i.e., when the return key is pressed.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Get the Entry field that is a part of this combo.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Retrieve the text from the combo.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Retrieve the runtime type used by the GLib library.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Specifies whether the text entered into the Entry field and the text in the line items are case sensitive.This may be useful when you have called setValueInList() to limit the values entered but are not worried about case differences.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Sets the string to place in the Entry field when a particular item is selected. This is needed if the list item is not a simple label.Parameters: item The item to add to the list. itemValue The string value to display in the Entry if item is selected
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Convenience method to set all of the items in the popupdown list.Parameters: values The array of values to put into the popupdown list.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Specifies if the arrow keys will still work even if the current contents of the Entry field do not match any of the items in the list.Parameters: val true if the arrows should still work.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Specifies if the arrow (cursor) keys can be used to step through the items in the list. This is on by default.Parameters: val true if the arrow keys can be used to step through the items in the list.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Specifies whether the value entered in the text entry field must match one of the values in the list. If this is set then the user will not be able to perform any other action until a valid value has been entered.Parameters: val true if the value entered must match one of the values in the list. okifEmpty true if an empty value is considered valid.