Class: TTable

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

Class Overview

TComponent
   |
   --TControl
      |
      --TWebControl
         |
         --TTable

TTable class

Class Details

[line 81]
TTable class

A TTable control represents an HTML table on a page.

A TTable maintains a list of TTableRow controls, each of which contains a list of TTableCell controls.

There are two ways to construct a table. The first way uses template by the following syntax,

   <com:TTable>
     <com:TTableRow>
       <com:TTableHeaderCell Text="test" />
       <com:TTableCell> <com:TTextBox ID="search" /></com:TTableCell>
     </com:TTableRow>
     <com:TTableRow>
       <com:TTableCell Text="foot" />
       <com:TTableCell Text="again" />
     </com:TTableRow>
   <com:TTable>

Note, table is the parent of rows which are parents of cells. And cells are parents of the content contained within them.

The second way constructs a table in code dynamically, e.g.,

   $table=new TTable;
   $row=new TTableRow;
   $cell=new TTableCell; $cell->Text="test"; $row->Cells->add($cell);
   $cell=new TTableCell; $cell->Text="test1"; $row->Cells->add($cell);
   $cell=new TTableCell; $cell->Text="test2"; $row->Cells->add($cell);
   $table->Rows->add($row);

Note, TTable will not keep viewstate of its rows and cells.

Namespace: System.Web.UI.WebControls

Properties

HorizontalAlign, string (Right, Center, Left, Justify, NotSet), default=NotSet, kept in viewstate
Gets or sets the horizontal alignment of the table on page.
CellPadding, integer, default=-1, kept in viewstate
Gets or sets the cellpadding for the table
CellSpacing, integer, default=-1, kept in viewstate
Gets or sets the amount of space between table cells.
GridLines, string (Both, Vertical, Horizontal, None), default=Both, kept in viewstate
Gets or sets a value specifying whether the border between the cells is displayed.
Rows, TCollection, read-only
Gets the list of rows in the table.
BackImageUrl, string, kept in viewstate
Gets or sets the URL of the background image to display behind the table control.

version:	v1.0, last update on 2004/08/13 21:44:52
author:	Qiang Xue <qiang.xue@gmail.com>

[ Top ]

Methods

Inherited Variables

Class: TComponent

TComponent::$children

Inherited Methods

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 87]

TTable __construct(
)

Constructor.

Initializes the tagname to 'table'.

access:

public

Overrides TControl::__construct() (Constructor.)

[ Top ]

method allowBody [line 99]

boolean allowBody(
mixed
$object)

Determines whether the control can add the object as a body.

Only TTableRow or its descendant can be added as body.

access:

public

Overrides TControl::allowBody() (Determines whether the control can add the object as a body.)

Parameters:

mixed

$object

the object to be added

[ Top ]

method getAttributesToRender [line 204]

ArrayObject getAttributesToRender(
)

Returns the attributes to be rendered.

return:	attributes to be rendered
access:	protected

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

[ Top ]

method getBackImageUrl [line 187]

string getBackImageUrl(
)

return:	the background image url for the table
access:	public

[ Top ]

method getCellPadding [line 170]

integer getCellPadding(
)

return:	the cellpadding for the table, -1 if not set.
access:	public

[ Top ]

method getCellSpacing [line 153]

integer getCellSpacing(
)

return:	the cellspacing for the table, -1 if not set.
access:	public

[ Top ]

method getGridLines [line 134]

string getGridLines(
)

return:	the value specifying whether the border between the cells is displayed.
access:	public

[ Top ]

method getHorizontalAlign [line 115]

string getHorizontalAlign(
)

return:	the horizontal alignment of the table on the page.
access:	public

[ Top ]

method getRows [line 107]

array getRows(
)

return:	list of TTableRow components
access:	public

[ Top ]

method renderBody [line 240]

string renderBody(
)

Renders the body content of this table.

return:	the rendering result
access:	protected

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

[ Top ]

method setBackImageUrl [line 195]

void setBackImageUrl(
boolean
$value)

access:

public

Parameters:

boolean

$value

the background image url for the table

[ Top ]

method setCellPadding [line 179]

void setCellPadding(
integer
$value)

Sets the cellpadding for the table.

access:

public

Parameters:

integer

$value

the cellpadding for the table, -1 if not set.

[ Top ]

method setCellSpacing [line 162]

void setCellSpacing(
integer
$value)

Sets the cellspacing for the table.

access:

public

Parameters:

integer

$value

the cellspacing for the table, -1 if not set.

[ Top ]

method setGridLines [line 143]

void setGridLines(
string
$value)

Sets the value specifying whether the border between the cells is displayed.

access:

public

Parameters:

string

$value

Acceptable values include None, Horizontal, Vertical, Both

[ Top ]

method setHorizontalAlign [line 124]

void setHorizontalAlign(
string
$value)

Sets the horizontal alignment of the table on the page

access:

public

Parameters:

string

$value

Acceptable values include Left, Justify, Center, Right, NotSet

[ Top ]