ch.marlovits.plz
Class MyCComboSaved

java.lang.Object
  Composite
      ch.marlovits.plz.MyCComboSaved

public final class MyCComboSaved
extends Composite

The CCombo class represents a selectable user interface object that combines a text field and a list and issues notificiation when an item is selected from the list.

Note that although this class is a subclass of Composite, it does not make sense to add children to it, or set a layout on it.

Styles:

BORDER, READ_ONLY, FLAT

Events:

Selection

Constructor Summary

MyCComboSaved(Composite parent, int style)
Constructs a new instance of this class given its parent and a style value describing its behavior and appearance.

Method Summary

void	add(java.lang.String string) Adds an item.
void	add(java.lang.String string, int index) Adds an item at an index.
void	addModifyListener(ModifyListener listener) Adds the listener to receive events.
void	addSelectionListener(SelectionListener listener) Adds the listener to receive events.
void	clearSelection() Clears the current selection.
Point	computeSize(int wHint, int hHint, boolean changed)
void	deselect(int index) Deselects an item.
void	deselectAll() Deselects all items.
void	dropDown(boolean drop)
Control[]	getChildren()
java.lang.String	getItem(int index) Gets an item at an index.
int	getItemCount() Gets the number of items.
int	getItemHeight() Gets the height of one item.
java.lang.String[]	getItems() Gets the items.
List	getList()
Point	getSelection() Gets the selection.
int	getSelectionIndex() Gets the index of the selected item.
java.lang.String	getText() Gets the widget text.
int	getTextHeight() Gets the height of the combo's text field.
int	getTextLimit() Gets the text limit.
int	indexOf(java.lang.String string) Gets the index of an item.
int	indexOf(java.lang.String string, int start) Gets the index of an item.
boolean	isFocusControl()
void	redraw(int x, int y, int width, int height, boolean all)
void	remove(int index) Removes an item at an index.
void	remove(int start, int end) Removes a range of items.
void	remove(java.lang.String string) Removes an item.
void	removeAll() Removes all items.
void	removeModifyListener(ModifyListener listener) Removes the listener.
void	removeSelectionListener(SelectionListener listener) Removes the listener.
void	select(int index) Selects an item.
void	setBackground(Color color)
boolean	setFocus()
void	setFont(Font font)
void	setForeground(Color color)
void	setItem(int index, java.lang.String string) Sets the text of an item; indexing is zero based.
void	setItems(java.lang.String[] items) Sets all items.
void	setListVisible(boolean visibility)
void	setSelection(Point selection) Sets the new selection.
void	setText(java.lang.String string) Sets the widget text.
void	setTextLimit(int limit) Sets the text limit.
void	setToolTipText(java.lang.String string)
void	setVisible(boolean visible)

Methods inherited from class java.lang.Object

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

Constructor Detail

MyCComboSaved

public MyCComboSaved(Composite parent,
                     int style)

Constructs a new instance of this class given its parent and a style value describing its behavior and appearance.

The style value is either one of the style constants defined in class SWT which is applicable to instances of this class, or must be built by bitwise OR'ing together (that is, using the int "|" operator) two or more of those SWT style constants. The class description lists the style constants that are applicable to the class. Style bits are also inherited from superclasses.

Parameters:

parent - a widget which will be the parent of the new instance (cannot be null)

style - the style of widget to construct

Throws:

java.lang.IllegalArgumentException -

• ERROR_NULL_ARGUMENT - if the parent is null

SWTException -

• ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent

See Also:

SWT#BORDER, SWT#READ_ONLY, SWT#FLAT, Widget#getStyle

Method Detail

getList

public List getList()

setListVisible

public void setListVisible(boolean visibility)

add

public void add(java.lang.String string)

Adds an item.

The item is placed at the end of the list. Indexing is zero based.

Parameters:

string - the new item

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when the string is null

SWTError - (ERROR_ITEM_NOT_ADDED) when the item cannot be added

add

public void add(java.lang.String string,
                int index)

Adds an item at an index.

The item is placed at an index in the list. Indexing is zero based. This operation will fail when the index is out of range.

Parameters:

string - the new item

index - the index for the item

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when the string is null

SWTError - (ERROR_ITEM_NOT_ADDED) when the item cannot be added

addModifyListener

public void addModifyListener(ModifyListener listener)

Adds the listener to receive events.

Parameters:

listener - the listener

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when listener is null

addSelectionListener

public void addSelectionListener(SelectionListener listener)

Adds the listener to receive events.

Parameters:

listener - the listener

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when listener is null

clearSelection

public void clearSelection()

Clears the current selection.

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

computeSize

public Point computeSize(int wHint,
                         int hHint,
                         boolean changed)

deselect

public void deselect(int index)

Deselects an item.

If the item at an index is selected, it is deselected. If the item at an index is not selected, it remains deselected. Indices that are out of range are ignored. Indexing is zero based.

Parameters:

index - the index of the item

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

deselectAll

public void deselectAll()

Deselects all items.

If an item is selected, it is deselected. If an item is not selected, it remains unselected.

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

dropDown

public void dropDown(boolean drop)

getChildren

public Control[] getChildren()

getItem

public java.lang.String getItem(int index)

