borland Packages  Class Hierarchy  internetbeans Package 

AbstractIxList class (abstract)

java.lang.Object
   +----com.borland.internetbeans.IxComponent
           +----com.borland.internetbeans.AbstractIxDataWidget
                   +----com.borland.internetbeans.AbstractIxControl
                           +----com.borland.internetbeans.AbstractIxList
                                   +----com.borland.internetbeans.IxComboBox
                                   +----com.borland.internetbeans.IxListBox

About the AbstractIxList class

Variables  Properties  Methods  

Implements ColumnAware, DataSetAware, Renderable, Serializable, Cloneable

Note: This package is a feature of JBuilder Professional and Enterprise.

Base class for SELECT controls: comboboxes and listboxes.

If the control is tied to a DataSet column with a picklist, that list of options is automatically populated from the first column of that picklist.


AbstractIxList variables

Variables implemented in this class

Variables implemented in com.borland.internetbeans.AbstractIxControl

Variables implemented in com.borland.internetbeans.AbstractIxDataWidget

Variables implemented in com.borland.internetbeans.IxComponent

AbstractIxList properties

*Read-only properties **Write-only properties

Properties implemented in this class

Properties implemented in com.borland.internetbeans.AbstractIxControl

Properties implemented in com.borland.internetbeans.AbstractIxDataWidget

Properties implemented in com.borland.internetbeans.IxComponent

Properties implemented in java.lang.Object

AbstractIxList methods

Methods implemented in this class

Methods implemented in com.borland.internetbeans.AbstractIxControl

Methods implemented in com.borland.internetbeans.AbstractIxDataWidget

Methods implemented in com.borland.internetbeans.IxComponent

Methods implemented in java.lang.Object


AbstractIxList variables

MULTIPLE_ATTRIBUTE

  protected static final String MULTIPLE_ATTRIBUTE = "multiple"
Name of MULTIPLE attribute, which allows or prevents multiple selection in a listbox.

SIZE_ATTRIBUTE

  protected static final String SIZE_ATTRIBUTE = "size"
Name of SIZE attribute, which indicates the height of the control. Comboboxes are always size 1.

TAG_NAME

  public static final String TAG_NAME = "select"
Tag name for this type of element.

AbstractIxList properties

displayList

 public void setDisplayList(List newItems)
 public void setDisplayList(String[] newItems)
Use a List as display values for list, instead of the strings in the list model.

Parameters:

newItems
List of items to display as options, cannot contain nulls
Use an array of strings as display values for list, instead of the strings in the list model.

Parameters:

newItems
Strings to display as options

itemCount

 public int getItemCount()
Returns number of items in list model.

model

 public ListModel getModel()
 public void setModel(ListModel aModel)
List model that contains options from which to choose.

options

 public void setOptions(List newItems)
 public void setOptions(String[] newItems)
Use an array of strings as the list model.

Parameters:

newItems
Strings to display as options

renderDelegate

 public IxComponent getRenderDelegate()
Called by PageProducer; do not call directly. Automatically builds picklist from DataSet column, if one is specified.

size

 public int getSize()
 public void setSize(int newSize)
Height of list.

AbstractIxList methods

assembleElementBody(outWrap)

  protected void assembleElementBody(OutputWrapper outWrap)
Generates the OPTION elements that comprise the list from which to choose.

Parameters:

outWrap
The stream-like output into which the content goes

Overrides: com.borland.internetbeans.IxComponent.assembleElementBody(outWrap)

assembleTagAttributes(outWrap)

  protected void assembleTagAttributes(OutputWrapper outWrap)
Generates the NAME and VALUE atributes via AbstractIxControl.assembleTagAttributes then the MULTIPLE and SIZE attributes.

Parameters:

outWrap
The stream-like output into which the content goes

Overrides: com.borland.internetbeans.AbstractIxControl.assembleTagAttributes(outWrap)

getClosureTags()

  protected String[] getClosureTags()
SELECT elements require a matching end tag. As a precaution, other form control tag names and the FORM tag name itself are included in case the source markup is malformed.

Overrides: com.borland.internetbeans.IxComponent.getClosureTags()

getElementType()

  protected String getElementType()
Returns the tag name "select".

Overrides: com.borland.internetbeans.IxComponent.getElementType()

getItemAt(int)

  public Object getItemAt(int index)
Returns a single item in the list model.

Parameters:

index
Zero-based index into list mode
Returns item at that index.

isElementEmpty()

  protected boolean isElementEmpty()
SELECT elements are never empty.

Overrides: com.borland.internetbeans.IxComponent.isElementEmpty()

isMultiple()

  protected boolean isMultiple()
Whether the list allows multiple selection (listbox) or not (combobox).

mergeBody(units, int, int)

  public void mergeBody(ParseUnit[] units, int beginIndex, int endIndex)
Called by PageProducer; do not call directly. Reads options from the template.

Parameters:

units
Array of ParseUnit objects that the PageProducer is currently working its way through.
beginIndex
Index into units array that points to element after start tag. If the element body is empty, it points to the end tag.
endIndex
Index into units array that points to element after last unit that comprises body. If the element body is empty, it is the same as beginIndex and points to the end tag.

Parameters: com.borland.internetbeans.IxComponent.mergeBody(units, int, int)

mergeTag(java.lang.String, java.util.Map, boolean)

  public void mergeTag(String tagName, Map attributes, boolean empty)
Called by PageProducer; do not call directly. Reads and stores the value of the SIZE attribute, removes the MULTIPLE attribute because its value is always generated, then calls super.

Parameters:

tagName
Name of the matching tag, e.g. INPUT, SELECT
attributes
Map of attribute values
empty
Whether the source tag was empty

Overrides: com.borland.internetbeans.AbstractIxControl.mergeTag(java.lang.String, java.util.Map, boolean)

setMultiple(boolean)

  protected void setMultiple(boolean newValue)