Class TDataListItemRenderer

Description

Implements interfaces:

TDataListItemRenderer class

TDataListItemRenderer can be used as a convenient base class to define an item renderer class for TDataList.

Because TDataListItemRenderer extends from TTemplateControl, derived child classes can have templates to define their presentational layout.

TDataListItemRenderer implements IItemDataRenderer interface, which enables the following properties that are related with data-bound controls:

  • ItemIndex: zero-based index of this control in the datalist item collection.
  • ItemType: item type of this control, such as TListItemType::AlternatingItem
  • Data: data associated with this control

  • since: 3.1.0
  • version: $Id: TDataListItemRenderer.php 1672 2007-02-05 02:24:34Z xue $
  • author: Qiang Xue <qiang.xue@gmail.com>

Located in /Web/UI/WebControls/TDataListItemRenderer.php (line 35)

TComponent
   |
   --TApplicationComponent
      |
      --TControl
         |
         --TCompositeControl
            |
            --TTemplateControl
               |
               --TDataListItemRenderer
Method Summary
boolean bubbleEvent (TControl $sender, TEventParameter $param)
void clearStyle ()
mixed getData ()
boolean getHasStyle ()
integer getItemIndex ()
string getTagName ()
void render (THtmlWriter $writer)
void renderBeginTag (THtmlWriter $writer)
void renderContents (THtmlWriter $writer)
void renderEndTag (THtmlWriter $writer)
void setData (mixed $value)
void setItemIndex (integer $value)
void setItemType (TListItemType $value)
Methods
addAttributesToRender (line 180)

Adds attribute name-value pairs to renderer.

By default, this method renders the style string. The method can be overriden to provide customized attribute rendering.

  • access: protected
void addAttributesToRender (THtmlWriter $writer)
  • THtmlWriter $writer: the writer used for the rendering purpose
bubbleEvent (line 151)

This method overrides parent's implementation by wrapping event parameter for OnCommand event with item information.

  • return: whether the event bubbling should stop here.
  • access: public
boolean bubbleEvent (TControl $sender, TEventParameter $param)

Redefinition of:
TControl::bubbleEvent()
This method responds to a bubbled event.
clearStyle (line 89)

Removes all style data.

  • access: public
void clearStyle ()
createStyle (line 58)

Creates a style object to be used by the control.

This method may be overriden by controls to provide customized style.

  • access: protected
TStyle createStyle ()
getData (line 131)
  • return: data associated with the item
  • access: public
mixed getData ()
getHasStyle (line 66)
  • return: whether the control has defined any style information
  • access: public
boolean getHasStyle ()
getItemIndex (line 113)
  • return: zero-based index of the item in the item collection of datalist
  • access: public
integer getItemIndex ()
getItemType (line 97)
  • return: item type
  • access: public
TListItemType getItemType ()
getStyle (line 74)
  • return: the object representing the css style of the control
  • access: public
TStyle getStyle ()
getTagName (line 169)

Returns the tag name used for this control.

By default, the tag name is 'span'. You can override this method to provide customized tag names. If the tag name is empty, the opening and closing tag will NOT be rendered.

  • return: tag name of the control to be rendered
  • access: protected
string getTagName ()
render (line 196)

Renders the control.

This method overrides the parent implementation by replacing it with the following sequence:

If the TagName is empty, only renderContents is invoked.

  • access: public
void render (THtmlWriter $writer)
  • THtmlWriter $writer: the writer used for the rendering purpose

Redefinition of:
TControl::render()
Renders the control.
renderBeginTag (line 213)

Renders the openning tag for the control (including attributes) This method is invoked when getTagName is not empty.

  • access: public
void renderBeginTag (THtmlWriter $writer)
  • THtmlWriter $writer: the writer used for the rendering purpose
renderContents (line 225)

Renders the body content enclosed between the control tag.

By default, child controls and text strings will be rendered. You can override this method to provide customized content rendering.

  • access: public
void renderContents (THtmlWriter $writer)
  • THtmlWriter $writer: the writer used for the rendering purpose
renderEndTag (line 235)

Renders the closing tag for the control This method is invoked when getTagName is not empty.

  • access: public
void renderEndTag (THtmlWriter $writer)
  • THtmlWriter $writer: the writer used for the rendering purpose
setData (line 139)
  • access: public
void setData (mixed $value)
  • mixed $value: data to be associated with the item
setItemIndex (line 123)

Sets the zero-based index for the item.

If the item is not in the item collection (e.g. it is a header item), -1 should be used.

  • access: public
void setItemIndex (integer $value)
  • integer $value: zero-based index of the item.
setItemType (line 105)
  • access: public
void setItemType (TListItemType $value)

