org.millstone.base.ui
Class Select

java.lang.Object
  |
  +--org.millstone.base.ui.AbstractComponent
        |
        +--org.millstone.base.ui.AbstractField
              |
              +--org.millstone.base.ui.Select

All Implemented Interfaces:

Buffered, BufferedValidatable, Component, Container, Container.ItemSetChangeListener, Container.ItemSetChangeNotifier, Container.PropertySetChangeListener, Container.PropertySetChangeNotifier, Container.Viewer, java.util.EventListener, MethodEventSource, Paintable, Property, Property.Editor, Property.ReadOnlyStatusChangeNotifier, Property.ValueChangeListener, Property.ValueChangeNotifier, Property.Viewer, Validatable, VariableOwner

Direct Known Subclasses:

Table, Tree

public class Select

extends AbstractField

implements Container, Container.Viewer, Container.PropertySetChangeListener, Container.PropertySetChangeNotifier, Container.ItemSetChangeNotifier, Container.ItemSetChangeListener

A class representing a selection of items the user has selected in a UI. The set of choices is presented as a set of Items in a Container.

A Select component may be in single- or multiselect mode. Multiselect mode means that more than one item can be selected simultaneously.

Since:

3.0

Version:

3.0.3

Author:

IT Mill Ltd.

Nested Class Summary

Nested classes inherited from class org.millstone.base.ui.AbstractField

AbstractField.ReadOnlyStatusChangeEvent, AbstractField.ValueChangeEvent

Nested classes inherited from class org.millstone.base.data.Container

Container.Editor, Container.Hierarchical, Container.Indexed, Container.ItemSetChangeEvent, Container.ItemSetChangeListener, Container.ItemSetChangeNotifier, Container.Ordered, Container.PropertySetChangeEvent, Container.PropertySetChangeListener, Container.PropertySetChangeNotifier, Container.Viewer

Nested classes inherited from class org.millstone.base.data.Buffered

Buffered.SourceException

Nested classes inherited from class org.millstone.base.data.Property

Property.ConversionException, Property.Editor, Property.ReadOnlyException, Property.ReadOnlyStatusChangeEvent, Property.ReadOnlyStatusChangeListener, Property.ReadOnlyStatusChangeNotifier, Property.ValueChangeEvent, Property.ValueChangeListener, Property.ValueChangeNotifier, Property.Viewer

Nested classes inherited from class org.millstone.base.ui.Component

Component.Event, Component.Listener

Nested classes inherited from class org.millstone.base.terminal.Paintable

Paintable.RepaintRequestEvent, Paintable.RepaintRequestListener

Field Summary

static int	ITEM_CAPTION_MODE_EXPLICIT Item caption mode: Captions must be explicitly specified.
static int	ITEM_CAPTION_MODE_EXPLICIT_DEFAULTS_ID Item caption mode: If an Item has a caption it's used, if not, Item's ID's String representation is used as caption.
static int	ITEM_CAPTION_MODE_ICON_ONLY Item caption mode: Only icons are shown, captions are hidden.
static int	ITEM_CAPTION_MODE_ID Item caption mode: Item's ID's String representation is used as caption.
static int	ITEM_CAPTION_MODE_INDEX Item caption mode: Index of the item is used as caption.
static int	ITEM_CAPTION_MODE_ITEM Item caption mode: Item's String representation is used as caption.
static int	ITEM_CAPTION_MODE_PROPERTY Item caption mode: Item captions are read from property specified with setItemCaptionPropertyId.
protected KeyMapper	itemIdMapper Keymapper used to map key values
protected Container	items Select options

Fields inherited from interface org.millstone.base.data.Container

NULL_ITEM_ID

Constructor Summary

Select()
Creates an empty Select.

Select(java.lang.String caption)
Creates an empty Select with caption.

Select(java.lang.String caption, java.util.Collection options)
Creates a new select that is filled from a collection of option values.

Select(java.lang.String caption, Container dataSource)
Creates a new select wthat is connected to a data-source.

