org.apache.myfaces.trinidad.component
Class UIXSelectInput

java.lang.Object
  extended by javax.faces.component.UIComponent
      extended by org.apache.myfaces.trinidad.component.UIXComponent
          extended by org.apache.myfaces.trinidad.component.UIXComponentBase
              extended by org.apache.myfaces.trinidad.component.UIXValue
                  extended by org.apache.myfaces.trinidad.component.UIXEditableValue
                      extended by org.apache.myfaces.trinidad.component.UIXSelectInput
All Implemented Interfaces:
javax.faces.component.ActionSource, javax.faces.component.EditableValueHolder, javax.faces.component.StateHolder, javax.faces.component.ValueHolder
Direct Known Subclasses:
CoreInputColor, CoreInputDate, CoreInputListOfValues

public class UIXSelectInput
extends UIXEditableValue
implements javax.faces.component.ActionSource

selectInput is a base abstraction for components that allow both input and selection from a list of possible values.

Events:

Type Phases Description
javax.faces.event.ActionEvent Apply Request Values Event delivered when the "action" of the component has been invoked; for example, by clicking on a button. The action may result in page navigation.
org.apache.myfaces.trinidad.event.ReturnEvent Apply Request Values Event delivered when the dialog has completed successfully.
javax.faces.event.ValueChangeEvent Process Validations
Apply Request Values
The valueChange event is delivered when the value attribute is changed.
org.apache.myfaces.trinidad.event.AttributeChangeEvent Invoke Application
Apply Request Values
Event delivered to describe an attribute change. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change events might include the width of a column that supported client-side resizing.


Field Summary
static PropertyKey ACTION_KEY
           
static PropertyKey ACTION_LISTENER_KEY
           
static java.lang.String COMPONENT_FAMILY
           
static java.lang.String COMPONENT_TYPE
           
static PropertyKey RETURN_LISTENER_KEY
           
static FacesBean.Type TYPE
           
 
Fields inherited from class org.apache.myfaces.trinidad.component.UIXEditableValue
CONVERSION_MESSAGE_ID, IMMEDIATE_KEY, LOCAL_VALUE_SET_KEY, REQUIRED_KEY, REQUIRED_MESSAGE_DETAIL_KEY, REQUIRED_MESSAGE_ID, SUBMITTED_VALUE_KEY, VALID_KEY, VALIDATOR_KEY, VALIDATORS_KEY, VALUE_CHANGE_LISTENER_KEY
 
Fields inherited from class org.apache.myfaces.trinidad.component.UIXValue
CONVERTER_KEY, VALUE_KEY
 
Fields inherited from class org.apache.myfaces.trinidad.component.UIXComponentBase
BINDING_KEY, ID_KEY, RENDERED_KEY, RENDERER_TYPE_KEY, TRANSIENT_KEY
 
Constructor Summary
  UIXSelectInput()
          Construct an instance of the UIXSelectInput.
protected UIXSelectInput(java.lang.String rendererType)
          Construct an instance of the UIXSelectInput.
 
Method Summary
 void addActionListener(javax.faces.event.ActionListener listener)
          Adds a action listener.
 void addReturnListener(ReturnListener listener)
          Adds a return listener.
 void broadcast(javax.faces.event.FacesEvent event)
          In addition to to the default UIComponent.broadcast(javax.faces.event.FacesEvent) processing, pass the ValueChangeEvent being broadcast to the method referenced by valueChangeListener (if any).
 javax.faces.el.MethodBinding getAction()
          Gets a reference to an action method sent by the commandButton, or the static outcome of an action
 javax.faces.el.MethodBinding getActionListener()
          Gets a method reference to an action listener
 javax.faces.event.ActionListener[] getActionListeners()
          Returns an array of attached action listeners.
protected  FacesBean.Type getBeanType()
           
 java.lang.String getFamily()
           
 javax.faces.el.MethodBinding getReturnListener()
          Gets a method reference to an return listener
 ReturnListener[] getReturnListeners()
          Returns an array of attached return listeners.
 void queueEvent(javax.faces.event.FacesEvent e)
          Intercept queueEvent and mark the phaseId for any ActionEvents to be PhaseId.APPLY_REQUEST_VALUES.
 void removeActionListener(javax.faces.event.ActionListener listener)
          Removes a action listener.
 void removeReturnListener(ReturnListener listener)
          Removes a return listener.
 void setAction(javax.faces.el.MethodBinding action)
          Sets a reference to an action method sent by the commandButton, or the static outcome of an action
 void setActionListener(javax.faces.el.MethodBinding actionListener)
          Sets a method reference to an action listener
 void setReturnListener(javax.faces.el.MethodBinding returnListener)
          Sets a method reference to an return listener
 
Methods inherited from class org.apache.myfaces.trinidad.component.UIXEditableValue
addValidator, addValueChangeListener, compareValues, getConvertedValue, getRequiredMessageDetail, getRequiredMessageKey, getSubmittedValue, getValidator, getValidators, getValueChangeListener, getValueChangeListeners, isEmpty, isImmediate, isLocalValueSet, isRequired, isValid, processDecodes, processUpdates, processValidators, removeValidator, removeValueChangeListener, resetValue, setImmediate, setLocalValueSet, setRequired, setRequiredMessageDetail, setSubmittedValue, setValid, setValidator, setValueChangeListener, updateModel, validate, validateValue
 
Methods inherited from class org.apache.myfaces.trinidad.component.UIXValue
getConverter, getLocalValue, getValue, setConverter, setValue
 
