org.pajes.html
Class SelectList

java.lang.Object
  org.pajes.html.Tag
      org.pajes.html.Input
          org.pajes.html.Select
              org.pajes.html.SelectList

All Implemented Interfaces:

java.lang.Cloneable, HTML, InputMandatoryValidation, InputValidation, java.io.Serializable, Traversable

public class SelectList

extends Select

implements Traversable

Generates the <SELECT> and associated <OPTION> tags to create list boxes and drop-down lists.

See Also:

Option, OptionGroup, Serialized Form

Field Summary

Fields inherited from class org.pajes.html.Select

NULL_ENTRY

Fields inherited from class org.pajes.html.Input

TYPE_ATTRIBUTE

Fields inherited from class org.pajes.html.Tag

ON_CLICK_ATTRIBUTE, TAG_CLOSE, TAG_LEFT, TAG_RIGHT

Constructor Summary

SelectList()
Default constructor creates an empty select list.

SelectList(Form form, java.lang.String name)
Create a drop down list or select box.

SelectList(Form form, java.lang.String name, boolean allowMultipleItemsToBeSelected)
Create a drop down list or select box.

SelectList(Form form, java.lang.String name, boolean allowMultipleItemsToBeSelected, int rowsToDisplay)
Create a drop down list or select box.

SelectList(Form form, java.lang.String name, boolean allowMultipleItemsToBeSelected, int rowsToDisplay, boolean isRequired)
Create a drop down list or select box.

SelectList(Form form, java.lang.String name, int rowsToDisplay)
Create a drop down list or select box.

SelectList(Form form, java.lang.String name, int rowsToDisplay, boolean allowMultipleItemsToBeSelected, boolean isRequired, int indexToIgnore)
Create a drop down list or select box.

Method Summary

SelectList	add(java.util.List options) Adds options from a List.
SelectList	add(OptionItem option) Adds an option item to the list.
SelectList	add(Option option, java.lang.String label) Adds an option item to an OptionGroup.
SelectList	add(java.lang.String option) Adds an option to the drop down list.
SelectList	add(java.lang.String[] options) Adds options from an array of Strings.
SelectList	add(java.lang.String[][] options) Adds options from an array of Strings.
SelectList	add(java.lang.String option, java.lang.String value) Adds an option to the drop down list.
SelectList	add(java.lang.String option, java.lang.String value, boolean selected) Adds an option to the drop down list.
Select	clearDefaultValues() Clears the default selected values for the list.
java.lang.Object	clone() Allows a tag to be cloned.
HTML	get(int position) Gets the HTML object from the specified position in the container.
protected Option	getNull() Returns the default null entry, or null if no null entry is to be generated for this list.
java.util.Iterator	getOptions() Returns an Iterator of OptionItem instances.
java.lang.String[]	getSelectedOptions() Returns an array of the currently selected options.
void	remove() Removes all the options currently stored in the select list.
Traversable	set(HTML htmlObject, int position) Sets an HTML object at a specified position in the container.
Input	setValue(java.lang.String value) Sets the default value to be initially selected.
Traversable	setWritable(boolean visible, boolean cascade) Determines if this object and its contents should be returned to the browser.
int	size() Returns the number of HTML objects in the current container.
protected void	writeContent(Browser browser) Called to write the content between the start and end tags.

Methods inherited from class org.pajes.html.Select

getMultipleSelectAllowed, getRowsToDisplay, getSearchField, isMandatory, setGenerateNull, setGenerateNull, setIndexToIgnoreInMandatoryCheck, setMandatory, setMultipleSelectAllowed, setRowsToDisplay, write, writeSearchField

Methods inherited from class org.pajes.html.Input

addClientValidation, addContent, getClientValidation, getClientValidation, getDOMReference, getFieldNameForErrorMessage, getForm, getInstance, getLabel, getName, getOnBlurHandler, getOnChangeHandler, getOnFocusHandler, getOnSelectHandler, getReadOnlyStyleSheetClass, getTabIndex, getType, getValue, isChangeFlagEnabled, isDisabled, isReadOnly, isRequiringValidation, logNoFormWarning, removeClientValidation, removeClientValidation, removeClientValidation, removeMandatoryClientValidation, setChanged, setChangedFlag, setContent, setDisabled, setFieldNameInErrorMessage, setFieldNameInErrorMessage, setForm, setId, setLabel, setName, setOnBlurHandler, setOnBlurValidation, setOnChangeHandler, setOnClickHandler, setOnFocusHandler, setOnSelectHandler, setReadOnly, setReadOnlyStyleSheetClass, setTabIndex, setTabIndex, setTabIndex

