TListBox displays a list box on a Web page that allows single or multiple selection.
The list box allows multiple selections if {@link setSelectionMode SelectionMode}
is TListSelectionMode::Multiple. It takes single selection only if Single.
The property {@link setRows Rows} specifies how many rows of options are visible
at a time. See {@link TListControl} for inherited properties.
Since v3.0.3, TListBox starts to support optgroup. To specify an option group for
a list item, set a Group attribute with it,
$listitem->Attributes->Group="Group Name";
or in template
/**
* Ensure that the ID attribute is rendered and registers the javascript code
* for initializing the active control.
*/
protected function addAttributesToRender($writer)
{
parent::addAttributesToRender($writer);
$writer->addAttribute('id', $this->getClientID());
if ($this->getAutoPostBack()) {
$this->getActiveControl()->registerCallbackClientScript($this->getClientClassName(), $this->getPostBackOptions());
}
}