Method Summary

boolean	addContainerProperty(java.lang.Object propertyId, java.lang.Class type, java.lang.Object defaultValue) Add new property to all items.
java.lang.Object	addItem() Create a new item into container with container managed id.
Item	addItem(java.lang.Object itemId) Create a new item into container.
void	addListener(Container.ItemSetChangeListener listener) Adds a Item set change listener for the object.
void	addListener(Container.PropertySetChangeListener listener) Registers a new Property set change listener for this Container.
void	changeVariables(java.lang.Object source, java.util.Map variables) Invoked when the value of a variable has changed.
void	containerItemSetChange(Container.ItemSetChangeEvent event) Lets the listener know a Containers Item set has changed.
void	containerPropertySetChange(Container.PropertySetChangeEvent event) Notifies this listener that the Containers contents has changed.
boolean	containsId(java.lang.Object itemId) Test, if the collection contains an item with given id.
protected void	fireItemSetChange() Fire item set change event
protected void	firePropertySetChange() Fire property set change event
Container	getContainerDataSource() Get viewing data-source container.
Property	getContainerProperty(java.lang.Object itemId, java.lang.Object propertyId) Gets the Property identified by the given itemId and propertyId from the Container.
java.util.Collection	getContainerPropertyIds() Get property Id collection from the container.
Item	getItem(java.lang.Object itemId) Get the item from the container with given id.
java.lang.String	getItemCaption(java.lang.Object itemId) Get the caption of an item.
int	getItemCaptionMode() Get the item caption mode.
java.lang.Object	getItemCaptionPropertyId() Get the item caption property.
Resource	getItemIcon(java.lang.Object itemId) Get the item icon.
java.lang.Object	getItemIconPropertyId() Get the item icon property.
java.util.Collection	getItemIds() Get item Id collection from the container.
java.lang.Object	getNullSelectionItemId() Returns the item id that represents null value of this select in single select mode.
java.lang.String	getTag() Get component UIDL tag.
java.lang.Class	getType() Return the type of the property.
java.lang.Class	getType(java.lang.Object propertyId) Get property type.
java.lang.Object	getValue() Get the selected item id or in multiselect mode a set of selected ids.
java.util.Collection	getVisibleItemIds() Get the visible item ids.
boolean	isMultiSelect() Is the select in multiselect mode?
boolean	isNewItemsAllowed() Does the select allow adding new options by the user.
boolean	isSelected(java.lang.Object itemId) Test if an item is selected In single select mode testing selection status of the item identified by getNullSelectionItemId() returns true if the value of the property is null.
void	paintContent(PaintTarget target) Paint the content of this component.
boolean	removeAllItems() Remove all items from the container.
boolean	removeContainerProperty(java.lang.Object propertyId) Remove property from all items.
boolean	removeItem(java.lang.Object itemId) Remove item identified by Id from the container.
void	removeListener(Container.ItemSetChangeListener listener) Removes a Item set change listener from the object.
void	removeListener(Container.PropertySetChangeListener listener) Removes a previously registered Property set change listener.
void	select(java.lang.Object itemId) Select an item.
void	setContainerDataSource(Container newDataSource) Set the container as data-source for viewing.
void	setItemCaption(java.lang.Object itemId, java.lang.String caption) Override the caption of an item.
void	setItemCaptionMode(int mode) Set the item caption mode.
void	setItemCaptionPropertyId(java.lang.Object propertyId) Set the item caption property.
void	setItemIcon(java.lang.Object itemId, Resource icon) Set icon for an item.
void	setItemIconPropertyId(java.lang.Object propertyId) Set the item icon property.
void	setMultiSelect(boolean multiSelect) Set the multiselect mode.
void	setNewItemsAllowed(boolean allowNewOptions) Enable or disable possibility to add new options by the user.
void	setNullSelectionItemId(java.lang.Object nullSelectionItemId) Sets the item id that represents null value of this select.
void	setValue(java.lang.Object newValue) Set the visible value of the property.
int	size() Get the number of items in the container.
void	unselect(java.lang.Object itemId) Unselect an item.