Methods inherited from class org.apache.myfaces.trinidad.component.UIXComponentBase
addAttributeChange, addAttributeChangeListener, addFacesListener, broadcastToMethodBinding, createFacesBean, decode, decodeChildren, decodeChildrenImpl, encodeAll, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributeChangeListener, getAttributeChangeListeners, getAttributes, getBooleanProperty, getChildCount, getChildren, getClientId, getFacesBean, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacetNames, getFacets, getFacetsAndChildren, getId, getIntProperty, getLifecycleRenderer, getLocalClientId, getParent, getProperty, getPropertyKey, getRenderer, getRendererType, getRendersChildren, getValueBinding, isRendered, isTransient, markInitialState, processRestoreState, processSaveState, removeAttributeChangeListener, removeFacesListener, restoreState, saveState, setAttributeChangeListener, setBooleanProperty, setId, setIntProperty, setParent, setProperty, setRendered, setRendererType, setTransient, setValueBinding, toString, updateChildren, updateChildrenImpl, validateChildren, validateChildrenImpl
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface javax.faces.component.ActionSource
isImmediate, setImmediate
 
Methods inherited from interface javax.faces.component.ValueHolder
getConverter, getLocalValue, getValue, setConverter, setValue
 

Field Detail

TYPE

public static final FacesBean.Type TYPE

ACTION_KEY

public static final PropertyKey ACTION_KEY

ACTION_LISTENER_KEY

public static final PropertyKey ACTION_LISTENER_KEY

RETURN_LISTENER_KEY

public static final PropertyKey RETURN_LISTENER_KEY

COMPONENT_FAMILY

public static final java.lang.String COMPONENT_FAMILY
See Also:
Constant Field Values

COMPONENT_TYPE

public static final java.lang.String COMPONENT_TYPE
See Also:
Constant Field Values
Constructor Detail

UIXSelectInput

public UIXSelectInput()
Construct an instance of the UIXSelectInput.


UIXSelectInput

protected UIXSelectInput(java.lang.String rendererType)
Construct an instance of the UIXSelectInput.

Method Detail

queueEvent

public void queueEvent(javax.faces.event.FacesEvent e)

Intercept queueEvent and mark the phaseId for any ActionEvents to be PhaseId.APPLY_REQUEST_VALUES.

Overrides:
queueEvent in class UIXComponentBase

broadcast

public void broadcast(javax.faces.event.FacesEvent event)
               throws javax.faces.event.AbortProcessingException
In addition to to the default UIComponent.broadcast(javax.faces.event.FacesEvent) processing, pass the ValueChangeEvent being broadcast to the method referenced by valueChangeListener (if any).

Overrides:
broadcast in class UIXEditableValue
Parameters:
event - FacesEvent to be broadcast
Throws:
javax.faces.event.AbortProcessingException - Signal the JavaServer Faces implementation that no further processing on the current event should be performed

getAction

public final javax.faces.el.MethodBinding getAction()
Gets a reference to an action method sent by the commandButton, or the static outcome of an action

Specified by:
getAction in interface javax.faces.component.ActionSource
Returns:
the new action value

setAction

public final void setAction(javax.faces.el.MethodBinding action)
Sets a reference to an action method sent by the commandButton, or the static outcome of an action

Specified by:
setAction in interface javax.faces.component.ActionSource
Parameters:
action - the new action value

getActionListener

public final javax.faces.el.MethodBinding getActionListener()
Gets a method reference to an action listener

Specified by:
getActionListener in interface javax.faces.component.ActionSource
Returns:
the new actionListener value

setActionListener

public final void setActionListener(javax.faces.el.MethodBinding actionListener)
Sets a method reference to an action listener

Specified by:
setActionListener in interface javax.faces.component.ActionSource
Parameters:
actionListener - the new actionListener value

getReturnListener

public final javax.faces.el.MethodBinding getReturnListener()
Gets a method reference to an return listener

Returns:
the new returnListener value

setReturnListener

public final void setReturnListener(javax.faces.el.MethodBinding returnListener)
Sets a method reference to an return listener

Parameters:
returnListener - the new returnListener value

addActionListener

public final void addActionListener(javax.faces.event.ActionListener listener)
Adds a action listener.

Specified by:
addActionListener in interface javax.faces.component.ActionSource
Parameters:
listener - the action listener to add

removeActionListener

public final void removeActionListener(javax.faces.event.ActionListener listener)
Removes a action listener.

Specified by:
removeActionListener in interface javax.faces.component.ActionSource
Parameters:
listener - the action listener to remove

getActionListeners

public final javax.faces.event.ActionListener[] getActionListeners()
Returns an array of attached action listeners.

Specified by:
getActionListeners in interface javax.faces.component.ActionSource
Returns:
an array of attached action listeners.

addReturnListener

public final void addReturnListener(ReturnListener listener)
Adds a return listener.

Parameters:
listener - the return listener to add

removeReturnListener

public final void removeReturnListener(ReturnListener listener)
Removes a return listener.

Parameters:
listener - the return listener to remove

getReturnListeners

public final ReturnListener[] getReturnListeners()
Returns an array of attached return listeners.

Returns:
an array of attached return listeners.

getFamily

public java.lang.String getFamily()
Overrides:
getFamily in class UIXEditableValue

getBeanType

protected FacesBean.Type getBeanType()
Overrides:
getBeanType in class UIXEditableValue


Copyright © 2001-2010 The Apache Software Foundation. All Rights Reserved.