public class

ComboBox

extends View

java.lang.Object
↳	com.neomades.ui.View
	↳	com.neomades.ui.ComboBox

Class Overview

A ComboBox represents a list of choices into screen in order to intercept events (touch and keys) to set a selected value from a list of choices.

Handling Selection

 ItemSelectedListener comboBoxListener = new ItemSelectedListener() {
 	public void onItemSelected(int index, String item) {
 		// do some stuff
 	}
 }
 ComboBox myComboBox = new ComboBox();
 // add items here with ComboBox.addItem() methods
 myComboBox.setItemSelectedListener(comboBoxListener);

Default properties

By default, the following properties are applied to a new ComboBox:

focusable (limited to some devices)
clickable
enabled
text : select item or empty
no icon
width content stretch : MATCH_PARENT.
height content stretch : MATCH_CONTENT.
content alignment : HCENTER|VCENTER.

Summary

XML Attributes
Attribute Name	Related Method	Description
font	setFont(Font)	Font resource id: Res.font.FONT_XXXX
textColor	setTextColor(Color)	#AARRGGBB or a color
textSize	setTextSize(int)	a size in dp

[Expand]

Inherited XML Attributes

From class com.neomades.ui.View

[Expand]

Inherited Constants

From interface com.neomades.ui.Alignment

From interface com.neomades.ui.StretchMode

Public Constructors
	ComboBox() Constructs a combo box with no elements

Public Methods
void	addItem(String item) Adds an item to the ComboBox
void	addItem(int resId) Adds an item to the ComboBox.
String	getItem(int index) Gets the item at the given position.
int	getSelectedIndex() Returns the selected index
String	getSelectedItem() Returns the selected item.
void	insertItem(int resId, int index) Inserts an item at the given position
void	insertItem(String item, int index) Inserts an item at the given position
static void	openChooser(View origin, String[] items, String selectedItem, ItemSelectedListener listener) Opens a dialog chooser used to select one item from a range of many items.
void	removeAllItems() Clears all the items of the combo box
void	removeItem(int index) Removes an item from the combo box
void	setFont(Font font) Set the font of the selected item.
void	setItemSelectedListener(ItemSelectedListener listener) Sets the listener on this combo box, to listen when the selection changes
void	setSelectedIndex(int index) Sets the selected index of the combo box to the index given in parameter
void	setSelectedItem(String item) Sets the selected index of the combo box to the index given in parameter.
void	setTextColor(Color textColor) Sets the button text color.
void	setTextSize(int sizeInDp) Sets the text size to a given value (in dp).

[Expand]

Inherited Methods

From class com.neomades.ui.View

View	findView(int viewId) Find view by Id.
int	getId() Returns the identifier of this element, by default all elements return "0".
Object	getTag() Returns this view's tag.
static View	inflateXML(int layoutResId) Inflate view from XMLLayout declared in the URS File.
static View	inflateXML(InputStream xmlStream) @return
boolean	isClickable() Returns if the view is clickable.
boolean	isEnabled() Return a boolean indicating if the view is enabled or not
boolean	isFocusable() Returns if the view is focusable (for the devices that have a keyboard Ui navigation).
boolean	isVisible() Returns if the view is visible
void	runOnUiThread(Runnable action) Calls `action.run()` asynchronously on the `UI-Thread`.
void	setBackground(Background background) Sets the background on this view.
void	setBackground(int backgroundResId) Sets the background on this view with a XML background definition.
void	setBackgroundColor(Color color) Sets the background color on this view.
void	setBackgroundImage(int imageID) Set the background image for this view.
void	setBackgroundImage(Image image) Set the background image for this view.
void	setBorderColor(Color borderColor) Sets the border color on this view.
void	setBorderWidth(int widthInDp) Set the border width (size) in DP units.
void	setClickListener(ClickListener clickListener) Sets a ClickListener to this view.
void	setClickable(boolean clickable) Sets this view clickable.
void	setCornerRadius(int radiusSize) Set the four corners radius, if the view has corners.
void	setDrawingCacheEnabled(boolean enabled) Enables or disables the drawing cache.
void	setEnabled(boolean enabled) Sets the state of this view to enabled or disabled.
void	setFocusable(boolean focusable) Sets the view focusable.
void	setGestureDetector(GestureDetector detector) Sets a `GestureDetector` on this view.
void	setHeight(int heightDp) Sets the height of the view, in dp units (density-independent pixels).
void	setId(int id) Sets a identifier/tag to this element
void	setInvalidateDisabled(boolean disabled) If set to true, force the layout that contains the view to not be draw again when its content changes.
void	setLayoutAlignment(int alignment) Sets the view alignment into its parent.
void	setMargin(int uniformMarginDp) Set the margin outside this view (used by `Layout`), by setting on each side the given value.
void	setMargin(int leftDp, int topDp, int rightDp, int bottomDp) Set the margin outside this view (used by `Layout`).
void	setMarginBottom(int marginBottomDp) Sets the bottom margin with the given value.
void	setMarginLeft(int marginLeftDp) Sets the left margin with the given value.
void	setMarginRight(int marginRightDp) Sets the right margin with the given value.
void	setMarginTop(int marginTopDp) Sets the top margin with the given value.
void	setPadding(int leftDp, int topDp, int rightDp, int bottomDp) Sets the view padding.
void	setPadding(int uniformPaddingDp) Sets the view padding, with for each side the value given in parameter.
void	setPaddingBottom(int paddingBottomDp) Sets the bottom padding with the given value.
void	setPaddingLeft(int paddingLeftDp) Sets the left padding with the given value.
void	setPaddingRight(int paddingRightDp) Sets the right padding with the given value.
void	setPaddingTop(int paddingTopDp) Sets the top padding with the given value.
void	setSize(int widthDp, int heightDp) Sets the size of the view, in dp units (density-independent pixels).
void	setStretchHorizontalMode(int widthMode) Sets the stretch horizontal mode.
void	setStretchMode(int horizontalMode, int verticalMode) Sets the view content stretch mode.
void	setStretchVerticalMode(int heightMode) Sets the stretch vertical mode.
void	setStyle(int styleResId)
void	setStyle(Style style)
void	setTag(Object tag) Sets the tag associated with this view.
void	setTouchListener(TouchListener touchListener) Register a listener to be invoked when a touch event is dispatched to this view.
void	setTransformOrigin(float xOrigin, float yOrigin) Sets the x and y location of the point around which the view will be scaled or rotated when an animation occurs.
void	setVisible(boolean visible) Sets the view's visibility : visible or invisible/hidden
void	setWidth(int widthDp) Sets the width of the view, in dp units (density-independent pixels).