Methods inherited from class org.millstone.base.ui.AbstractField

addListener, addListener, addValidator, commit, constructField, discard, fireReadOnlyStatusChange, fireValueChange, focus, getErrorMessage, getPropertyDataSource, getValidators, isInvalidAllowed, isInvalidCommitted, isModified, isReadOnly, isReadThrough, isValid, isWriteThrough, removeListener, removeListener, removeValidator, setInvalidAllowed, setInvalidCommitted, setPropertyDataSource, setReadOnly, setReadThrough, setWriteThrough, toString, validate, valueChange

Methods inherited from class org.millstone.base.ui.AbstractComponent

addListener, addListener, addListener, addListener, attach, childRequestedRepaint, dependsOn, detach, fireComponentEvent, fireEvent, getApplication, getCaption, getComponentError, getDescription, getDirectDependencies, getIcon, getLocale, getParent, getStyle, getWindow, isEnabled, isImmediate, isVisible, paint, removeDirectDependency, removeListener, removeListener, removeListener, removeListener, removeListener, requestRepaint, requestRepaintRequests, setCaption, setComponentError, setDescription, setEnabled, setIcon, setImmediate, setLocale, setParent, setStyle, setVisible

Methods inherited from class java.lang.Object

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

Field Detail

ITEM_CAPTION_MODE_ID

public static final int ITEM_CAPTION_MODE_ID

Item caption mode: Item's ID's String representation is used as caption.

See Also:

Constant Field Values

ITEM_CAPTION_MODE_ITEM

public static final int ITEM_CAPTION_MODE_ITEM

Item caption mode: Item's String representation is used as caption.

See Also:

Constant Field Values

ITEM_CAPTION_MODE_INDEX

public static final int ITEM_CAPTION_MODE_INDEX

Item caption mode: Index of the item is used as caption. The index mode can only be used with the containers implementing the Container.Indexed interface.

See Also:

Constant Field Values

ITEM_CAPTION_MODE_EXPLICIT_DEFAULTS_ID

public static final int ITEM_CAPTION_MODE_EXPLICIT_DEFAULTS_ID

Item caption mode: If an Item has a caption it's used, if not, Item's ID's String representation is used as caption. This is the default.

See Also:

Constant Field Values

ITEM_CAPTION_MODE_EXPLICIT

public static final int ITEM_CAPTION_MODE_EXPLICIT

Item caption mode: Captions must be explicitly specified.

See Also:

Constant Field Values

ITEM_CAPTION_MODE_ICON_ONLY

public static final int ITEM_CAPTION_MODE_ICON_ONLY

Item caption mode: Only icons are shown, captions are hidden.

See Also:

Constant Field Values

ITEM_CAPTION_MODE_PROPERTY

public static final int ITEM_CAPTION_MODE_PROPERTY

Item caption mode: Item captions are read from property specified with setItemCaptionPropertyId.

See Also:

Constant Field Values

items

protected Container items

Select options

itemIdMapper

protected KeyMapper itemIdMapper

Keymapper used to map key values

Constructor Detail

Select

public Select()

Creates an empty Select. The caption is not used.

Select

public Select(java.lang.String caption)

Creates an empty Select with caption.

Select

public Select(java.lang.String caption,
              Container dataSource)

Creates a new select wthat is connected to a data-source.

Parameters:

dataSource - Container datasource to be selected from by this select.

caption - Caption of the component.

Select

public Select(java.lang.String caption,
              java.util.Collection options)

Creates a new select that is filled from a collection of option values.

Parameters:

caption - Caption of this field.

options - Collection containing the options.

Method Detail

paintContent

public void paintContent(PaintTarget target)
                  throws PaintException

Paint the content of this component.

Overrides:

paintContent in class AbstractField

Parameters:

target - target UIDL stream where the component should paint itself to

Throws:

PaintException - The paint operation failed.

changeVariables

