Class cHTMLSelectElement

cHTMLSelectElement class represents a select element.

cHTML

cHTMLSelectElement

Direct known subclasses

Package: Core\GUI\HTML
Copyright: four for business AG <www.4fb.de>
License: http://www.contenido.org/license/LIZENZ.txt
Author: Simon Sprankel
Located at classes/html/class.html.selectelement.php

Methods summary
`public`	# `__construct( string $name, string $width = '', string $id = '', boolean $disabled = false, string $tabindex = NULL, string $accesskey = '', string $class = '' )` Constructor to create an instance of this class. Constructor to create an instance of this class. Creates an HTML select field (aka "DropDown"). Parameters `$name` `string` $name Name of the element `$width` `string` $width [optional] Width of the select element `$id` `string` $id [optional] ID of the element `$disabled` `boolean` $disabled [optional] Item disabled flag (non-empty to set disabled) `$tabindex` `string` $tabindex [optional] Tab index for form elements `$accesskey` `string` $accesskey [optional] Key to access the field `$class` `string` $class [optional] the class of this element Overrides `cHTMLFormElement::__construct()`
`public cHTMLSelectElement`	# `autoFill( array $stuff )` Automatically creates and fills cHTMLOptionElements Automatically creates and fills cHTMLOptionElements Array format: $stuff = array( array('value', 'title'), array('value', 'title') ); or regular key => value arrays: $stuff = array( 'value' => 'title', 'value' => 'title' ); Parameters `$stuff` `array` $stuff Array with all items Returns `cHTMLSelectElement` $this for chaining
`public cHTMLSelectElement`	# `addOptionElement( string $index, cHTMLOptionElement $element )` Adds an cHTMLOptionElement to the number of choices at the specified position. Adds an cHTMLOptionElement to the number of choices at the specified position. Parameters `$index` `string` $index Index of the element `$element` `cHTMLOptionElement` $element Filled cHTMLOptionElement to add Returns `cHTMLSelectElement` $this for chaining
`public cHTMLSelectElement`	# `appendOptionElement( cHTMLOptionElement $element )` Appends a cHTMLOptionElement to the number of choices. Appends a cHTMLOptionElement to the number of choices. Parameters `$element` `cHTMLOptionElement` $element Filled cHTMLOptionElement to add Returns `cHTMLSelectElement` $this for chaining
`public cHTMLSelectElement`	# `setMultiselect( )` Defines that this select element is a multiselect element. Defines that this select element is a multiselect element. Returns `cHTMLSelectElement` $this for chaining
`public cHTMLSelectElement`	# `setSize( integer $size )` Defines the size of this select element. Defines the size of this select element. Parameters `$size` `integer` $size Returns `cHTMLSelectElement` $this for chaining
`public cHTMLSelectElement`	# `setDefault( string $lvalue )` Sets a specific cHTMLOptionElement to the selected state. Sets a specific cHTMLOptionElement to the selected state. Parameters `$lvalue` `string` $lvalue Specifies the "value" of the cHTMLOptionElement to set Returns `cHTMLSelectElement` $this for chaining
`public string\|boolean`	# `getDefault( )` Search for the selected elements Search for the selected elements Returns `string\|boolean` "lvalue" or false
`public cHTMLSelectElement`	# `setSelected( array $elements )` Sets specified elements as selected (and all others as unselected) Sets specified elements as selected (and all others as unselected) Parameters `$elements` `array` $elements Array with "values" of the cHTMLOptionElement to set Returns `cHTMLSelectElement` $this for chaining
`public string`	# `toHtml( )` Renders the select box Renders the select box Returns `string` Rendered HTML Overrides `cHTML::toHtml()`

Methods inherited from cHTMLFormElement
`setAccessKey(), setDisabled(), setTabindex()`

Methods inherited from cHTML
`__toString(), _appendContent(), _getAttrString(), _parseAttributes(), _setContent(), addRequiredScript(), advanceID(), appendStyleDefinition(), appendStyleDefinitions(), attachEventDefinition(), display(), fillCloseSkeleton(), fillSkeleton(), getAttribute(), getAttributes(), getID(), removeAttribute(), render(), setAlt(), setAttribute(), setAttributes(), setClass(), setEvent(), setGenerateXHTML(), setID(), setStyle(), setTag(), unsetEvent(), updateAttribute(), updateAttributes()`

Properties summary
`protected cHTMLOptionElement[]`	`$_options`	`array()`	# All cHTMLOptionElements All cHTMLOptionElements

Properties inherited from cHTML
`$_attributes, $_content, $_contentlessTag, $_eventDefinitions, $_generateXHTML, $_idCounter, $_requiredScripts, $_skeletonClose, $_skeletonOpen, $_skeletonSingle, $_styleDefinitions, $_styleDefs, $_tag`

Packages

Classes

Class cHTMLSelectElement

Direct known subclasses

Parameters

Overrides

Parameters

Returns

Parameters

Returns

Parameters

Returns

Returns

Parameters

Returns

Parameters

Returns

Returns

Parameters

Returns

Returns

Overrides