waba.ui
Class ComboBox

java.lang.Object
  |
  +--waba.ui.Control
        |
        +--waba.ui.Container
              |
              +--waba.ui.ComboBox

Direct Known Subclasses:

ComboBox

public class ComboBox

extends Container

ComboBox is a simple implementation of a ComboBox.

Note: the color used in the setBackground method will be used in the button only. The background color of the control will be a lighter version of the given color.

Field Summary

static int	extraArrowSize You can increase the size of the arrow by changing this value to something else, before calling the constructor of the ScrollBar.
boolean	fullHeight if set to true, the popup window will have the height of the screen
boolean	fullWidth if set to true, the popup window will have the width of the screen
protected PopList	pop

Fields inherited from class waba.ui.Container

BORDER_LOWERED, BORDER_NONE, BORDER_RAISED, BORDER_SIMPLE, children, lastH, lastW, lastX, lastY, parentWindow, started, tabOrder, tail

Fields inherited from class waba.ui.Control

AFTER, appId, appObj, asContainer, asWindow, backColor, backDis, BEFORE, BOTTOM, CENTER, clearValueInt, clearValueStr, enabled, FILL, FIT, fm, fmH, focusLess, focusTraversable, font, foreColor, foreDis, height, highlightRectsCount, isHighlighting, LEFT, parent, PREFERRED, RANGE, RIGHT, SAME, TOP, uiCE, uiFlat, uiPalm, uiVista, visible, width, x, x2, y, y2

Constructor Summary

ComboBox()
Creates an empty ComboBox

ComboBox(ListBox userListBox)
Creates a ComboBox with a PopList containing the given ListBox.

ComboBox(java.lang.Object[] items)
Creates a ComboBox with the given items

ComboBox(PopList userPopList)
Constructs a ComboBox with the given PopList.

Method Summary

void	add(Control control) do nothing
void	add(java.lang.Object item) Adds an Object to the Listbox.
void	add(java.lang.Object[] items) Adds an array of Objects to the Listbox
void	clear() Clears this control, selecting index clearValueInt.
void	enableHorizScroll() Adds support for horizontal scroll on this listbox.
java.lang.Object	getItemAt(int i) Get the Object at the given Index
java.lang.Object[]	getItems() Returns all items in this ComboBox
int	getPreferredHeight() Returns the preffered height of this control.
int	getPreferredWidth() Returns the preffered width of this control.
int	getSelectedIndex() Returns the position of the selected item of the PopList
java.lang.Object	getSelectedItem() Returns the selected item of the PopList
int	indexOf(java.lang.Object name) Returns the index of the item specified by the name
void	insert(java.lang.Object item, int index) Adds an Object to the Listbox at the given index
protected void	onBoundsChanged() Called after a setRect.
protected void	onColorsChanged(boolean colorsChanged) Called after a setEnabled, setForeColor and setBackColor and when a control has been added to a Container.
void	onEvent(Event event) Called to process key, pen, control and other posted events.
protected void	onFontChanged() passes the font to the pop list
void	onPaint(Graphics g) paint the combo's border and the current selected item
void	popupPop() Pops up the combobox
void	qsort() Sorts the items of this combobox
void	remove(Control control) do nothing
void	remove(int itemIndex) Removes an Object from the Listbox
void	remove(java.lang.Object item) Removes an Object from the Listbox
void	removeAll() Empties the ListBox
void	select(int i) Select the given index.
void	select(java.lang.Object name) Selects an item.
void	selectLast() Selects the last item added to this combobox, doing a scroll if needed.
void	setCursorColor(Color color) Sets the cursor color for this ComboBox.
void	setItemAt(int i, java.lang.Object s) Sets the Object at the given Index, starting from 0
int	size() Returns the number of items

Methods inherited from class waba.ui.Container

add, add, broadcastEvent, findChild, getChildren, getClientRect, getClientRect, onAdd, onRemove, onStart, paintChildren, setBorderStyle, setEnabled, setHighlighting, swapToTopmostWindow

Methods inherited from class waba.ui.Control

addTimer, changeHighlighted, contains, createGraphics, drawHighlight, getAbsoluteRect, getBackColor, getFont, getFontMetrics, getForeColor, getNext, getParent, getParentWindow, getPos, getRect, getSize, isDisplayed, isEnabled, isVisible, onWindowPaintFinished, postEvent, removeTimer, repaint, repaintNow, requestFocus, setBackColor, setBackForeColors, setFocusLess, setFont, setForeColor, setRect, setRect, setRect, setVisible, translateFromOrigin, uiStyleChanged

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

pop

protected PopList pop

fullHeight

public boolean fullHeight

if set to true, the popup window will have the height of the screen