Methods inherited from class org.pajes.html.Tag

addAttribute, addAttributes, addAttributes, clearAttribute, clearAttributes, destroy, getAttribute, getAttributes, getAttributeSet, getContainer, getContent, getDocument, getId, getOnClickHandler, getOnDBLClickHandler, getOnKeyDownHandler, getOnKeyPressHandler, getOnKeyUpHandler, getOnMouseDownHandler, getOnMouseOutHandler, getOnMouseOverHandler, getOnMouseUpHandler, getStyle, getStyleSheetClass, getTagName, getTitle, getWritePermission, init, initAttributes, isWritable, isWritable, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttributes, setAttributes, setContainer, setContent, setOnDBLClickHandler, setOnKeyDownHandler, setOnKeyPressHandler, setOnKeyUpHandler, setOnMouseDownHandler, setOnMouseOutHandler, setOnMouseOverHandler, setOnMouseUpHandler, setStyle, setStyleSheetClass, setTagName, setTitle, setWritable, setWriteAttributes, setWriteEndTag, setWritelnAfter, setWritelnAfterContent, setWritelnBefore, setWritelnBeforeContent, setWritePermission, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.pajes.html.InputValidation

getClientValidation, getDOMReference, getName, isRequiringValidation, setOnBlurValidation

Constructor Detail

SelectList

public SelectList()

Default constructor creates an empty select list.

SelectList

public SelectList(Form form,
                  java.lang.String name)

Create a drop down list or select box.

Parameters:

form - the form on which this input field will appear. Note that the element must still be added to the form - this reference is used by the getDOMReference() method to determine the fully qualified element name.

name - the name of the list box.

SelectList

public SelectList(Form form,
                  java.lang.String name,
                  boolean allowMultipleItemsToBeSelected)

Create a drop down list or select box.

Parameters:

form - the form on which this input field will appear. Note that the element must still be added to the form - this reference is used by the getDOMReference() method to determine the fully qualified element name.

name - the name of the list box.

allowMultipleItemsToBeSelected - true if multiple items are selectable

SelectList

public SelectList(Form form,
                  java.lang.String name,
                  int rowsToDisplay)

Create a drop down list or select box.

Parameters:

form - the form on which this input field will appear. Note that the element must still be added to the form - this reference is used by the getDOMReference() method to determine the fully qualified element name.

name - the name of the list box.

rowsToDisplay - the number of rows that are shown when the user clicks on the select list

SelectList

public SelectList(Form form,
                  java.lang.String name,
                  boolean allowMultipleItemsToBeSelected,
                  int rowsToDisplay)

Create a drop down list or select box.

Parameters:

form - the form on which this input field will appear. Note that the element must still be added to the form - this reference is used by the getDOMReference() method to determine the fully qualified element name.

name - the name of the list box.

allowMultipleItemsToBeSelected - true is multiple items are selectable

rowsToDisplay - the number of rows that are shown when the user clicks on the select list

SelectList

public SelectList(Form form,
                  java.lang.String name,
                  boolean allowMultipleItemsToBeSelected,
                  int rowsToDisplay,
                  boolean isRequired)

Create a drop down list or select box.

Parameters:

form - the form on which this input field will appear. Note that the element must still be added to the form - this reference is used by the getDOMReference() method to determine the fully qualified element name.

name - the name of the list box.

allowMultipleItemsToBeSelected - true is multiple items are selectable

rowsToDisplay - the number of rows that are shown when the user clicks on the select list

isRequired - true if an item must be selected from the list

SelectList

public SelectList(Form form,
                  java.lang.String name,
                  int rowsToDisplay,
                  boolean allowMultipleItemsToBeSelected,
                  boolean isRequired,
                  int indexToIgnore)

Create a drop down list or select box.

Parameters:

form - the form on which this input field will appear. Note that the element must still be added to the form - this reference is used by the getDOMReference() method to determine the fully qualified element name.

name - the name of the list box.

rowsToDisplay - the number of rows that are shown when the user clicks on the select list

allowMultipleItemsToBeSelected - true is multiple items are selectable

isRequired - true if an item must be selected from the list

indexToIgnore - a zero-indexed item in the select list to be ignored when determining if a value has been selected from the list.

Method Detail

getOptions

public java.util.Iterator getOptions()

Returns an Iterator of OptionItem instances.

Specified by:

getOptions in class Select

Returns:

