Class TActiveTableRow
TActiveTableRow class.
TActiveTableRow is the active counterpart to the original TTableRow control and displays a table row. The table cells in the row can be accessed via Cells. The horizontal and vertical alignments of the row are specified via HorizontalAlign and VerticalAlign properties, respectively. TActiveTableRow allows the contents of the table row to be changed during callback. When RowSelected property is set, selecting (clicking on) the row will perform a callback request causing OnRowSelected event to be fired. It will also respond to a bubbled onCellSelected event of a TActiveTableCell child control and fire a OnRowSelected event. TActiveTableRow allows the client-side row contents to be updated during a callback response by getting a new writer, invoking the render method and flushing the output, similar to a TActivePanel control. - function callback_request($sender, $param)
- {
- $this->active_row->render($param->getNewWriter());
- }
Please refer to the original documentation of the regular counterpart for usage.
| 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,
|
| Constructor Summary |
| public |
Creates a new callback control, sets the adapter to TActiveControlAdapter.
|
| Method Summary |
|
protected
void
|
Ensure that the ID attribute is rendered and registers the javascript code for initializing the active control if the event handler for the onRowSelected event is set.
|
|
boolean
|
This method overrides parent's implementation and raises the control's callback event. This will fire the onRowSelected event if an appropriate event handler is implemented.
|
|
TBaseActiveCallbackControl
|
|
|
protected
string
|
|
|
protected
array
|
Returns postback specifications for the table row.
|
|
integer
|
|
|
TTable
|
|
|
void
|
This method is invoked when a callback is requested. The method raises 'OnRowSelected' event to fire up the event handlers. If you override this method, be sure to call the parent implementation so that the event handler can be invoked.
|
|
void
|
|
|
void
|
Renders and replaces the row's content on the client-side. When render() is called before the OnPreRender event, such as when render() is called during a callback event handler, the rendering is defered until OnPreRender event is raised.
|
| Methods Inherited From TTableRow |
|
TTableRow::addParsedObject(), TTableRow::createControlCollection(), TTableRow::createStyle(), TTableRow::getCells(), TTableRow::getHorizontalAlign(), TTableRow::getTableSection(), TTableRow::getTagName(), TTableRow::getVerticalAlign(), TTableRow::renderContents(), TTableRow::setHorizontalAlign(), TTableRow::setTableSection(), TTableRow::setVerticalAlign()
|
| Methods Inherited From TWebControl |
|
TWebControl::addAttributesToRender(), TWebControl::clearStyle(), TWebControl::copyBaseAttributes(), TWebControl::createStyle(), TWebControl::getAccessKey(), TWebControl::getBackColor(), TWebControl::getBorderColor(), TWebControl::getBorderStyle(), TWebControl::getBorderWidth(), TWebControl::getCssClass(), TWebControl::getDisplay(), 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::setDisplay(), TWebControl::setForeColor(), TWebControl::setHeight(), TWebControl::setStyle(), TWebControl::setTabIndex(), TWebControl::setToolTip(), TWebControl::setWidth()
|
| Methods Inherited From TControl |
|
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()
|
| Methods 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()
|
| Constructor Details |
__construct
Creates a new callback control, sets the adapter to TActiveControlAdapter.
|
| Method Details |
addAttributesToRender
| protected void addAttributesToRender |
(THtmlWriter $writer ) |
Ensure that the ID attribute is rendered and registers the javascript code for initializing the active control if the event handler for the onRowSelected event is set.
| Input |
| THtmlWriter | $writer | the writer responsible for rendering |
| Output |
| Exception |
|
bubbleEvent
This method overrides parent's implementation and raises the control's callback event. This will fire the onRowSelected event if an appropriate event handler is implemented.
| Input |
| TControl | $sender | the sender of the event |
| TEventParameter | $param | event parameter |
| Output |
|
boolean
| whether the event bubbling should stop here. |
| Exception |
|
getActiveControl
|
getClientClassName
| protected string getClientClassName |
() |
| Output |
|
string
| corresponding javascript class name for this TActiveTableRow. |
| Exception |
|
getPostBackOptions
| protected array getPostBackOptions |
() |
Returns postback specifications for the table row.
This method is used by framework and control developers.
| Output |
|
array
| parameters about how the row defines its postback behavior. |
| Exception |
|
getRowIndex
| public integer getRowIndex |
() |
Returns the zero-based index of the TActiveTableRow within the TTableRowCollection of the parent TTable control. Raises a TConfigurationException if the row is no member of the row collection.
| Output |
|
integer
| the zero-based index of the row |
| Exception |
|
getTable
Returns the parent TTable control by looping through all parents until a TTable is found. Raises a TConfigurationException if no table control is found.
| Output |
|
TTable
| the parent table control |
| Exception |
|
onRowSelected
This method is invoked when a callback is requested. The method raises 'OnRowSelected' event to fire up the event handlers. If you override this method, be sure to call the parent implementation so that the event handler can be invoked.
|
raiseCallbackEvent
Raises the callback event. This method is required by ICallbackEventHandler interface. It will raise onRowSelected event with a TActiveTableRowEventParameter containing the zero-based index of the TActiveTableRow.
This method is mainly used by framework and control developers.
|
render
Renders and replaces the row's content on the client-side. When render() is called before the OnPreRender event, such as when render() is called during a callback event handler, the rendering is defered until OnPreRender event is raised.
|
|