Gets an item at an index.

Indexing is zero based. This operation will fail when the index is out of range or an item could not be queried from the OS.

Parameters:

index - the index of the item

Returns:

the item

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_CANNOT_GET_ITEM) when the operation fails

getItemCount

public int getItemCount()

Gets the number of items.

This operation will fail if the number of items could not be queried from the OS.

Returns:

the number of items in the widget

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_CANNOT_GET_COUNT) when the operation fails

getItemHeight

public int getItemHeight()

Gets the height of one item.

This operation will fail if the height of one item could not be queried from the OS.

Returns:

the height of one item in the widget

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_CANNOT_GET_ITEM_HEIGHT) when the operation fails

getItems

public java.lang.String[] getItems()

Gets the items.

This operation will fail if the items cannot be queried from the OS.

Returns:

the items in the widget

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_CANNOT_GET_ITEM) when the operation fails

getSelection

public Point getSelection()

Gets the selection.

Returns:

a point representing the selection start and end

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

getSelectionIndex

public int getSelectionIndex()

Gets the index of the selected item.

Indexing is zero based. If no item is selected -1 is returned.

Returns:

the index of the selected item.

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

getText

public java.lang.String getText()

Gets the widget text.

If the widget has no text, an empty string is returned.

Returns:

the widget text

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

getTextHeight

public int getTextHeight()

Gets the height of the combo's text field.

The operation will fail if the height cannot be queried from the OS.

Returns:

the height of the combo's text field.

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_ERROR_CANNOT_GET_ITEM_HEIGHT) when the operation fails

getTextLimit

public int getTextLimit()

Gets the text limit.

Returns:

the text limit

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

indexOf

public int indexOf(java.lang.String string)

Gets the index of an item.

The list is searched starting at 0 until an item is found that is equal to the search item. If no item is found, -1 is returned. Indexing is zero based.

Parameters:

string - the search item

Returns:

the index of the item

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when string is null

indexOf

public int indexOf(java.lang.String string,
                   int start)

Gets the index of an item.

The widget is searched starting at start including the end position until an item is found that is equal to the search itenm. If no item is found, -1 is returned. Indexing is zero based.

Parameters:

string - the search item

index - the starting position

Returns:

the index of the item

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when string is null

isFocusControl

public boolean isFocusControl()

redraw

public void redraw(int x,
                   int y,
                   int width,
                   int height,
                   boolean all)

remove

public void remove(int index)

Removes an item at an index.

Indexing is zero based. This operation will fail when the index is out of range or an item could not be removed from the OS.

Parameters:

index - the index of the item

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_ITEM_NOT_REMOVED) when the operation fails

remove

public void remove(int start,
                   int end)

Removes a range of items.

Indexing is zero based. The range of items is from the start index up to and including the end index. This operation will fail when the index is out of range or an item could not be removed from the OS.

Parameters:

start - the start of the range

end - the end of the range

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_ITEM_NOT_REMOVED) when the operation fails

remove

public void remove(java.lang.String string)

Removes an item.

This operation will fail when the item could not be removed from the OS.

Parameters:

string - the search item

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when string is null

SWTError - (ERROR_ITEM_NOT_REMOVED) when the operation fails

removeAll

public void removeAll()

Removes all items.

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

removeModifyListener

public void removeModifyListener(ModifyListener listener)

Removes the listener.

Parameters:

listener - the listener

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when listener is null

removeSelectionListener

public void removeSelectionListener(SelectionListener listener)

Removes the listener.

Parameters:

listener - the listener

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when listener is null

select

public void select(int index)

Selects an item.

If the item at an index is not selected, it is selected. Indices that are out of range are ignored. Indexing is zero based.

Parameters:

index - the index of the item

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

setBackground

public void setBackground(Color color)

setFocus

public boolean setFocus()

setFont

public void setFont(Font font)

setForeground

public void setForeground(Color color)

setItem

public void setItem(int index,
                    java.lang.String string)

Sets the text of an item; indexing is zero based. This operation will fail when the index is out of range or an item could not be changed in the OS.

Parameters:

index - the index for the item

string - the item

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when items is null

SWTError - (ERROR_ITEM_NOT_MODIFIED) when the operation fails

setItems

public void setItems(java.lang.String[] items)

Sets all items.

Parameters:

items - the array of items

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when items is null

SWTError - (ERROR_ITEM_NOT_ADDED) when the operation fails

setSelection

public void setSelection(Point selection)

Sets the new selection.

Parameters:

selection - point representing the start and the end of the new selection

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when selection is null

setText

public void setText(java.lang.String string)

Sets the widget text.

Parameters:

string - the widget text

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_NULL_ARGUMENT) when string is null

setTextLimit

public void setTextLimit(int limit)

Sets the text limit.

Parameters:

limit - new text limit

Throws:

SWTError - (ERROR_THREAD_INVALID_ACCESS) when called from the wrong thread

SWTError - (ERROR_WIDGET_DISPOSED) when the widget has been disposed

SWTError - (ERROR_CANNOT_BE_ZERO) when limit is 0

setToolTipText

public void setToolTipText(java.lang.String string)

setVisible

public void setVisible(boolean visible)