System.Web.UI.WebControls
[ class tree: System.Web.UI.WebControls ] [ index: System.Web.UI.WebControls ] [ all elements ]

Class: TDropDownList

Source Location: /Web/UI/WebControls/TDropDownList.php

Class Overview

TComponent
   |
   --TControl
      |
      --TWebControl
         |
         --TListControl
            |
            --TDropDownList

TDropDownList class

Class Details

[line 45]
TDropDownList class

TDropDownList create a single selection drop-down list on the Web page. This class merely overrides the render() method to output a select list.

Example (template)

  1. <com:TDropDownList>
  2. <com:TListItem Text="item1" Value="value1" />
  3. <com:TListItem Text="item2" Value="value2" Selected="true" />
  4. <com:TListItem Text="item3" Value="value3" />
  5. </com:TDropDownList>




version:  $Revision: 1.24 $ $Date: 2005/02/09 07:12:53 $
author:  Qiang Xue <qiang.xue@gmail.com>
author:  Marcus Nyeholt <tanus@users.sourceforge.net>
see:  TListControl Namespace: System.Web.UI.WebControls


[ Top ]

Methods


Inherited Variables

Inherited Methods

Class: TListControl

TListControl::__construct()
Set the items list to be empty.
TListControl::addParsedObject()
This method overrides the parent implementation to handle TListItem.
TListControl::allowBody()
Overrides parent implementation to disable body addition.
TListControl::allSelection()
Sets all items selected.
TListControl::clearSelection()
Sets all items not selected.
TListControl::getDataSource()
TListControl::getDataTextField()
TListControl::getDataTextFormatString()
TListControl::getDataValueField()
TListControl::getItems()
TListControl::getSelectedIndex()
TListControl::getSelectedItem()
TListControl::getSelectedValue()
TListControl::getValidationPropertyValue()
Returns the value of the property that needs validation.
TListControl::invertSelection()
Invert items selection.
TListControl::isAutoPostBack()
TListControl::isEncodeText()
TListControl::loadPostData()
Loads user input data.
TListControl::loadViewState()
Loads viewstate into this control and its children.
TListControl::onDataBinding()
This method is invoked when OnDataBinding event is raised.
TListControl::onSelectionChanged()
This method is invoked when the value of the Selection property changes between posts to the server.
TListControl::raisePostDataChangedEvent()
Raises postdata changed event.
TListControl::saveViewState()
Returns the viewstate of this control and its children.
TListControl::setAutoPostBack()
Sets the value indicating if postback automatically.
TListControl::setDataSource()
Sets the data source that populates the items of the list control.
TListControl::setDataTextField()
TListControl::setDataTextFormatString()
TListControl::setDataValueField()
TListControl::setEncodeText()
Sets the value indicating whether the text in list items should be HTML encoded before rendering
TListControl::setSelectedIndex()
TListControl::setSelectedValue()
Sets selection by item value.

Class: TWebControl

TWebControl::appendJavascriptEvent()
Append a javascript statement to a particular attribute, e.g. "onclick".
TWebControl::getAccessKey()
TWebControl::getAttributesToRender()
This overrides the parent implementation by rendering more TWebControl-specific attributes.
TWebControl::getBackColor()
TWebControl::getBorderColor()
TWebControl::getBorderStyle()
TWebControl::getBorderWidth()
TWebControl::getCssClass()
TWebControl::getForeColor()
TWebControl::getHeight()
TWebControl::getJavascriptEvents()
Get the list of all the javascript statements.
TWebControl::getStyle()
TWebControl::getTabIndex()
TWebControl::getToolTip()
TWebControl::getWidth()
TWebControl::isEnabled()
TWebControl::parseStyle()
Parses a CSS style string into an array representation.
TWebControl::removeJavascriptEvent()
Remove all or a particular javascript statements.
TWebControl::setAccessKey()
Sets the access key of the control.
TWebControl::setBackColor()
Sets the background color of the control
TWebControl::setBorderColor()
Sets the border color of the control
TWebControl::setBorderStyle()
Sets the border style of the control
TWebControl::setBorderWidth()
Sets the border width of the control
TWebControl::setCssClass()
Sets the CSS class name of the control
TWebControl::setEnabled()
Enables or disables a control.
TWebControl::setForeColor()
Sets the foreground color of the control
TWebControl::setHeight()
Sets the height of the control
TWebControl::setStyle()
Sets the CSS style of the control.
TWebControl::setTabIndex()
Sets the tab index of the control.
TWebControl::setToolTip()
Sets the tooltip of the control.
TWebControl::setWidth()
Sets the width of the control

Class: TControl

