PHP Class Prado\Web\UI\ActiveControls\TActiveDropDownList
The active control counter part to drop down list control.
The {@link setAutoPostBack AutoPostBack} property is set to true by default.
Thus, when the drop down list selection is changed the {@link onCallback OnCallback} event is
raised after {@link OnSelectedIndexChanged} event.
With {@link TBaseActiveControl::setEnableUpdate() ActiveControl.EnableUpdate}
set to true (default is true), changes to the selection,
after OnLoad event has
been raised, will be updated.
on the client side.
List items can be changed dynamically during a callback request.
Mostrar archivo
Open project: pradosoft/prado
Class Usage Examples
Public Methods
Method |
Description |
|
__construct ( ) |
Creates a new callback control, sets the adapter to
TActiveListControlAdapter. If you override this class, be sure to set the
adapter appropriately by, for example, by calling this constructor. |
|
getActiveControl ( ) : TBaseActiveCallbackControl |
|
|
getClientSide ( ) : TCallbackClientSide |
|
|
onCallback ( $param ) |
This method is invoked when a callback is requested. The method raises
'OnCallback' event to fire up the event handlers. If you override this
method, be sure to call the parent implementation so that the event
handler can be invoked. |
|
onPreRender ( $param ) |
Updates the client-side options if the item list has changed after the OnLoad event. |
|
raiseCallbackEvent ( $param ) |
Raises the callback event. This method is required by {@link
ICallbackEventHandler} interface. |
|
Protected Methods
Method |
Description |
|
addAttributesToRender ( $writer ) |
Ensure that the ID attribute is rendered and registers the javascript code
for initializing the active control. |
|
createListItemCollection ( ) : TActiveListItemCollection |
Creates a collection object to hold list items. A specialized
TActiveListItemCollection is created to allow the drop down list options
to be added. |
|
getClientClassName ( ) : null |
No client class for this control. |
|
renderClientControlScript ( $writer ) |
Override parent implementation, no javascript is rendered here instead
the javascript required for active control is registered in {@link addAttributesToRender}. |
|
Method Details
__construct()
public method
Creates a new callback control, sets the adapter to
TActiveListControlAdapter. If you override this class, be sure to set the
adapter appropriately by, for example, by calling this constructor.
addAttributesToRender()
protected method
Ensure that the ID attribute is rendered and registers the javascript code
for initializing the active control.
createListItemCollection()
protected method
This method may be overriden to create a customized collection.
protected createListItemCollection ( ) : TActiveListItemCollection |
return |
TActiveListItemCollection |
the collection object |
getActiveControl()
public method
public getActiveControl ( ) : TBaseActiveCallbackControl |
return |
TBaseActiveCallbackControl |
standard callback control options. |
getClientClassName()
protected method
This method overrides the parent implementation.
getClientSide()
public method
public getClientSide ( ) : TCallbackClientSide |
return |
TCallbackClientSide |
client side request options. |
onCallback()
public method
This method is invoked when a callback is requested. The method raises
'OnCallback' event to fire up the event handlers. If you override this
method, be sure to call the parent implementation so that the event
handler can be invoked.
onPreRender()
public method
Updates the client-side options if the item list has changed after the OnLoad event.
raiseCallbackEvent()
public method
This method is mainly used by framework and control developers.
renderClientControlScript()
protected method
Override parent implementation, no javascript is rendered here instead
the javascript required for active control is registered in {@link addAttributesToRender}.