zul.sel

Class Select

java.lang.Object

zk.Object

zk.Widget

zul.Widget

zul.sel.Select

public class Select
extends Widget

A HTML select tag.

Field Summary

Fields inherited from class zk.Widget

$weave, auDelay, autag, bindLevel, className, desktop, effects_, firstChild, id, insertingBefore_, inServer, lastChild, nChildren, nextSibling, parent, previousSibling, uuid, widgetName

Fields inherited from class zk.Object

$class, $oid

Method Summary

Modifier and Type	Method and Description
void	clearSelection() Clears the selection.
int	getGroupCount() Returns the number of Optgroup.
Array	getGroups() Returns a list of all Optgroup.
int	getMaxlength() Returns the maximal length of each item's label.
String	getName() Returns the name of this component.
int	getRows() Returns the rows.
int	getSelectedIndex() Returns the index of the selected item (-1 if no one is selected).
boolean	hasGroup() Returns whether any Optgroup exists.
boolean	isDisabled() Returns whether it is disabled.
boolean	isMultiple() Returns whether multiple selections are allowed.
void	selectItem(Option item) Deselects all of the currently selected items and selects the given item.
void	setDisabled(boolean disabled) Sets whether it is disabled.
void	setMaxlength(int maxlength) Sets the maximal length of each item's label.
void	setMultiple(boolean multiple) Sets whether multiple selections are allowed.
void	setName(String name) Sets the name of this component.
void	setRows(int rows) Sets the rows.
void	setSelectedIndex(int selectedIndex) Deselects all of the currently selected items and selects the item with the given index.
void	toggleItemSelection(Option item) If the specified item is selected, it is deselected.
void	updateSelectionDirectly() Internal used only

Methods inherited from class zul.Widget

afterKeyDown_, beforeCtrlKeys_, getContext, getCtrlKeys, getOpenTooltip, getPopup, getTooltip, setContext, setContext, setCtrlKeys, setPopup, setPopup, setTooltip, setTooltip

Methods inherited from class zk.Widget

$, $f, $f, $f, $init, $n, $n, $o, $s, $service, afterAnima_, afterParentChanged_, appendChild, appendChild, beforeParentChanged_, beforeSendAU_, bind_, bind, bindChildren_, bindDoubleTap_, bindMissingAncestors, bindSwipe_, bindTapHold_, canActivate, cleanDrag_, clear, clearCache, cloneDrag_, deferRedraw_, deferRedrawHTML_, detach, doBlur_, doClick_, doDoubleClick_, doFocus_, doKeyDown_, doKeyPress_, doKeyUp_, domAttrs_, domClass_, domListen_, doMouseDown_, doMouseMove_, doMouseOut_, doMouseOver_, doMouseUp_, domStyle_, domTextStyleAttr_, domTooltiptext_, domUnlisten_, doPaste_, doResizeScroll_, doRightClick_, doSelect_, doSwipe_, doTooltipOut_, doTooltipOver_, dropEffect_, extraBind_, fire, fireX, focus_, focus, forcerender, fromPageCoord, get, getAction, getCaveNode, getChildAt, getChildIndex, getClass, getCssflex, getDraggable, getDragMessage_, getDragNode, getDragOptions_, getDrop_, getDroppable, getElementsById, getElementsByName, getFirstNode_, getFloatZIndex_, getHeight, getHflex, getId, getLeft, getMold, getOldWidget_, getPage, getRenderdefer, getSclass, getScrollLeft, getScrollTop, getStyle, getTabindex, getTextNode, getTooltiptext, getTop, getTopWidget, getVflex, getWidth, getZclass, getZIndex, hide, ignoreDescendantFloatUp_, ignoreDrag_, initDrag_, insertBefore, insertChildHTML_, isAutoId, isBinding, isFloating_, isListen, isRealElement, isRealVisible, isRealVisible, isVisible, isVisible, isWatchable_, listen, listenOnFitSize_, mimicMouseDown_, newInstance, nextUuid, onAfterSize, onChildAdded_, onChildRemoved_, onChildRenderDefer_, onChildReplaced_, onChildVisible_, onDrop_, redraw, redrawHTML_, register, removeChild, removeChild, removeChildHTML_, removeHTML_, replaceCavedChildren_, replaceChildHTML_, replaceHTML, replaceWidget, rerender, rerender, rerenderLater_, rerenderNow_, scrollIntoView, sendAU_, set, set, setAction, setChildren, setCssflex, setDomVisible_, setDraggable, setDroppable, setFloating_, setFloatZIndex_, setHeight, setHflex, setId, setLeft, setListener, setListener, setListeners, setMold, setRenderdefer, setSclass, setScrollLeft, setScrollTop, setStyle, setTabindex, setTooltiptext, setTop, setTopmost, setVflex, setVisible, setWidth, setZclass, setZIndex, shallChildROD_, shallFireSizedLaterWhenAddChd_, shallIgnoreClick_, show, smartUpdate, unbind_, unbind, unbindChildren_, unbindDoubleTap_, unbindSwipe_, unbindTapHold_, uncloneDrag_, unlisten, unlistenOnFitSize_, updateDomClass_, updateDomStyle_, uuid, zsync