TControl::__construct()
Constructor.
TControl::addBody()
Appends an object into the body collection of this control.
TControl::addParsedObject()
Adds the object parsed in template as a body of the component.
TControl::allowBody()
Determines whether the control can add the object as a body.
TControl::clearViewState()
Clears viewstate
TControl::findBodyControl()
TControl::getAttribute()
TControl::getAttributes()
Returns the attribute list object.
TControl::getAttributesToRender()
Returns attributes to be rendered.
TControl::getBodies()
TControl::getClientID()
Returns the client ID of the component.
TControl::getContainer()
Returns the container of this component.
TControl::getSkinName()
TControl::getTagName()
TControl::getViewState()
Returns a viewstate value.
TControl::initSkin()
Initializes a skin for the control. If a skin name is provided then that skin will be loaded.
TControl::isViewStateEnabled()
TControl::isVisible()
This method checks whether a control is visible.
TControl::loadViewState()
Loads viewstate into this component and its children.
TControl::onBubbleEvent()
This method responds to a bubbled event.
TControl::onInit()
This method is invoked when the control enters 'Init' stage.
TControl::onInitRecursive()
Calls onInit of this control and its children recursively.
TControl::onLoad()
This method is invoked when the control enters 'Load' stage.
TControl::onLoadRecursive()
Calls onLoad of this control and its children recursively.
TControl::onPreRender()
This method is invoked when the control enters 'PreRender' stage.
TControl::onPreRenderRecursive()
Calls onPreRender of this control and its children recursively.
TControl::onUnload()
This method is invoked when the control enters 'Unload' stage.
TControl::onUnloadRecursive()
Calls onUnload of this control and its children recursively.
TControl::raiseBubbleEvent()
Invokes the parent's onBubbleEvent method.
TControl::removeBodies()
Removes all body content.
TControl::render()
Renders this control.
TControl::renderAttributes()
Renders the attributes.
TControl::renderBody()
Renders the body content.
TControl::saveViewState()
Returns the viewstate of this component and its children.
TControl::setAttribute()
Sets an attribute.
TControl::setContainer()
Sets the container of this component
TControl::setEnableViewState()
TControl::setSkinName()
Sets the skin to use for this control
TControl::setTagName()
Sets the tag name.
TControl::setViewState()
Sets a viewstate value.
TControl::setVisible()
TControl::synchronizeControl()
This method should only be used by framework developer.

Class: TComponent

TComponent::__construct()
Constructor.
TComponent::addChild()
Adds a child component.
TComponent::addParsedObject()
Handles a component or string met in template.
TComponent::attachEventHandler()
Attaches a handler function to an event.
TComponent::bindProperty()
Sets up the binding between a property and an expression.
TComponent::canGetProperty()
Determines whether a property can be read.
TComponent::canSetProperty()
Determines whether a property can be written.
TComponent::createComponent()
Creates a child component.
TComponent::dataBind()
Performs the databinding for this component.
TComponent::evaluateExpression()
Evaluates a PHP expression.
TComponent::evaluateStatements()
Evaluates a list of PHP statements.
TComponent::findObject()
Finds an object by its ID path.
TComponent::getApplication()
TComponent::getChild()
TComponent::getChildren()
TComponent::getDefinition()
Returns or builds a component definition.
TComponent::getGlobalization()
Returns the Globalization instance for the application.
TComponent::getID()
TComponent::getModule()
Returns the module object that contains the component or the page containing the component.
TComponent::getPage()
TComponent::getParent()
TComponent::getPropertyInitValue()
Gets the initial value of a property.
TComponent::getPropertyType()
Returns the type of a property
TComponent::getRequest()
Returns the request object associated with application.
TComponent::getServiceManager()
Returns the service manager for this application.
TComponent::getSession()
Returns the session object associated with the application.
TComponent::getSessionState()
Returns a session variable.
TComponent::getUniqueID()
Returns the unique ID of the component.
TComponent::getUser()
Returns the user object associated with the application.
TComponent::hasChildren()
TComponent::hasEvent()
Determines whether an event is defined.
TComponent::hasProperty()
Determines whether a property is defined.
TComponent::initProperties()
Initializes the property values.
TComponent::instantiateTemplate()
Parses a template string and instantiates the content.
TComponent::onDataBinding()
This method is invoked when dataBind is invoked for the component.
TComponent::raiseEvent()
Invokes all attached event handler functions for a particular event.
TComponent::removeChild()
Removes a child component.
TComponent::removeChildren()
Removes all child components.
TComponent::setAttribute()
Sets an attribute.
TComponent::setDefinition()
Sets a component definition.
TComponent::setID()
Sets a component ID.
TComponent::setParent()
Sets the parent of this component.
TComponent::setPropertyInitValue()
Sets the initial value of a property.
TComponent::setRoot()
Sets the root component in the component hierarchy.
TComponent::setSessionState()
Sets a session variable.
TComponent::unbindProperty()
Breaks the binding between a property and an expression.
TComponent::__get()
Returns a property value by name or a child component by ID.
TComponent::__set()
Sets value of a component property.

Class Methods


constructor __construct [line 47]

TDropDownList __construct( )



access:  public


Overrides TListControl::__construct() (Set the items list to be empty.)

[ Top ]

method getAttributesToRender [line 75]

ArrayObject getAttributesToRender( )

Returns the attributes to be rendered.

This method overrides the parent's implementation to default to adding a [] to the name




return:  attributes to be rendered
access:  protected


Overrides TWebControl::getAttributesToRender() (This overrides the parent implementation by rendering more TWebControl-specific attributes.)

[ Top ]

method renderBody [line 88]

string renderBody( )

Renders the list as an HTML select element.



return:  the rendering result
access:  protected


Overrides TControl::renderBody() (Renders the body content.)

[ Top ]

method saveViewState [line 60]

array|null saveViewState( )

Returns the viewstate of this control and its children.

This makes sure there is a selectedItem for a dropdownlist. If there is no selected item, the initial one is set as the selected.




return:  viewstate to be saved
access:  public


Overrides TListControl::saveViewState() (Returns the viewstate of this control and its children.)

[ Top ]


© 2004-2005 PRADO Software Group. All Rights Reserved.