zul.sel
Class Select

java.lang.Object
  extended by zk.Object
      extended by zk.Widget
          extended by zul.Widget
              extended by 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
 void clearSelection()
          Clears the selection.
 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).
 int getTabindex()
          Returns the tab order of this component.
 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 setTabindex(int tabindex)
          Sets the tab order of this component.
 void toggleItemSelection(Option item)
          If the specified item is selected, it is deselected.
 
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, afterAnima_, afterParentChanged_, appendChild, appendChild, beforeParentChanged_, beforeSendAU_, bind_, bind, bindChildren_, bindDoubleTap_, bindSwipe_, bindTapHold_, canActivate, cleanDrag_, clear, clearCache, cloneDrag_, deferRedraw_, deferRedrawHTML_, detach, doBlur_, doClick_, doDoubleClick_, doFocus_, doKeyDown_, doKeyPress_, doKeyUp_, domAttrs_, domClass_, domListen_, doMouseDown_, doMouseEnter_, doMouseLeave_, doMouseMove_, doMouseOut_, doMouseOver_, doMouseUp_, domStyle_, domTextStyleAttr_, domTooltiptext_, domUnlisten_, doResizeScroll_, doRightClick_, doSelect_, doSwipe_, doTooltipOut_, doTooltipOver_, dropEffect_, extraBind_, fire, fireX, focus_, focus, forcerender, fromPageCoord, get, getAction, getCaveNode, getChildAt, getChildIndex, getClass, getDraggable, getDragMessage_, getDragNode, getDragOptions_, getDrop_, getDroppable, getElementsById, getElementsByName, getFirstNode_, getFloatZIndex_, getHeight, getHflex, getId, getLeft, getMold, getOldWidget_, getPage, getRenderdefer, getSclass, getScrollLeft, getScrollTop, getStyle, 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, scrollIntoView, sendAU_, set, set, setAction, setChildren, setDomVisible_, setDraggable, setDroppable, setFloating_, setFloatZIndex_, setHeight, setHflex, setId, setLeft, setListener, setListener, setListeners, setMold, setRenderdefer, setSclass, setScrollLeft, setScrollTop, setStyle, setTooltiptext, setTop, setTopmost, setVflex, setVisible, setWidth, setZclass, setZIndex, shallChildROD_, 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

setTabindex

public void setTabindex(int tabindex)
Sets the tab order of this component.

Parameters:
tabindex -

getTabindex

public int getTabindex()
Returns the tab order of this component.

Default: 0 (means the same as browser's default).

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.

clearSelection

public void clearSelection()
Clears the selection.



Copyright © 2005-2011 Potix Corporation. All Rights Reserved. SourceForge.net Logo