|
Class TTable
TTable class
TTable displays an HTML table on a Web page.
A table may have setCaption Caption, whose alignment is specified via
setCaptionAlign CaptionAlign. The table cellpadding and cellspacing are
specified via setCellPadding CellPadding and setCellSpacing
CellSpacing properties, respectively. The setGridLines GridLines
specifies how the table should display its borders. The horizontal alignment of
the table content can be specified via setHorizontalAlign
HorizontalAlign, and setBackImageUrl BackImageUrl can assign a
background image to the table.
A TTable maintains a list of TTableRow controls in its getRows
Rows property. Each TTableRow represents an HTML table row.
To populate the table getRows Rows, you may either use control
template or dynamically create TTableRow in code. In template, do as
follows to create the table rows and cells,
<com:TTable>
<com:TTableRow>
<com:TTableCell Text="content" />
<com:TTableCell Text="content" />
</com:TTableRow>
<com:TTableRow>
<com:TTableCell Text="content" />
<com:TTableCell Text="content" />
</com:TTableRow>
</com:TTable>
The above can also be accomplished in code as follows,
$table=new TTable;
$row=new TTableRow;
$cell=new TTableCell; $cell->Text="content"; $row->Cells->add($cell);
$cell=new TTableCell; $cell->Text="content"; $row->Cells->add($cell);
$table->Rows->add($row);
$row=new TTableRow;
$cell=new TTableCell; $cell->Text="content"; $row->Cells->add($cell);
$cell=new TTableCell; $cell->Text="content"; $row->Cells->add($cell);
$table->Rows->add($row);
-
TComponent
-
TApplicationComponent
-
TControl
implements
IRenderable,
IBindable
-
TWebControl
implements
IStyleable
-
TTable
Methods summary
protected
string
|
#
getTagName( )
Returns
string tag name for the table
Overrides
|
public
|
#
addParsedObject( mixed $object )
Adds object parsed from template to the control. This method adds only TTableRow objects into the getRows Rows collection. All other objects
are ignored.
Adds object parsed from template to the control. This method adds only TTableRow objects into the getRows Rows collection. All other objects
are ignored.
Parameters
- $object
mixed object parsed from template
Overrides
|
protected
TTableStyle
|
#
createStyle( )
Creates a style object for the control. This method creates a TTableStyle to be used by the table.
Creates a style object for the control. This method creates a TTableStyle to be used by the table.
Returns
Overrides
|
protected
|
#
addAttributesToRender( THtmlWriter $writer )
Adds attributes to renderer.
Adds attributes to renderer.
Parameters
Overrides
|
protected
TTableRowCollection
|
#
createControlCollection( )
Creates a control collection object that is to be used to hold child
controls
Creates a control collection object that is to be used to hold child
controls
Returns
See
Overrides
|
public
TTableRowCollection
|
|
public
string
|
#
getCaption( )
Returns
string table caption
|
public
|
#
setCaption( string $value )
Parameters
- $value
string table caption
|
public
TTableCaptionAlign
|
|
public
|
|
public
integer
|
#
getCellSpacing( )
Returns
integer the cellspacing for the table. Defaults to -1, meaning not set.
|
public
|
#
setCellSpacing( integer $value )
Parameters
- $value
integer the cellspacing for the table. Defaults to -1, meaning not set.
|
public
integer
|
#
getCellPadding( )
Returns
integer the cellpadding for the table. Defaults to -1, meaning not set.
|
public
|
#
setCellPadding( integer $value )
Parameters
- $value
integer the cellpadding for the table. Defaults to -1, meaning not set.
|
public
THorizontalAlign
|
#
getHorizontalAlign( )
Returns
THorizontalAlign
the horizontal alignment of the table content. Defaults to
THorizontalAlign::NotSet.
|
public
|
|
public
TTableGridLines
|
#
getGridLines( )
Returns
TTableGridLines
the grid line setting of the table. Defaults to TTableGridLines::None.
|
public
|
|
public
string
|
#
getBackImageUrl( )
Returns
string the URL of the background image for the table
|
public
|
#
setBackImageUrl( string $value )
Sets the URL of the background image for the table
Sets the URL of the background image for the table
Parameters
|
public
|
#
renderBeginTag( THtmlWriter $writer )
Renders the openning tag for the table control which will render table
caption if present.
Renders the openning tag for the table control which will render table
caption if present.
Parameters
- $writer
THtmlWriter
the writer used for the rendering purpose
Overrides
|
public
|
#
renderContents( THtmlWriter $writer )
Renders body contents of the table.
Renders body contents of the table.
Parameters
- $writer
THtmlWriter
the writer used for the rendering purpose.
Overrides
|
Methods inherited from TWebControl
clearStyle(),
copyBaseAttributes(),
getAccessKey(),
getBackColor(),
getBorderColor(),
getBorderStyle(),
getBorderWidth(),
getCssClass(),
getDecorator(),
getDisplay(),
getEnsureId(),
getFont(),
getForeColor(),
getHasStyle(),
getHeight(),
getStyle(),
getTabIndex(),
getToolTip(),
getWidth(),
onPreRender(),
render(),
renderEndTag(),
setAccessKey(),
setBackColor(),
setBorderColor(),
setBorderStyle(),
setBorderWidth(),
setCssClass(),
setDisplay(),
setEnsureId(),
setForeColor(),
setHeight(),
setStyle(),
setTabIndex(),
setToolTip(),
setWidth()
|
Methods inherited from TControl
__construct(),
__get(),
addToPostDataLoader(),
addedControl(),
applyStyleSheetSkin(),
autoBindProperty(),
autoDataBindProperties(),
bindProperty(),
broadcastEvent(),
bubbleEvent(),
clearChildState(),
clearControlState(),
clearNamingContainer(),
clearViewState(),
convertUniqueIdToClientId(),
createChildControls(),
dataBind(),
dataBindChildren(),
dataBindProperties(),
ensureChildControls(),
findControl(),
findControlsByID(),
findControlsByType(),
focus(),
getAdapter(),
getAllowChildControls(),
getAttribute(),
getAttributes(),
getChildControlsCreated(),
getClientID(),
getControlStage(),
getControlState(),
getControls(),
getCustomData(),
getEnableTheming(),
getEnableViewState(),
getEnabled(),
getHasAdapter(),
getHasAttributes(),
getHasChildInitialized(),
getHasControls(),
getHasInitialized(),
getHasLoaded(),
getHasLoadedPostData(),
getHasPreRendered(),
getID(),
getIsSkinApplied(),
getNamingContainer(),
getPage(),
getParent(),
getRegisteredObject(),
getSkinID(),
getSourceTemplateControl(),
getTemplateControl(),
getUniqueID(),
getViewState(),
getVisible(),
hasAttribute(),
initRecursive(),
isDescendentOf(),
isObjectRegistered(),
loadRecursive(),
loadState(),
loadStateRecursive(),
onDataBinding(),
onInit(),
onLoad(),
onUnload(),
preRenderRecursive(),
raiseBubbleEvent(),
registerObject(),
removeAttribute(),
removedControl(),
renderChildren(),
renderControl(),
saveState(),
saveStateRecursive(),
setAdapter(),
setAttribute(),
setChildControlsCreated(),
setControlStage(),
setControlState(),
setCustomData(),
setEnableTheming(),
setEnableViewState(),
setEnabled(),
setID(),
setPage(),
setSkinID(),
setTemplateControl(),
setViewState(),
setVisible(),
trackViewState(),
traverseChildControls(),
unbindProperty(),
unloadRecursive(),
unregisterObject()
|
Methods inherited from TComponent
__call(),
__destruct(),
__isset(),
__set(),
__sleep(),
__unset(),
__wakeup(),
asa(),
attachBehavior(),
attachBehaviors(),
attachClassBehavior(),
attachEventHandler(),
canGetProperty(),
canSetProperty(),
clearBehaviors(),
createdOnTemplate(),
detachBehavior(),
detachBehaviors(),
detachClassBehavior(),
detachEventHandler(),
disableBehavior(),
disableBehaviors(),
enableBehavior(),
enableBehaviors(),
evaluateExpression(),
evaluateStatements(),
fxAttachClassBehavior(),
fxDetachClassBehavior(),
getAutoGlobalListen(),
getBehaviorsEnabled(),
getClassHierarchy(),
getEventHandlers(),
getListeningToGlobalEvents(),
getSubProperty(),
hasEvent(),
hasEventHandler(),
hasProperty(),
isa(),
listen(),
raiseEvent(),
setSubProperty(),
unlisten()
|
Constants inherited from TControl
AUTOMATIC_ID_PREFIX,
CLIENT_ID_SEPARATOR,
CS_CHILD_INITIALIZED,
CS_CONSTRUCTED,
CS_INITIALIZED,
CS_LOADED,
CS_PRERENDERED,
CS_STATE_LOADED,
ID_FORMAT,
ID_SEPARATOR,
IS_CHILD_CREATED,
IS_CREATING_CHILD,
IS_DISABLE_THEMING,
IS_DISABLE_VIEWSTATE,
IS_ID_SET,
IS_SKIN_APPLIED,
IS_STYLESHEET_APPLIED,
RF_ADAPTER,
RF_AUTO_BINDINGS,
RF_CHILD_STATE,
RF_CONTROLS,
RF_CONTROLSTATE,
RF_DATA_BINDINGS,
RF_EVENTS,
RF_NAMED_CONTROLS,
RF_NAMED_CONTROLS_ID,
RF_NAMED_OBJECTS,
RF_SKIN_ID
|
|