public void changeVariables(java.lang.Object source,
                            java.util.Map variables)

Invoked when the value of a variable has changed.

Specified by:

changeVariables in interface VariableOwner

Overrides:

changeVariables in class AbstractComponent

Parameters:

source - Source of the variable change. This is the origin of the event. For example in Web Adapter this is the request.

variables - Mapping from variable names to new variable values

getTag

public java.lang.String getTag()

Get component UIDL tag.

Specified by:

getTag in class AbstractComponent

Returns:

Component UIDL tag as string.

getVisibleItemIds

public java.util.Collection getVisibleItemIds()

Get the visible item ids. In Select, this returns list of all item ids, but can be overriden in subclasses if they paint only part of the items to the terminal or null if no items is visible.

getType

public java.lang.Class getType()

Return the type of the property. getValue and setValue functions must be compatible with this type: one can safely cast getValue() to given type and pass any variable assignable to this type as a parameter to setValue().

Specified by:

getType in interface Property

Specified by:

getType in class AbstractField

Returns:

type Type of the property.

getValue

public java.lang.Object getValue()

Get the selected item id or in multiselect mode a set of selected ids.

Specified by:

getValue in interface Property

Overrides:

getValue in class AbstractField

Returns:

the current value of the field

setValue

public void setValue(java.lang.Object newValue)
              throws Property.ReadOnlyException,
                     Property.ConversionException

Set the visible value of the property.

The value of the select is the selected item id. If the select is in multiselect-mode, the value is a set of selected item keys. In multiselect mode all collections of id:s can be assigned.

Specified by:

setValue in interface Property

Overrides:

setValue in class AbstractField

Parameters:

newValue - New selected item or collection of selected items.

Property.ReadOnlyException

Property.ConversionException

getItem

public Item getItem(java.lang.Object itemId)

Get the item from the container with given id. If the container does not contain the requested item, null is returned.

Specified by:

getItem in interface Container

Parameters:

itemId - ID of the Item to retrieve

Returns:

the Item with the given ID or null if the Item is not found in the Container

getItemIds

public java.util.Collection getItemIds()

Get item Id collection from the container.

Specified by:

getItemIds in interface Container

Returns:

Collection of item ids.

getContainerPropertyIds

public java.util.Collection getContainerPropertyIds()

Get property Id collection from the container.

Specified by:

getContainerPropertyIds in interface Container

Returns:

Collection of property ids.

getType

public java.lang.Class getType(java.lang.Object propertyId)

Get property type.

Specified by:

getType in interface Container

Parameters:

propertyId - ID identifying the Properties

Returns:

data type of the Properties

size

public int size()

Get the number of items in the container.

Specified by:

size in interface Container

Returns:

Number of items in the container.

containsId

public boolean containsId(java.lang.Object itemId)

Test, if the collection contains an item with given id.

Specified by:

containsId in interface Container

Parameters:

itemId - Id the of item to be tested.

Returns:

boolean indicating if the Container holds the specified Item

getContainerProperty

public Property getContainerProperty(java.lang.Object itemId,
                                     java.lang.Object propertyId)

Description copied from interface: Container

Gets the Property identified by the given itemId and propertyId from the Container. If the Container does not contain the Property, null is returned.

Specified by:

getContainerProperty in interface Container

Parameters:

itemId - ID of the Item which contains the Property

propertyId - ID of the Property to retrieve

Returns:

Property with the given ID or null

See Also:

Container.getContainerProperty(Object, Object)

addContainerProperty

public boolean addContainerProperty(java.lang.Object propertyId,
                                    java.lang.Class type,
                                    java.lang.Object defaultValue)
                             throws java.lang.UnsupportedOperationException

Add new property to all items. Adds a property with given id, type and default value to all items in the container. This functionality is optional. If the function is unsupported, it always returns false.

Specified by:

addContainerProperty in interface Container

Parameters:

propertyId - ID of the Property

type - Data type of the new Property

defaultValue - The value all created Properties are initialized to

Returns:

True iff the operation succeeded.

