Class TPager

Description
Description | Methods (details) Constants (details)

Implements interfaces:

TPager class.

TPager creates a pager that provides UI for end-users to interactively specify which page of data to be rendered in a TDataBoundControl-derived control, such as TDataList, TRepeater, TCheckBoxList, etc. The target data-bound control is specified by ControlToPaginate, which must be the ID path of the target control reaching from the pager's naming container. Note, the target control must have its TDataBoundControl::setAllowPaging set to true.

TPager can display three different UIs, specified via Mode:

  • NextPrev: a next page and a previous page button are rendered.
  • Numeric: a list of page index buttons are rendered.
  • List: a dropdown list of page indices are rendered.
TPager raises an OnPageIndexChanged event when the end-user interacts with it and specifies a new page (e.g. clicking on a page button that leads to a new page.) The new page index may be obtained from the event parameter's property TPagerPageChangedEventParameter::getNewPageIndex. Normally, in the event handler, one can set the TDataBoundControl::getCurrentPageIndex to this new page index so that the new page of data is rendered.

Multiple pagers can be associated with the same data-bound control.

  • since: 3.0.2
  • version: $Id: TPager.php 1522 2006-11-27 03:28:24Z xue $
  • author: Qiang Xue <qiang.xue@gmail.com>

Located in /Web/UI/WebControls/TPager.php (line 43) 

TComponent
   |
   --TApplicationComponent
      |
      --TControl
         |
         --TWebControl
            |
            --TPager
Class Constant Summary
Description | Constants (details) | Methods (details)
CMD_PAGE = 'Page'
CMD_PAGE_FIRST = 'First'
CMD_PAGE_LAST = 'Last'
CMD_PAGE_NEXT = 'Next'
CMD_PAGE_PREV = 'Previous'
Method Summary
Description | Constants (details) Methods (details)
boolean bubbleEvent (TControl $sender, TEventParameter $param)
void buildListPager ()
void buildNextPrevPager ()
void buildNumericPager ()
void buildPager ()
mixed createPagerButton (string $buttonType, boolean $enabled, string $text, string $commandName, string $commandParameter)
TPagerButtonType getButtonType ()
string getControlToPaginate ()
integer getCurrentPageIndex ()
string getFirstPageText ()
boolean getIsFirstPage ()
boolean getIsLastPage ()
string getLastPageText ()
TPagerMode getMode ()
string getNextPageText ()
integer getPageButtonCount ()
integer getPageCount ()
string getPrevPageText ()
void listIndexChanged (TDropDownList $sender, TEventParameter $param)
void loadState ()
void onPageIndexChanged (TPagerPageChangedEventParameter $param)
void onPreRender (Traversable $param)
void render (THtmlWriter $writer)
void setButtonType (TPagerButtonType $value)
void setControlToPaginate (string $value)
void setCurrentPageIndex (integer $value)
void setFirstPageText (string $value)
void setLastPageText (string $value)
void setMode (TPagerMode $value)
void setNextPageText (string $value)
void setPageButtonCount (integer $value)
void setPageCount (integer $value)
void setPrevPageText (string $value)
Methods
Description | Constants (details) Methods (details)
bubbleEvent (line 523)

Processes a bubbled event.

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.
buildListPager (line 483)

Builds a dropdown list pager

  • access: protected
void buildListPager ()
buildNextPrevPager (line 359)

Builds a next-prev pager

  • access: protected
void buildNextPrevPager ()
buildNumericPager (line 413)

Builds a numeric pager

  • access: protected
void buildNumericPager ()
buildPager (line 302)

Builds the pager content based on the pager mode.

Current implementation includes building 'NextPrev', 'Numeric' and 'DropDownList' pagers. Derived classes may override this method to provide additional pagers.

  • access: protected
void buildPager ()
createPagerButton (line 330)

Creates a pager button.

Depending on the button type, a TLinkButton or a TButton may be created. If it is enabled (clickable), its command name and parameter will also be set. Derived classes may override this method to create additional types of buttons, such as TImageButton.

  • return: the button instance
  • access: protected