Inherited Methods

Inherited From TTemplateControl

TTemplateControl::createChildControls()
TTemplateControl::getIsSourceTemplateControl()
TTemplateControl::getMaster()
TTemplateControl::getMasterClass()
TTemplateControl::getTemplate()
TTemplateControl::getTemplateDirectory()
TTemplateControl::initRecursive()
TTemplateControl::injectContent()
TTemplateControl::loadTemplate()
TTemplateControl::registerContent()
TTemplateControl::registerContentPlaceHolder()
TTemplateControl::setMasterClass()
TTemplateControl::setTemplate()

Inherited From TCompositeControl

TCompositeControl::initRecursive()

Inherited From TControl

TControl::__construct()
TControl::addedControl()
TControl::addParsedObject()
TControl::addToPostDataLoader()
TControl::applyStyleSheetSkin()
TControl::autoBindProperty()
TControl::autoDataBindProperties()
TControl::bindProperty()
TControl::broadcastEvent()
TControl::bubbleEvent()
TControl::clearChildState()
TControl::clearControlState()
TControl::clearNamingContainer()
TControl::clearViewState()
TControl::convertUniqueIdToClientId()
TControl::createChildControls()
TControl::createControlCollection()
TControl::dataBind()
TControl::dataBindChildren()
TControl::dataBindProperties()
TControl::ensureChildControls()
TControl::findControl()
TControl::findControlsByID()
TControl::findControlsByType()
TControl::focus()
TControl::getAdapter()
TControl::getAllowChildControls()
TControl::getAttribute()
TControl::getAttributes()
TControl::getChildControlsCreated()
TControl::getClientID()
TControl::getControls()
TControl::getControlStage()
TControl::getControlState()
TControl::getCustomData()
TControl::getEnabled()
TControl::getEnableTheming()
TControl::getEnableViewState()
TControl::getHasAdapter()
TControl::getHasAttributes()
TControl::getHasChildInitialized()
TControl::getHasControls()
TControl::getHasInitialized()
TControl::getHasLoaded()
TControl::getHasLoadedPostData()
TControl::getHasPreRendered()
TControl::getID()
TControl::getNamingContainer()
TControl::getPage()
TControl::getParent()
TControl::getRegisteredObject()
TControl::getSkinID()
TControl::getSourceTemplateControl()
TControl::getTemplateControl()
TControl::getUniqueID()
TControl::getViewState()
TControl::getVisible()
TControl::hasAttribute()
TControl::initRecursive()
TControl::isDescendentOf()
TControl::isObjectRegistered()
TControl::loadRecursive()
TControl::loadState()
TControl::loadStateRecursive()
TControl::onDataBinding()
TControl::onInit()
TControl::onLoad()
TControl::onPreRender()
TControl::onUnload()
TControl::preRenderRecursive()
TControl::raiseBubbleEvent()
TControl::registerObject()
TControl::removeAttribute()
TControl::removedControl()
TControl::render()
TControl::renderChildren()
TControl::renderControl()
TControl::saveState()
TControl::saveStateRecursive()
TControl::setAdapter()
TControl::setAttribute()
TControl::setChildControlsCreated()
TControl::setControlStage()
TControl::setControlState()
TControl::setCustomData()
TControl::setEnabled()
TControl::setEnableTheming()
TControl::setEnableViewState()
TControl::setID()
TControl::setPage()
TControl::setSkinID()
TControl::setTemplateControl()
TControl::setViewState()
TControl::setVisible()
TControl::trackViewState()
TControl::traverseChildControls()
TControl::unbindProperty()
TControl::unloadRecursive()
TControl::unregisterObject()
TControl::__get()

Inherited From TApplicationComponent

TApplicationComponent::getApplication()
TApplicationComponent::getRequest()
TApplicationComponent::getResponse()
TApplicationComponent::getService()
TApplicationComponent::getSession()
TApplicationComponent::getUser()
TApplicationComponent::publishAsset()
TApplicationComponent::publishFilePath()

Inherited From TComponent

TComponent::addParsedObject()
TComponent::attachEventHandler()
TComponent::canGetProperty()
TComponent::canSetProperty()
TComponent::createdOnTemplate()
TComponent::detachEventHandler()
TComponent::evaluateExpression()
TComponent::evaluateStatements()
TComponent::getEventHandlers()
TComponent::getSubProperty()
TComponent::hasEvent()
TComponent::hasEventHandler()
TComponent::hasProperty()
TComponent::raiseEvent()
TComponent::setSubProperty()
TComponent::__get()
TComponent::__set()
Class Constants

Documentation generated on Sun, 30 Sep 2007 19:15:45 -0400 by phpDocumentor 1.3.0RC4