an Iterator of OptionItem instances.

getSelectedOptions

public java.lang.String[] getSelectedOptions()

Returns an array of the currently selected options.

Returns:

an array of the currently selected options.

setValue

public Input setValue(java.lang.String value)

Sets the default value to be initially selected.

Overrides:

setValue in class Input

Parameters:

value - the value to set as the default.

Returns:

the modified Input object.

setWritable

public Traversable setWritable(boolean visible,
                               boolean cascade)

Determines if this object and its contents should be returned to the browser.

Specified by:

setWritable in interface Traversable

Parameters:

visible - true if this element should be returned to the browser, or false if it should not.

cascade - true if any contained elements should be returned to the browser, or false if they should not. Note that this option does not affect any tags that would not normally return their contents if they themselves are not writable (e.g. Table tags).

Returns:

the modified Traversable object

See Also:

Tag.setWritable(boolean)

add

public SelectList add(java.util.List options)

Adds options from a List. Each element within the List may contain:

• an OptionItem instance.
• a String (in which case the String will be added as both the option description and the value).
• a String[] (in which case it is assumed to be a two element array, where element 0 is the option description and element 1 is the option value).

Parameters:

options - the List object containing the options.

Returns:

the modified SelectList object.

add

public SelectList add(java.lang.String option)

Adds an option to the drop down list.

Parameters:

option - - The Text to display in the select list - the Text will be returned as the value when selected

Returns:

the modified SelectList object.

add

public SelectList add(java.lang.String option,
                      java.lang.String value)

Adds an option to the drop down list.

Parameters:

option - - The Text to display in the select list

value - - the value to be returned when the item is selected

Returns:

the modified SelectList object.

add

public SelectList add(java.lang.String option,
                      java.lang.String value,
                      boolean selected)

Adds an option to the drop down list.

Parameters:

option - the Text to display in the select list

value - the value to be returned when the item is selected

selected - set to true if this is the default value

Returns:

the modified SelectList object.

add

public SelectList add(java.lang.String[] options)

Adds options from an array of Strings. Each element in the array will be used as the value and the description.

Parameters:

options - the array containing the String options.

Returns:

the modified SelectList object.

add

public SelectList add(java.lang.String[][] options)

Adds options from an array of Strings. Each element in the array is a two element array where element 0 is the option description and element 1 is the option value.

Parameters:

options - the array containing the String options.

Returns:

the modified SelectList object.

add

public SelectList add(Option option,
                      java.lang.String label)

Adds an option item to an OptionGroup. If the specified OptionGroup does not exist, it will be created.

Parameters:

option - - The Option to be added.

label - - The label of the OptionGroup to which the option should be added.

Returns:

the modified SelectList object.

add

public SelectList add(OptionItem option)

Adds an option item to the list.

Parameters:

option - - The Option or OptionGroup

Returns:

the modified SelectList object.

clearDefaultValues

public Select clearDefaultValues()

Clears the default selected values for the list.

Returns:

the modified Select object.

See Also:

setValue(java.lang.String)

clone

public java.lang.Object clone()

Allows a tag to be cloned. Over-rides the clone() method in Tag to do a deep clone: all the objects contained in this object will be cloned individually.

Specified by:

clone in interface HTML

Overrides:

clone in class Input

Returns:

The new SelectList instance.

get

public HTML get(int position)

Gets the HTML object from the specified position in the container.

Specified by:

get in interface Traversable

Parameters:

position - the position to get the html object

Returns:

the object at the specified location

remove

public void remove()

Removes all the options currently stored in the select list.

set

public Traversable set(HTML htmlObject,
                       int position)

Sets an HTML object at a specified position in the container.

Specified by:

set in interface Traversable

Parameters:

htmlObject - the Object to add.

position - the position at which to place the html object.

Returns:

the modified Traversable object.

size

public int size()

Returns the number of HTML objects in the current container.

Specified by:

size in interface Traversable

Returns:

the number of HTML objects in the current container.

getNull

protected Option getNull()

Description copied from class: Select

Returns the default null entry, or null if no null entry is to be generated for this list.

Overrides:

getNull in class Select

Returns:

the default null entry, or null if no null entry is to be generated for this list.

See Also:

Select.getNull()

writeContent

protected void writeContent(Browser browser)
                     throws java.io.IOException

Called to write the content between the start and end tags.

Overrides:

writeContent in class Select

Parameters:

browser - the browser to which the results are to be output.

Throws:

java.io.IOException - if an I/O error occurs writing to the browser.