Class AbstractDropDown<L,T>

  extended by org.zkoss.zk.ui.AbstractComponent
      extended by org.zkoss.zk.ui.HtmlBasedComponent
          extended by org.zkoss.zul.impl.XulElement
              extended by org.zkoss.zul.Window
                  extended by net.codescore.ui.components.list.ZKObjectList<L>
                      extended by net.codescore.ui.components.list.AbstractDropDown<L,T>
Type Parameters:
L - The list item type
T - The target type
All Implemented Interfaces:
Serializable, Cloneable, Component, IdSpace, ComponentCtrl
Direct Known Subclasses:
CompetitionDD, PersonDD, SchoolDD, TeamDD

public abstract class AbstractDropDown<L,T>
extends ZKObjectList<L>

This component will display an HTML select list and automaticaly set the target's value when an item is selected.
One example is the TeamDD, which is typed as < Team, TeamTarget >, so, when the onSelect() method is called, the TeamTarget.setTeam(Team) method is called, using the currently selected team as the method argument.

Adam Cornett
See Also:
Serialized Form

Nested Class Summary
Nested classes/interfaces inherited from class org.zkoss.zul.Window
Field Summary
private  org.apache.commons.logging.Log log
protected  T targetObject
Fields inherited from class net.codescore.ui.components.list.ZKObjectList
callBackWin, data, initData, list, renderer
Fields inherited from class org.zkoss.zk.ui.HtmlBasedComponent
Fields inherited from interface org.zkoss.zk.ui.Component
Constructor Summary
AbstractDropDown(T target)
          Creates a drop down (HTML select element) using a specified list of items, and sets the target object when an object is chosen from the list.
Method Summary
protected  List<L> getList()
          Performs the NamedQuery specified by the getQuery() method and returns the list.
protected  Query getQuery()
          Creates a new NamedQuery from the getQueryName() method
abstract  String getQueryName()
          Returns the NamedQuery name for this list.
abstract  AbstractRenderer<L> getRenderer()
abstract  void onSelect()
          The action to be performed when the and item is selected from the list.
protected  void reloadList()
          This method re-performs the query and re-initializes the list model and renderer
abstract  void setSelected()
Methods inherited from class net.codescore.ui.components.list.ZKObjectList
addListForward, getCallbackWin, getListSelected, getWindowTitle, initListModel, initListModel, initRenderer, reLoadList, removeObject, setCallbackWin, setList, setListMold, setListWidth, setSelected, setWindowTitle, sort
Methods inherited from class org.zkoss.zul.Window
clone, doEmbedded, doHighlighted, doModal, doOverlapped, doPopup, getBorder, getCaption, getContentSclass, getContentStyle, getCtrlKeys, getDefaultActionOnShow, getMode, getOuterAttrs, getPosition, getRealStyle, getSclass, getTitle, getTitleSclass, inEmbedded, inHighlighted, inModal, inOverlapped, inPopup, insertBefore, isClosable, isSizable, newExtraCtrl, onChildRemoved, onClose, onModal, setBorder, setClosable, setContentSclass, setContentStyle, setCtrlKeys, setDefaultActionOnShow, setDraggable, setMode, setMode, setPage, setParent, setPosition, setSclass, setSizable, setTitle, setVisible
Methods inherited from class org.zkoss.zul.impl.XulElement
getAction, getActionAttrs, getAllOnClickAttrs, getContext, getInnerAttrs, getPopup, getTooltip, setAction, setContext, setContext, setPopup, setPopup, setTooltip, setTooltip
Methods inherited from class org.zkoss.zk.ui.HtmlBasedComponent
focus, getAllOnClickAttrs, getDraggable, getDroppable, getHeight, getLeft, getRealSclass, getRealStyleFlags, getStyle, getTooltiptext, getTop, getWidth, getZIndex, setClass, setDroppable, setFocus, setHeight, setLeft, setStyle, setTooltiptext, setTop, setWidth, setZIndex
Methods inherited from class org.zkoss.zk.ui.AbstractComponent
addAnnotation, addAnnotation, addEventHandler, addEventListener, addForward, addForward, addMoved, addSharedAnnotationMap, addSharedEventHandlerMap, appendAsapAttr, appendAsapAttr, appendChild, applyProperties, containsVariable, detach, equals, getAnnotatedProperties, getAnnotatedPropertiesBy, getAnnotation, getAnnotation, getAnnotations, getAnnotations, getAttribute, getAttribute, getAttributes, getAttributes, getChildren, getCommand, getDefinition, getDesktop, getEventHandler, getEventHandlerNames, getExtraCtrl, getFellow, getFellowIfAny, getFirstChild, getId, getLastChild, getListenerIterator, getMold, getMoldURI, getNamespace, getNextSibling, getPage, getParent, getPreviousSibling, getPropagatee, getRoot, getSpaceOwner, getUuid, getVariable, invalidate, isAsapRequired, isChildable, isInvalidated, isListenerAvailable, isVisible, onChildAdded, onDrawNewChild, onPageAttached, onPageDetached, onWrongValue, redraw, removeAttribute, removeAttribute, removeChild, removeEventListener, removeForward, removeForward, response, sessionDidActivate, sessionWillPassivate, setAttribute, setAttribute, setComponentDefinition, setId, setMold, setPageBefore, setVariable, smartUpdate, smartUpdate, smartUpdate, smartUpdateDeferred, smartUpdateValues, toString, unsetVariable
Methods inherited from class java.lang.Object
finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.zkoss.zk.ui.IdSpace
getFellow, getFellowIfAny

Field Detail


private org.apache.commons.logging.Log log


protected final T targetObject
Constructor Detail


public AbstractDropDown(T target)
Creates a drop down (HTML select element) using a specified list of items, and sets the target object when an object is chosen from the list.

target - The target object for the list
Method Detail


public abstract String getQueryName()
Returns the NamedQuery name for this list.



public abstract AbstractRenderer<L> getRenderer()
The renderer to be used for the list.


public abstract void onSelect()
The action to be performed when the and item is selected from the list.

onSelect in class ZKObjectList<L>


public abstract void setSelected()


protected List<L> getList()
Performs the NamedQuery specified by the getQuery() method and returns the list.

A List of type that is to be displayed.


protected Query getQuery()
Creates a new NamedQuery from the getQueryName() method

A Query that will generate a list of items to be displayed in the list.


protected void reloadList()
This method re-performs the query and re-initializes the list model and renderer

Copyright 2008 © Adam Cornett, Andrew Conner All Rights Reserved.