java.lang.UnsupportedOperationException

removeAllItems

public boolean removeAllItems()
                       throws java.lang.UnsupportedOperationException

Remove all items from the container. This functionality is optional. If the function is unsupported, it always returns false.

Specified by:

removeAllItems in interface Container

Returns:

True iff the operation succeeded.

java.lang.UnsupportedOperationException

addItem

public java.lang.Object addItem()
                         throws java.lang.UnsupportedOperationException

Create a new item into container with container managed id. The id of the created new item is returned. The item can be fetched with getItem() method. if the creation fails, null is returned.

Specified by:

addItem in interface Container

Returns:

Id of the created item or null in case of failure.

java.lang.UnsupportedOperationException

addItem

public Item addItem(java.lang.Object itemId)
             throws java.lang.UnsupportedOperationException

Create a new item into container. The created new item is returned and ready for setting property values. if the creation fails, null is returned. In case the container already contains the item, null is returned. This functionality is optional. If the function is unsupported, it always returns null.

Specified by:

addItem in interface Container

Parameters:

itemId - Identification of the item to be created.

Returns:

Created item with the given id, or null in case of failure.

java.lang.UnsupportedOperationException

removeItem

public boolean removeItem(java.lang.Object itemId)
                   throws java.lang.UnsupportedOperationException

Remove item identified by Id from the container. This functionality is optional. If the function is not implemented, the functions allways returns false.

Specified by:

removeItem in interface Container

Parameters:

itemId - ID of the Item to remove

Returns:

True iff the operation succeeded.

java.lang.UnsupportedOperationException

removeContainerProperty

public boolean removeContainerProperty(java.lang.Object propertyId)
                                throws java.lang.UnsupportedOperationException

Remove property from all items. Removes a property with given id from all the items in the container. This functionality is optional. If the function is unsupported, it always returns false.

Specified by:

removeContainerProperty in interface Container

Parameters:

propertyId - ID of the Property to remove

Returns:

True iff the operation succeeded.

java.lang.UnsupportedOperationException

setContainerDataSource

public void setContainerDataSource(Container newDataSource)

Set the container as data-source for viewing.

Specified by:

setContainerDataSource in interface Container.Viewer

Parameters:

newDataSource - The new data source Item

getContainerDataSource

public Container getContainerDataSource()

Get viewing data-source container.

Specified by:

getContainerDataSource in interface Container.Viewer

Returns:

data source Container

isMultiSelect

public boolean isMultiSelect()

Is the select in multiselect mode? In multiselect mode

Returns:

Value of property multiSelect.

setMultiSelect

public void setMultiSelect(boolean multiSelect)

Set the multiselect mode. Setting multiselect mode false may loose selection information: if selected items set contains one or more selected items, only one of the selected items is kept as selected.

Parameters:

multiSelect - New value of property multiSelect.

isNewItemsAllowed

public boolean isNewItemsAllowed()

Does the select allow adding new options by the user. If true, the new options can be added to the Container. The text entered by the user is used as id. No that data-source must allow adding new items (it must implement Container.Managed).

Returns:

True iff additions are allowed.

setNewItemsAllowed

public void setNewItemsAllowed(boolean allowNewOptions)

Enable or disable possibility to add new options by the user.

Parameters:

allowNewOptions - New value of property allowNewOptions.

setItemCaption

public void setItemCaption(java.lang.Object itemId,
                           java.lang.String caption)

Override the caption of an item. Setting caption explicitly overrides id, item and index captions.

Parameters:

itemId - The id of the item to be recaptioned.

caption - New caption.

getItemCaption

public java.lang.String getItemCaption(java.lang.Object itemId)

Get the caption of an item. The caption is generated as specified by the item caption mode. See setItemCaptionMode() for more details.

Parameters:

itemId - The id of the item to be queried.

Returns:

caption for specified item.

setItemIcon

public void setItemIcon(java.lang.Object itemId,
                        Resource icon)

Set icon for an item.

Parameters:

itemId - The id of the item to be assigned an icon.

icon - New icon.

getItemIcon

public Resource getItemIcon(java.lang.Object itemId)

Get the item icon.

Parameters:

itemId - The id of the item to be assigned an icon.

Returns:

Icon for the item or null, if not specified.

setItemCaptionMode

public void setItemCaptionMode(int mode)

Set the item caption mode.

The mode can be one of the following ones:

• ITEM_CAPTION_MODE_EXPLICIT_DEFAULTS_ID : Items Id-objects toString() is used as item caption. If caption is explicitly specified, it overrides the id-caption.
• ITEM_CAPTION_MODE_ID : Items Id-objects toString() is used as item caption.
• ITEM_CAPTION_MODE_ITEM : Item-objects toString() is used as item caption.
• ITEM_CAPTION_MODE_INDEX : The index of the item is used as item caption. The index mode can only be used with the containers implementing Container.Indexed interface.
• ITEM_CAPTION_MODE_EXPLICIT : The item captions must be explicitly specified.
• ITEM_CAPTION_MODE_PROPERTY : The item captions are read from property, that must be specified with setItemCaptionPropertyId().

The ITEM_CAPTION_MODE_EXPLICIT_DEFAULTS_ID is the default mode.

Parameters:

mode - One of the modes listed above.

getItemCaptionMode

public int getItemCaptionMode()

Get the item caption mode.

The mode can be one of the following ones:

• ITEM_CAPTION_MODE_EXPLICIT_DEFAULTS_ID : Items Id-objects toString() is used as item caption. If caption is explicitly specified, it overrides the id-caption.
• ITEM_CAPTION_MODE_ID : Items Id-objects toString() is used as item caption.
• ITEM_CAPTION_MODE_ITEM : Item-objects toString() is used as item caption.
• ITEM_CAPTION_MODE_INDEX : The index of the item is used as item caption. The index mode can only be used with the containers implementing Container.Indexed interface.
• ITEM_CAPTION_MODE_EXPLICIT : The item captions must be explicitly specified.
• ITEM_CAPTION_MODE_PROPERTY : The item captions are read from property, that must be specified with setItemCaptionPropertyId().

The ITEM_CAPTION_MODE_EXPLICIT_DEFAULTS_ID is the default mode.

Returns:

One of the modes listed above.

setItemCaptionPropertyId

public void setItemCaptionPropertyId(java.lang.Object propertyId)

Set the item caption property.

Setting the id to a existing property implicitly sets the item caption mode to ITEM_CAPTION_MODE_PROPERTY. If the object is in ITEM_CAPTION_MODE_PROPERTY mode, setting caption property id null resets the item caption mode to ITEM_CAPTION_EXPLICIT_DEFAULTS_ID.

Setting the property id to null disables this feature. The id is null by default

.

getItemCaptionPropertyId

public java.lang.Object getItemCaptionPropertyId()

Get the item caption property.

Returns:

Id of the property used as item caption source.

setItemIconPropertyId

public void setItemIconPropertyId(java.lang.Object propertyId)

Set the item icon property.

If the property id is set to a valid value, each item is given an icon got from the given property of the items. The type of the property must be assignable to Icon.

Note that the icons set with setItemIcon function override the icons from the property.

Setting the property id to null disables this feature. The id is null by default

.

Parameters:

propertyId - Id of the property that specifies icons for items.

getItemIconPropertyId

public java.lang.Object getItemIconPropertyId()

Get the item icon property.

If the property id is set to a valid value, each item is given an icon got from the given property of the items. The type of the property must be assignable to Icon.

Note that the icons set with setItemIcon function override the icons from the property.

Setting the property id to null disables this feature. The id is null by default

.

Returns:

Id of the property containing the item icons.

isSelected

public boolean isSelected(java.lang.Object itemId)

Test if an item is selected

In single select mode testing selection status of the item identified by getNullSelectionItemId() returns true if the value of the property is null.

Parameters:

itemId - Id the of the item to be tested

