Class TPanel

Description

TPanel class

TPanel represents a component that acts as a container for other component. It is especially useful when you want to generate components programmatically or hide/show a group of components.

By default, TPanel displays a <div> element on a page. Children of TPanel are displayed as the body content of the element. The property Wrap can be used to set whether the body content should wrap or not. HorizontalAlign governs how the content is aligned horizontally, and Direction indicates the content direction (left to right or right to left). You can set BackImageUrl to give a background image to the panel, and you can ste GroupingText so that the panel is displayed as a field set with a legend text. Finally, you can specify a default button to be fired when users press 'return' key within the panel by setting the DefaultButton property.

Located in /Web/UI/WebControls/TPanel.php (line 37)

TComponent
   |
   --TApplicationComponent
      |
      --TControl
         |
         --TWebControl
            |
            --TPanel
Direct descendents
Class Description
TDataGridPager TDataGridPager class.
Method Summary
void createStyle ()
string getBackImageUrl ()
string getDefaultButton ()
string getDirection ()
string getGroupingText ()
string getHorizontalAlign ()
string getScrollBars ()
string getTagName ()
boolean getWrap ()
void renderBeginTag (THtmlWriter $writer)
void renderEndTag (THtmlWriter $writer)
void setBackImageUrl (string $value)
void setDefaultButton (string $value)
void setDirection (string $value)
void setGroupingText (string $value)
void setHorizontalAlign (string $value)
void setScrollBars (string $value)
void setWrap (boolean $value)
Methods
addAttributesToRender (line 66)

Adds attributes to renderer.

  • access: protected
  • throws: TInvalidDataValueException if default button is not right.
void addAttributesToRender (THtmlWriter $writer)

Redefinition of:
TWebControl::addAttributesToRender()
Adds attribute name-value pairs to renderer.
createStyle (line 56)

Creates a style object to be used by the control.

This method overrides the parent impementation by creating a TPanelStyle object.

  • access: protected
void createStyle ()

Redefinition of:
TWebControl::createStyle()
Creates a style object to be used by the control.
getBackImageUrl (line 119)
  • return: the URL of the background image for the panel component.
  • access: public
string getBackImageUrl ()
getDefaultButton (line 153)
  • return: the ID path to the default button. Defaults to empty.
  • access: public
string getDefaultButton ()
getDirection (line 136)
  • return: alignment of the content in the panel. Defaults to 'NotSet'.
  • access: public
string getDirection ()
getGroupingText (line 173)
  • return: the legend text when the panel is used as a fieldset. Defaults to empty.
  • access: public
string getGroupingText ()
getHorizontalAlign (line 101)
  • return: the horizontal alignment of the contents within the panel, defaults to 'NotSet'.
  • access: public
string getHorizontalAlign ()
getScrollBars (line 189)
  • return: the visibility and position of scroll bars in a panel control, defaults to None.
  • access: public
string getScrollBars ()
getTagName (line 47)
  • return: tag name of the panel
  • access: protected
string getTagName ()

Redefinition of:
TWebControl::getTagName()
Returns the tag name used for this control.
getWrap (line 84)
  • return: whether the content wraps within the panel. Defaults to true.
  • access: public
boolean getWrap ()
renderBeginTag (line 207)

Renders the openning tag for the control (including attributes)

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

Redefinition of:
TWebControl::renderBeginTag()
Renders the openning tag for the control (including attributes)
renderEndTag (line 223)

Renders the closing tag for the control

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

Redefinition of:
TWebControl::renderEndTag()
Renders the closing tag for the control
setBackImageUrl (line 128)

Sets the URL of the background image for the panel component.

  • access: public
void setBackImageUrl (string $value)
  • string $value: the URL
setDefaultButton (line 165)

Specifies the default button for the panel.

The default button will be fired (clicked) whenever a user enters 'return' key within the panel. The button must be locatable via the function call TControl::findControl.

  • access: public
void setDefaultButton (string $value)
  • string $value: the ID path to the default button.
setDirection (line 145)
  • access: public
void setDirection (string $value)
  • string $value: alignment of the content in the panel. Valid values include 'NotSet', 'LeftToRight', 'RightToLeft'.
setGroupingText (line 181)
  • access: public
void setGroupingText (string $value)
  • string $value: the legend text. If this value is not empty, the panel will be rendered as a fieldset.
setHorizontalAlign (line 111)

Sets the horizontal alignment of the contents within the panel.

Valid values include 'NotSet', 'Justify', 'Left', 'Right', 'Center'

  • access: public
void setHorizontalAlign (string $value)
  • string $value: the horizontal alignment
setScrollBars (line 198)
  • access: public
void setScrollBars (string $value)
  • string $value: the visibility and position of scroll bars in a panel control. Valid values include None, Auto, Both, Horizontal and Vertical.
setWrap (line 93)

Sets the value indicating whether the content wraps within the panel.

  • access: public
void setWrap (boolean $value)
  • boolean $value: whether the content wraps within the panel.

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::applyStyleSheetSkin()
TControl::autoBindProperty()
TControl::autoDataBindProperties()
TControl::bindProperty()
TControl::broadcastEvent()
TControl::broadcastEventInternal()
TControl::bubbleEvent()
TControl::clearChildState()
TControl::clearControlState()
TControl::clearNamingContainer()
TControl::clearViewState()
TControl::createChildControls()
TControl::createControlCollection()
TControl::createdOnTemplate()
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::getEnabled()
TControl::getEnableTheming()
TControl::getEnableViewState()
TControl::getHasAdapter()
TControl::getHasAttributes()
TControl::getHasControls()
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::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::attachEventHandler()
TComponent::canGetProperty()
TComponent::canSetProperty()
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

Inherited Constants

Inherited from TControl

Documentation generated on Sun, 04 Jun 2006 19:00:03 -0400 by phpDocumentor 1.3.0RC4