Class TBulletedList
TBulletedList class
TBulletedList displays items in a bullet format. The bullet style is specified by BulletStyle. When the style is 'CustomImage', the setBackImageUrl specifies the image used as bullets. TBulletedList displays the item texts in three different modes, specified via DisplayMode. When the mode is Text, the item texts are displayed as static texts; When the mode is 'HyperLink', each item is displayed as a hyperlink whose URL is given by the item value, and the Target property can be used to specify the target browser window; When the mode is 'LinkButton', each item is displayed as a link button which posts back to the page if a user clicks on that and the event OnClick will be raised under such a circumstance.
| 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,
|
| Method Summary |
|
protected
void
|
Adds attribute name-value pairs to renderer.
|
|
protected
void
|
|
|
string
|
|
|
TBulletStyle
|
|
|
protected
string
|
Gets the name of the javascript class responsible for performing postback for this control.
|
|
TBulletedListDisplayMode
|
|
|
integer
|
|
|
protected
array
|
|
|
protected
string
|
|
|
string
|
|
|
void
|
Raises 'OnClick' event.
|
|
void
|
Raises the postback event.
|
|
void
|
Renders the control.
|
|
protected
void
|
Renders each item
|
|
void
|
Renders the body contents.
|
|
protected
void
|
|
|
protected
void
|
|
|
protected
void
|
|
|
void
|
|
|
void
|
|
|
void
|
|
|
TBulletedListDisplayMode
|
|
|
void
|
|
|
void
|
|
|
void
|
|
|
void
|
|
|
void
|
|
|
void
|
|
| Methods Inherited From TListControl |
|
TListControl::addAttributesToRender(), TListControl::addParsedObject(), TListControl::clearSelection(), TListControl::createListItemCollection(), TListControl::formatDataValue(), TListControl::getAppendDataBoundItems(), TListControl::getAutoPostBack(), TListControl::getCausesValidation(), TListControl::getClientClassName(), TListControl::getData(), TListControl::getDataGroupField(), TListControl::getDataTextField(), TListControl::getDataTextFormatString(), TListControl::getDataValueField(), TListControl::getEnableClientScript(), TListControl::getHasItems(), TListControl::getIsMultiSelect(), TListControl::getItemCount(), TListControl::getItems(), TListControl::getPostBackOptions(), TListControl::getPromptText(), TListControl::getPromptValue(), TListControl::getSelectedIndex(), TListControl::getSelectedIndices(), TListControl::getSelectedItem(), TListControl::getSelectedValue(), TListControl::getSelectedValues(), TListControl::getTagName(), TListControl::getText(), TListControl::getValidationGroup(), TListControl::loadState(), TListControl::onSelectedIndexChanged(), TListControl::onTextChanged(), TListControl::performDataBinding(), TListControl::renderClientControlScript(), TListControl::renderContents(), TListControl::renderPrompt(), TListControl::saveState(), TListControl::setAppendDataBoundItems(), TListControl::setAutoPostBack(), TListControl::setCausesValidation(), TListControl::setData(), TListControl::setDataGroupField(), TListControl::setDataTextField(), TListControl::setDataTextFormatString(), TListControl::setDataValueField(), TListControl::setEnableClientScript(), TListControl::setPromptText(), TListControl::setPromptValue(), TListControl::setSelectedIndex(), TListControl::setSelectedIndices(), TListControl::setSelectedValue(), TListControl::setSelectedValues(), TListControl::setText(), TListControl::setValidationGroup()
|
| Methods Inherited From TDataBoundControl |
|
TDataBoundControl::createPagedDataSource(), TDataBoundControl::dataBind(), TDataBoundControl::dataSourceViewChanged(), TDataBoundControl::determineDataSource(), TDataBoundControl::ensureDataBound(), TDataBoundControl::getAllowCustomPaging(), TDataBoundControl::getAllowPaging(), TDataBoundControl::getCurrentPageIndex(), TDataBoundControl::getDataMember(), TDataBoundControl::getDataSource(), TDataBoundControl::getDataSourceID(), TDataBoundControl::getDataSourceView(), TDataBoundControl::getInitialized(), TDataBoundControl::getIsDataBound(), TDataBoundControl::getPageCount(), TDataBoundControl::getPageSize(), TDataBoundControl::getRequiresDataBinding(), TDataBoundControl::getSelectParameters(), TDataBoundControl::getUsingDataSourceID(), TDataBoundControl::getVirtualItemCount(), TDataBoundControl::onDataBound(), TDataBoundControl::onDataSourceChanged(), TDataBoundControl::onInit(), TDataBoundControl::onPreRender(), TDataBoundControl::pagePreLoad(), TDataBoundControl::setAllowCustomPaging(), TDataBoundControl::setAllowPaging(), TDataBoundControl::setCurrentPageIndex(), TDataBoundControl::setDataMember(), TDataBoundControl::setDataSource(), TDataBoundControl::setDataSourceID(), TDataBoundControl::setInitialized(), TDataBoundControl::setIsDataBound(), TDataBoundControl::setPageSize(), TDataBoundControl::setRequiresDataBinding(), TDataBoundControl::setVirtualItemCount(), TDataBoundControl::validateDataSource()
|
| 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()
|
| Method Details |
addAttributesToRender
| protected void addAttributesToRender |
(THtmlWriter $writer ) |
Adds attribute name-value pairs to renderer.
This overrides the parent implementation with additional bulleted list specific attributes.
| Input |
| THtmlWriter | $writer | the writer used for the rendering purpose |
| Output |
| Exception |
|
canCauseValidation
| protected void canCauseValidation |
() |
|
getBulletImageUrl
| public string getBulletImageUrl |
() |
| Output |
|
string
| image URL used for bullets when BulletStyle is 'CustomImage'. |
| Exception |
|
getBulletStyle
| Output |
|
TBulletStyle
| style of bullets. Defaults to TBulletStyle::NotSet. |
| Exception |
|
getClientClassName
| protected string getClientClassName |
() |
Gets the name of the javascript class responsible for performing postback for this control.
This method overrides the parent implementation.
| Output |
|
string
| the javascript class name |
| Exception |
|
getDisplayMode
|
getFirstBulletNumber
| public integer getFirstBulletNumber |
() |
| Output |
|
integer
| starting index when BulletStyle is one of the following: 'Numbered', 'LowerAlpha', 'UpperAlpha', 'LowerRoman', 'UpperRoman'. Defaults to 1. |
| Exception |
|
getPostBackOptions
| protected array getPostBackOptions |
() |
| Output |
|
array
| postback options used for linkbuttons. |
| Exception |
|
getTagName
| protected string getTagName |
() |
| Output |
|
string
| tag name of the bulleted list |
| Exception |
|
getTarget
| public string getTarget |
() |
| Output |
|
string
| the target window or frame to display the Web page content linked to when DisplayMode is 'HyperLink' and one of the hyperlinks is clicked. |
| Exception |
|
onClick
Raises 'OnClick' event.
This method is invoked when the DisplayMode is 'LinkButton' and end-users click on one of the buttons.
|
raisePostBackEvent
Raises the postback event.
This method is required by IPostBackEventHandler interface. If CausesValidation is true, it will invoke the page's TPage::validate method first. It will raise OnClick events. This method is mainly used by framework and control developers.
|
render
Renders the control.
| Input |
| THtmlWriter | $writer | the writer for the rendering purpose. |
| Output |
| Exception |
|
renderBulletText
Renders each item
| Input |
| THtmlWriter | $writer | writer for the rendering purpose |
| TListItem | $item | item to be rendered |
| integer | $index | index of the item being rendered |
| Output |
| Exception |
|
renderContents
Renders the body contents.
| Input |
| THtmlWriter | $writer | the writer for the rendering purpose. |
| Output |
| Exception |
|
renderHyperLinkItem
| protected void renderHyperLinkItem |
(mixed $writer , mixed $item , mixed $index ) |
| Input |
| mixed | $writer | |
| mixed | $item | |
| mixed | $index | |
| Output |
| Exception |
|
renderLinkButtonItem
| protected void renderLinkButtonItem |
(mixed $writer , mixed $item , mixed $index ) |
| Input |
| mixed | $writer | |
| mixed | $item | |
| mixed | $index | |
| Output |
| Exception |
|
renderTextItem
| protected void renderTextItem |
(mixed $writer , mixed $item , mixed $index ) |
| Input |
| mixed | $writer | |
| mixed | $item | |
| mixed | $index | |
| Output |
| Exception |
|
setAutoPostBack
| public void setAutoPostBack |
(mixed $value ) |
| Input |
| mixed | $value | |
| Output |
| Exception |
| throws | TNotSupportedException if this method is invoked |
|
setBulletImageUrl
| public void setBulletImageUrl |
(string $value ) |
| Input |
| string | $value | image URL used for bullets when BulletStyle is 'CustomImage'. |
| Output |
| Exception |
|
setBulletStyle
|
setDisplayMode
|
setFirstBulletNumber
| public void setFirstBulletNumber |
(integer $value ) |
| Input |
| integer | $value | starting index when BulletStyle is one of the following: 'Numbered', 'LowerAlpha', 'UpperAlpha', 'LowerRoman', 'UpperRoman'. |
| Output |
| Exception |
|
setSelectedIndex
| public void setSelectedIndex |
(mixed $index ) |
| Input |
| mixed | $index | |
| Output |
| Exception |
| throws | TNotSupportedException if this method is invoked |
|
setSelectedIndices
| public void setSelectedIndices |
(mixed $indices ) |
| Input |
| mixed | $indices | |
| Output |
| Exception |
| throws | TNotSupportedException if this method is invoked |
|
setSelectedValue
| public void setSelectedValue |
(mixed $value ) |
| Input |
| mixed | $value | |
| Output |
| Exception |
| throws | TNotSupportedException if this method is invoked |
|
setSelectedValues
| public void setSelectedValues |
(mixed $values ) |
| Input |
| mixed | $values | |
| Output |
| Exception |
| throws | TNotSupportedException if this method is invoked |
|
setTarget
| public void setTarget |
(string $value ) |
| Input |
| string | $value | the target window or frame to display the Web page content linked to when DisplayMode is 'HyperLink' and one of the hyperlinks is clicked. |
| Output |
| Exception |
|
|