See Also:

getNullSelectionItemId(), setNullSelectionItemId(Object)

select

public void select(java.lang.Object itemId)

Select an item.

In single select mode selecting item identified by getNullSelectionItemId() sets the value of the property to null.

Parameters:

itemId - Item to be selected.

See Also:

getNullSelectionItemId(), setNullSelectionItemId(Object)

unselect

public void unselect(java.lang.Object itemId)

Unselect an item.

Parameters:

itemId - Item to be unselected.

See Also:

getNullSelectionItemId(), setNullSelectionItemId(Object)

containerPropertySetChange

public void containerPropertySetChange(Container.PropertySetChangeEvent event)

Description copied from interface: Container.PropertySetChangeListener

Notifies this listener that the Containers contents has changed.

Specified by:

containerPropertySetChange in interface Container.PropertySetChangeListener

Parameters:

event - Change event.

See Also:

Container.PropertySetChangeListener.containerPropertySetChange(org.millstone.base.data.Container.PropertySetChangeEvent)

addListener

public void addListener(Container.PropertySetChangeListener listener)

Description copied from interface: Container.PropertySetChangeNotifier

Registers a new Property set change listener for this Container.

Specified by:

addListener in interface Container.PropertySetChangeNotifier

Parameters:

listener - The new Listener to be registered

See Also:

Container.PropertySetChangeNotifier.addListener(org.millstone.base.data.Container.PropertySetChangeListener)

removeListener

public void removeListener(Container.PropertySetChangeListener listener)

Description copied from interface: Container.PropertySetChangeNotifier

Removes a previously registered Property set change listener.

Specified by:

removeListener in interface Container.PropertySetChangeNotifier

Parameters:

listener - Listener to be removed

See Also:

Container.PropertySetChangeNotifier.removeListener(org.millstone.base.data.Container.PropertySetChangeListener)

addListener

public void addListener(Container.ItemSetChangeListener listener)

Description copied from interface: Container.ItemSetChangeNotifier

Adds a Item set change listener for the object.

Specified by:

addListener in interface Container.ItemSetChangeNotifier

Parameters:

listener - listener to be added

See Also:

Container.ItemSetChangeNotifier.addListener(org.millstone.base.data.Container.ItemSetChangeListener)

removeListener

public void removeListener(Container.ItemSetChangeListener listener)

Description copied from interface: Container.ItemSetChangeNotifier

Removes a Item set change listener from the object.

Specified by:

removeListener in interface Container.ItemSetChangeNotifier

Parameters:

listener - listener to be removed

See Also:

Container.ItemSetChangeNotifier.removeListener(org.millstone.base.data.Container.ItemSetChangeListener)

containerItemSetChange

public void containerItemSetChange(Container.ItemSetChangeEvent event)

Description copied from interface: Container.ItemSetChangeListener

Lets the listener know a Containers Item set has changed.

Specified by:

containerItemSetChange in interface Container.ItemSetChangeListener

Parameters:

event - change event text

See Also:

Container.ItemSetChangeListener.containerItemSetChange(org.millstone.base.data.Container.ItemSetChangeEvent)

firePropertySetChange

protected void firePropertySetChange()

Fire property set change event

fireItemSetChange

protected void fireItemSetChange()

Fire item set change event

getNullSelectionItemId

public final java.lang.Object getNullSelectionItemId()

Returns the item id that represents null value of this select in single select mode.

Data interface does not support nulls as item ids. Selecting the item idetified by this id is the same as selecting no items at all. This setting only affects the single select mode.

Returns:

Object Null value item id.

See Also:

setNullSelectionItemId(Object), isSelected(Object), select(Object)

setNullSelectionItemId

public void setNullSelectionItemId(java.lang.Object nullSelectionItemId)

Sets the item id that represents null value of this select.

Data interface does not support nulls as item ids. Selecting the item idetified by this id is the same as selecting no items at all. This setting only affects the single select mode.

See Also:

getNullSelectionItemId(), isSelected(Object), select(Object)