fullWidth

public boolean fullWidth

if set to true, the popup window will have the width of the screen

extraArrowSize

public static int extraArrowSize

You can increase the size of the arrow by changing this value to something else, before calling the constructor of the ScrollBar. Don't forget to reset it to 0 after this.

Constructor Detail

ComboBox

public ComboBox()

Creates an empty ComboBox

ComboBox

public ComboBox(java.lang.Object[] items)

Creates a ComboBox with the given items

ComboBox

public ComboBox(ListBox userListBox)

Creates a ComboBox with a PopList containing the given ListBox. You can extend the ListBox to draw the items by yourself and use this constructor so the PopList will use your class and not the default ListBox one. Note that this constructor forces the ListBox.simpleBorder to true. Note: the listbox items must be already set.

ComboBox

public ComboBox(PopList userPopList)

Constructs a ComboBox with the given PopList.

Method Detail

add

public void add(Control control)

do nothing

Overrides:

add in class Container

remove

public void remove(Control control)

do nothing

Overrides:

remove in class Container

add

public void add(java.lang.Object[] items)

Adds an array of Objects to the Listbox

add

public void add(java.lang.Object item)

Adds an Object to the Listbox. This method is very slow; use the add(Object[]) to add a bunch of objects instead.

insert

public void insert(java.lang.Object item,
                   int index)

Adds an Object to the Listbox at the given index

removeAll

public void removeAll()

Empties the ListBox

remove

public void remove(java.lang.Object item)

Removes an Object from the Listbox

remove

public void remove(int itemIndex)

Removes an Object from the Listbox

setItemAt

public void setItemAt(int i,
                      java.lang.Object s)

Sets the Object at the given Index, starting from 0

getItemAt

public java.lang.Object getItemAt(int i)

Get the Object at the given Index

getSelectedItem

public java.lang.Object getSelectedItem()

Returns the selected item of the PopList

getSelectedIndex

public int getSelectedIndex()

Returns the position of the selected item of the PopList

getItems

public java.lang.Object[] getItems()

Returns all items in this ComboBox

indexOf

public int indexOf(java.lang.Object name)

Returns the index of the item specified by the name

setCursorColor

public void setCursorColor(Color color)

Sets the cursor color for this ComboBox. The default is equal to the background slightly darker. Make sure you tested it in 2,4 and 8bpp devices.

select

public void select(java.lang.Object name)

Selects an item. If the name is not found, the current selected item is not changed.

Since:

SuperWaba 4.01

select

public void select(int i)

Select the given index. Choose "-1" if you want to blank the ComboBox edit box.

size

public int size()

Returns the number of items

getPreferredWidth

public int getPreferredWidth()

Description copied from class: Control

Returns the preffered width of this control.

Overrides:

getPreferredWidth in class Control

getPreferredHeight

public int getPreferredHeight()

Description copied from class: Control

Returns the preffered height of this control.

Overrides:

getPreferredHeight in class Control

onFontChanged

protected void onFontChanged()

passes the font to the pop list

Overrides:

onFontChanged in class Control

onBoundsChanged

protected void onBoundsChanged()

Description copied from class: Control

Called after a setRect.

Overrides:

onBoundsChanged in class Control

onEvent

public void onEvent(Event event)

Description copied from class: Control

Called to process key, pen, control and other posted events.

Overrides:

onEvent in class Control

Tags copied from class: Control

Parameters:

event - the event to process

See Also:

Event, KeyEvent, PenEvent

popupPop

public void popupPop()

Pops up the combobox

onColorsChanged

protected void onColorsChanged(boolean colorsChanged)

Description copied from class: Control

Called after a setEnabled, setForeColor and setBackColor and when a control has been added to a Container. If colorsChanged is true, it was called from setForeColor/setBackColor/Container.add; otherwise, it was called from setEnabled

Overrides:

onColorsChanged in class Container

onPaint

public void onPaint(Graphics g)

paint the combo's border and the current selected item

Overrides:

onPaint in class Container

Tags copied from class: Control

Parameters:

g - the graphics object for drawing

See Also:

Graphics

qsort

public void qsort()

Sorts the items of this combobox

enableHorizScroll

public void enableHorizScroll()

Adds support for horizontal scroll on this listbox. Two buttons will appear below the vertical scrollbar. The add, replace and remove operations will be a bit slower because the string's width will have to be computed in order to correctly set the max horizontal scroll.

Since:

SuperWaba 5.6

selectLast

public void selectLast()

Selects the last item added to this combobox, doing a scroll if needed. Calls repaintNow.

Since:

SuperWaba 5.6

clear

public void clear()

Clears this control, selecting index clearValueInt.

Overrides:

clear in class Container