mixed createPagerButton (string $buttonType, boolean $enabled, string $text, string $commandName, string $commandParameter)
  • string $buttonType: button type, either LinkButton or PushButton
  • boolean $enabled: whether the button should be enabled
  • string $text: caption of the button
  • string $commandName: CommandName corresponding to the OnCommand event of the button
  • string $commandParameter: CommandParameter corresponding to the OnCommand event of the button
getButtonType (line 109)
  • return: the type of command button for paging. Defaults to TPagerButtonType::LinkButton.
  • access: public
TPagerButtonType getButtonType ()
getControlToPaginate (line 74)
  • return: the ID path of the control whose content would be paginated.
  • access: public
string getControlToPaginate ()
getCurrentPageIndex (line 208)
  • return: the zero-based index of the current page. Defaults to 0.
  • access: public
integer getCurrentPageIndex ()
getFirstPageText (line 157)
  • return: text for the first page button. Defaults to ''.
  • access: public
string getFirstPageText ()
getIsFirstPage (line 246)
  • return: whether the current page is the first page Defaults to false.
  • access: public
boolean getIsFirstPage ()
getIsLastPage (line 254)
  • return: whether the current page is the last page
  • access: public
boolean getIsLastPage ()
getLastPageText (line 173)
  • return: text for the last page button. Defaults to '>>'.
  • access: public
string getLastPageText ()
getMode (line 93)
  • return: pager mode. Defaults to TPagerMode::NextPrev.
  • access: public
TPagerMode getMode ()
getNextPageText (line 125)
  • return: text for the next page button. Defaults to '>'.
  • access: public
string getNextPageText ()
getPageButtonCount (line 189)
  • return: maximum number of pager buttons to be displayed. Defaults to 10.
  • access: public
integer getPageButtonCount ()
getPageCount (line 227)
  • return: number of pages of data items available
  • access: public
integer getPageCount ()
getPrevPageText (line 141)
  • return: text for the previous page button. Defaults to '<'.
  • access: public
string getPrevPageText ()
listIndexChanged (line 500)

Event handler to the OnSelectedIndexChanged event of the dropdown list.

This handler will raise OnPageIndexChanged event.

  • access: public
void listIndexChanged (TDropDownList $sender, TEventParameter $param)
loadState (line 61)

Restores the pager state.

This method overrides the parent implementation and is invoked when the control is loading persistent state.

  • access: public
void loadState ()
Redefinition of:
TControl::loadState()
This method is invoked right after the control has loaded its state.
onPageIndexChanged (line 510)

This event is raised when page index is changed due to a page button click.

  • access: public
void onPageIndexChanged (TPagerPageChangedEventParameter $param)
onPreRender (line 265)

Performs databinding to populate data items from data source.

This method is invoked by dataBind(). You may override this function to provide your own way of data population.

  • access: public
void onPreRender (Traversable $param)
  • Traversable $param: the bound data
Redefinition of:
TControl::onPreRender()
This method is invoked when the control enters 'OnPreRender' stage.
render (line 291)

Renders the control.

The method overrides the parent implementation by rendering the pager only when there are two or more pages.

  • access: public
void render (THtmlWriter $writer)
Redefinition of:
TWebControl::render()
Renders the control.
setButtonType (line 117)
  • access: public
void setButtonType (TPagerButtonType $value)
setControlToPaginate (line 85)

Sets the ID path of the control whose content would be paginated.

The ID path is the dot-connected IDs of the controls reaching from the pager's naming container to the target control.

  • access: public
void setControlToPaginate (string $value)
  • string $value: the ID path
setCurrentPageIndex (line 217)
  • access: protected
  • throws: TInvalidDataValueException if the value is less than 0
void setCurrentPageIndex (integer $value)
  • integer $value: the zero-based index of the current page
setFirstPageText (line 165)
  • access: public