From class java.lang.Object

boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
final Class<?>	getClass() Returns the runtime class of an object.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait(long timeout, int nanos) Causes current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
final void	wait() Causes current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

XML Attributes

font

Font resource id: Res.font.FONT_XXXX

Related Methods

setFont(Font)

textColor

#AARRGGBB or a color

Related Methods

setTextColor(Color)

Public Constructors

public ComboBox ()

Constructs a combo box with no elements

Public Methods

public void addItem (String item)

Adds an item to the ComboBox

Parameters

item	the string to add to the combo box

Throws

CrossThreadException	if the method is called from outside the UI-Thread

public void addItem (int resId)

Adds an item to the ComboBox.

Parameters

resId	the string id assigned added to this combo box

Throws

CrossThreadException	if the method is called from outside the UI-Thread

public String getItem (int index)

Gets the item at the given position. If none is found, return null

Parameters

index	the index of the item to find

Returns

the item, or null if not found

public int getSelectedIndex ()

Returns the selected index

Returns

the selected index (0 based)

public String getSelectedItem ()

Returns the selected item.

Returns

the selected item

public void insertItem (int resId, int index)

Inserts an item at the given position

Parameters

resId	the string id assigned added to this combo box
index	the index where to insert

Throws

CrossThreadException	if the method is called from outside the UI-Thread

public void insertItem (String item, int index)

Inserts an item at the given position

Parameters

item	the string to insert
index	the index where to insert

Throws

CrossThreadException	if the method is called from outside the UI-Thread

public static void openChooser (View origin, String[] items, String selectedItem, ItemSelectedListener listener)

Opens a dialog chooser used to select one item from a range of many items.

Parameters

origin	the view from where to show the dialog (usefull for iOS)
items	list of items
selectedItem	the original selected item
listener	callback to listen the new selection (could be null)

Throws

NullPointerException	if `origin` is `null` in iOS platforms
IllegalArgumentException	if `items` is null or empty, if `selectedItem` is `null`.

public void removeAllItems ()

Clears all the items of the combo box

Throws

CrossThreadException	if the method is called from outside the UI-Thread

public void removeItem (int index)

Removes an item from the combo box

Parameters

index	the index where to remove the item

Throws

CrossThreadException	if the method is called from outside the UI-Thread

public void setFont (Font font)

Set the font of the selected item. This method does not change the font of the items in the opened chooser.

Related XML Attributes

font

Parameters

font	the new font to set

Throws

CrossThreadException	if the method is called from outside the UI-Thread
NullPointerException	if the font parameter is null

public void setItemSelectedListener (ItemSelectedListener listener)

Sets the listener on this combo box, to listen when the selection changes

Parameters

listener	the listener

public void setSelectedIndex (int index)

Sets the selected index of the combo box to the index given in parameter

Parameters

index	the index to select

Throws

CrossThreadException	if the method is called from outside the UI-Thread

public void setSelectedItem (String item)

Sets the selected index of the combo box to the index given in parameter. The item selected will be the first in the combo box that is equal to the String given in parameter.

Parameters

item	the item to select

Throws

CrossThreadException	if the method is called from outside the UI-Thread

public void setTextColor (Color textColor)

Sets the button text color.

Related XML Attributes

textColor

Parameters

textColor	new color for the text

Throws

CrossThreadException	if the method is called from outside the UI-Thread
NullPointerException	if the parameter is null

public void setTextSize (int sizeInDp)

Sets the text size to a given value (in dp).

Related XML Attributes

textSize

Parameters

sizeInDp	size to set to the text

Interfaces

Classes

Enums

Exceptions

ComboBox

Class Overview

Handling Selection

Default properties

See Also

Summary

XML Attributes

font

Related Methods

textColor

Related Methods

textSize

Related Methods

Public Constructors

public ComboBox ()

Public Methods

public void addItem (String item)

Parameters

Throws

public void addItem (int resId)

Parameters

Throws

public String getItem (int index)

Parameters

Returns

public int getSelectedIndex ()

Returns

public String getSelectedItem ()

Returns

public void insertItem (int resId, int index)

Parameters

Throws

public void insertItem (String item, int index)

Parameters

Throws

public static void openChooser (View origin, String[] items, String selectedItem, ItemSelectedListener listener)

Parameters

Throws

public void removeAllItems ()

Throws

public void removeItem (int index)

Parameters

Throws

public void setFont (Font font)

Related XML Attributes

Parameters

Throws

public void setItemSelectedListener (ItemSelectedListener listener)

Parameters

public void setSelectedIndex (int index)

Parameters

Throws

public void setSelectedItem (String item)

Parameters

Throws

public void setTextColor (Color textColor)

Related XML Attributes

Parameters

Throws

public void setTextSize (int sizeInDp)

Related XML Attributes

Parameters