Methods inherited from class zk.Object

$init, $instanceof, $super, $super, $supers, $supers, afterInit, isAssignableFrom, isInstance, proxy

Methods inherited from class java.lang.Object

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

Method Detail

setMultiple

public void setMultiple(boolean multiple)

Sets whether multiple selections are allowed.

Parameters:

multiple -

isMultiple

public boolean isMultiple()

Returns whether multiple selections are allowed.

Default: false.

Returns:

boolean

setDisabled

public void setDisabled(boolean disabled)

Sets whether it is disabled.

Parameters:

disabled -

isDisabled

public boolean isDisabled()

Returns whether it is disabled.

Default: false.

Returns:

boolean

setSelectedIndex

public void setSelectedIndex(int selectedIndex)

Deselects all of the currently selected items and selects the item with the given index.

Parameters:

selectedIndex -

getSelectedIndex

public int getSelectedIndex()

Returns the index of the selected item (-1 if no one is selected).

Returns:

int

setName

public void setName(String name)

Sets the name of this component.

The name is used only to work with "legacy" Web application that handles user's request by servlets. It works only with HTTP/HTML-based browsers. It doesn't work with other kind of clients.

Don't use this method if your application is purely based on ZK's event-driven model.

Parameters:

name - the name of this component.

getName

public String getName()

Returns the name of this component.

Default: null.

The name is used only to work with "legacy" Web application that handles user's request by servlets. It works only with HTTP/HTML-based browsers. It doesn't work with other kind of clients.

Don't use this method if your application is purely based on ZK's event-driven model.

Returns:

String

setRows

public void setRows(int rows)

Sets the rows.

Note: if both Widget.setHeight(_global_.String) is specified with non-empty, setRows(int) is ignored

Parameters:

rows -

getRows

public int getRows()

Returns the rows. Zero means no limitation.

Default: 0.

Returns:

int

setMaxlength

public void setMaxlength(int maxlength)

Sets the maximal length of each item's label.

Parameters:

maxlength -

getMaxlength

public int getMaxlength()

Returns the maximal length of each item's label.

Returns:

int

toggleItemSelection

public void toggleItemSelection(Option item)

If the specified item is selected, it is deselected. If it is not selected, it is selected. Other items in the list box that are selected are not affected, and retain their selected state.

Parameters:

item -

selectItem

public void selectItem(Option item)

Deselects all of the currently selected items and selects the given item.

Parameters:

item - the item to select. If null, all items are deselected.

updateSelectionDirectly

public void updateSelectionDirectly()

Internal used only

clearSelection

public void clearSelection()

Clears the selection.

hasGroup

public boolean hasGroup()

Returns whether any Optgroup exists.

Returns:

boolean

Since:

8.6.0

getGroupCount

public int getGroupCount()

Returns the number of Optgroup.

Returns:

int

Since:

8.6.0

getGroups

public Array getGroups()

Returns a list of all Optgroup. The order is unmaintained.

Returns:

Array

Since:

8.6.0