void setFirstPageText (string $value)
  • string $value: text for the first page button. If empty, the first page button will not be rendered.
setLastPageText (line 181)
  • access: public
void setLastPageText (string $value)
  • string $value: text for the last page button. If empty, the last page button will not be rendered.
setMode (line 101)
  • access: public
void setMode (TPagerMode $value)
setNextPageText (line 133)
  • access: public
void setNextPageText (string $value)
  • string $value: text for the next page button.
setPageButtonCount (line 198)
  • access: public
  • throws: TInvalidDataValueException if the value is less than 1.
void setPageButtonCount (integer $value)
  • integer $value: maximum number of pager buttons to be displayed
setPageCount (line 236)
  • access: protected
  • throws: TInvalidDataValueException if the value is less than 0
void setPageCount (integer $value)
  • integer $value: number of pages of data items available
setPrevPageText (line 149)
  • access: public
void setPrevPageText (string $value)
  • string $value: text for the next page button.

Inherited Methods

Inherited From TWebControl

TWebControl::addAttributesToRender()
TWebControl::copyBaseAttributes()
TWebControl::createStyle()
TWebControl::getAccessKey()
TWebControl::getBackColor()
TWebControl::getBorderColor()
TWebControl::getBorderStyle()
TWebControl::getBorderWidth()
TWebControl::getCssClass()
TWebControl::getFont()
TWebControl::getForeColor()
TWebControl::getHasStyle()
TWebControl::getHeight()
TWebControl::getStyle()
TWebControl::getTabIndex()
TWebControl::getTagName()
TWebControl::getToolTip()
TWebControl::getWidth()
TWebControl::render()
TWebControl::renderBeginTag()
TWebControl::renderContents()
TWebControl::renderEndTag()
TWebControl::setAccessKey()
TWebControl::setBackColor()
TWebControl::setBorderColor()
TWebControl::setBorderStyle()
TWebControl::setBorderWidth()
TWebControl::setCssClass()
TWebControl::setForeColor()
TWebControl::setHeight()
TWebControl::setStyle()
TWebControl::setTabIndex()
TWebControl::setToolTip()
TWebControl::setWidth()

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::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::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
Description | Constants (details) | Methods (details)
CMD_PAGE = 'Page' (line 48)

Command name that TPager understands.

CMD_PAGE_FIRST = 'First' (line 51)
CMD_PAGE_LAST = 'Last' (line 52)
CMD_PAGE_NEXT = 'Next' (line 49)
CMD_PAGE_PREV = 'Previous' (line 50)

Inherited Constants

Inherited from TControl

TControl::AUTOMATIC_ID_PREFIX
 TControl::CLIENT_ID_SEPARATOR
 TControl::CS_CHILD_INITIALIZED
 TControl::CS_CONSTRUCTED
 TControl::CS_INITIALIZED
 TControl::CS_LOADED
 TControl::CS_PRERENDERED
 TControl::CS_STATE_LOADED
 TControl::ID_FORMAT
 TControl::ID_SEPARATOR
 TControl::IS_CHILD_CREATED
 TControl::IS_CREATING_CHILD
 TControl::IS_DISABLE_THEMING
 TControl::IS_DISABLE_VIEWSTATE
 TControl::IS_ID_SET
 TControl::IS_SKIN_APPLIED
 TControl::IS_STYLESHEET_APPLIED
 TControl::RF_ADAPTER
 TControl::RF_AUTO_BINDINGS
 TControl::RF_CHILD_STATE
 TControl::RF_CONTROLS
 TControl::RF_CONTROLSTATE
 TControl::RF_DATA_BINDINGS
 TControl::RF_EVENTS
 TControl::RF_NAMED_CONTROLS
 TControl::RF_NAMED_CONTROLS_ID
 TControl::RF_NAMED_OBJECTS
 TControl::RF_SKIN_ID

Documentation generated on Sun, 14 Jan 2007 21:43:45 -0500 by phpDocumentor 1.3.0RC4