Class \Prado\Web\UI\ActiveControls\TActiveDropDownList
TActiveDropDownList class.
The active control counter part to drop down list control. The \Prado\Web\UI\ActiveControls\setAutoPostBack property is set to true by default. Thus, when the drop down list selection is changed the \Prado\Web\UI\ActiveControls\onCallback event is raised after OnSelectedIndexChanged event.
With 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.
Class hierarchy
- \Prado\Web\UI\ActiveControls\TActiveDropDownList implements IActiveControl, ICallbackEventHandler
-
\Prado\Web\UI\WebControls\TDropDownList
implements
IPostBackDataHandler, IValidatable -
\Prado\Web\UI\WebControls\TListControl
implements
IDataRenderer
-
\Prado\Web\UI\WebControls\TDataBoundControl
-
\Prado\Web\UI\WebControls\TWebControl
implements
IStyleable
-
\Prado\Web\UI\TControl
implements
IRenderable, IBindable
-
\Prado\TApplicationComponent
-
\Prado\TComponent
Since: 3.1
public
|
__construct() : mixed
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.
|
public
|
|
public
|
|
public
|
onCallback(TCallbackEventParameter $param) : mixed
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.
|
public
|
onPreRender(mixed $param) : mixed
Updates the client-side options if the item list has changed after the OnLoad event.
|
public
|
raiseCallbackEvent(TCallbackEventParameter $param) : mixed
Raises the callback event. This method is required by {@see
ICallbackEventHandler} interface.
This method is mainly used by framework and control developers. |
protected
|
addAttributesToRender(mixed $writer) : mixed
Ensure that the ID attribute is rendered and registers the javascript code
for initializing the active control.
|
protected
|
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.
This method may be overriden to create a customized collection. |
protected
|
getClientClassName() : string
No client class for this control.
This method overrides the parent implementation. |
protected
|
renderClientControlScript(mixed $writer) : mixed
Override parent implementation, no javascript is rendered here instead
the javascript required for active control is registered in {@see addAttributesToRender}.
|