A single/multiple selection element.(c) SAP AG 2003-2006. All rights reserved. Gets or sets the number of displayed columns. Gets or sets the cursor key.The cursor is only available for the <code>dual</code> choice type. Gets or sets the list of items that are displayed by the choice control.The property is a semicolon-separated list of value:text pairs defining the choice items. The order of the items in the list defines also their display order.<q ref="core.lib:Choice!value">value</q> Gets or sets whether the button can respond to user interaction. Gets or sets the control styling glyph.<p>By default, the glyph is set according to the <q ref="core.lib:Choice!type">type</q> property.</p> Gets the current selection HTML text.<ul><li>For single-selection choice types, the property holds the HTML text of the currently selected item. </li><li>For multiple-selection choice types, the property holds an array of the HTML texts of the selected items. </li></ul><q ref="core.lib:Choice!value">value</q> | <q ref="core.lib:Choice!text">text</q> Indicates whether the current selection is empty. Gets the total number of items.<q ref="core.lib:Choice!domain">domain</q> Indicates whether the choice type is single or multiple selection. Gets or sets whether quick selection mode is enabled (i.e., select by dragging the mouse). Gets an object holding the currently selected keys.<q ref="core.lib:Choice!value">value</q> Gets the current selection text (stripped of any HTML markup).<ul><li>For single-selection choice types, the property holds the text of the currently selected item. </li><li>For multiple-selection choice types, the property holds an array of the texts of the selected items. </li></ul><q ref="core.lib:Choice!value">value</q> | <q ref="core.lib:Choice!html">html</q> Gets or sets the control type. Gets or sets the current selection value.<ul><li>For single-selection choice types, the property holds the key of the currently selected item. </li><li>For multiple-selection choice types, the property holds a whitespace-separated list of the keys of the selected items. </li></ul><q ref="core.lib:Choice!selection">selection</q> | <q ref="core.lib:Choice!domain">domain</q> | <q ref="core.lib:Choice!text">text</q> | <q ref="core.lib:Choice!html">html</q> Gets the number of selected items.<q ref="core.lib:Choice!value">value</q> Gets or sets the action to perform when the mouse wheel is rolled over this element (scroll|select|none). Appends a new item after a specified item.The new item to append.The key of the item after which the new item will be appended (if omitted, the new item will be appended at the end).Indicates whether the new item should also be selected after it is created. Enables or disables the specified item.Key of the item to enable/disable. Gets the first item.The requested HTML element. Gets the HTML element that represents a given item.The item key.The requested HTML element. Gets a data object with the value and text of a given item.An object containing the value and text of the requested item. Gets a table of data objects with the value and text of all items.An array of items data. Gets the last item.The requested HTML element. Gets the item that immediately follows a specified item.The item key.The requested HTML element. Gets the item that immediately precedes a specified item.The item key.The requested HTML element. Inserts a new item before a specified item.The new item to insert.The key of the item before which the new item will be inserted (if omitted, the new item will be inserted at the beginning).Indicates whether the new item should also be selected after it is created. Tests whether the specified item is enabled.Key of the item to test.Returns <code>true</code> if the item is enabled, <code>false</code> otherwise. Tests whether the specified item is selected.Key of the item to test.Returns <code>true</code> if the item is selected, <code>false</code> otherwise. Moves the source item after the target item.The key of the source item.The key of the target item. Moves the source item before the target item.The key of the source item.The key of the target item. Moves the specified item to the beginning of the list.The key of the item to move. Moves the specified item to the end of the list.The key of the item to move. Moves the specified item to the next position in the list.The key of the item to move.Indicates whether to cycle to the beginning of the list when attempting to move past the end of the list. Moves the specified item to the previous position in the list.The key of the item to move.Indicates whether to cycle to the end of the list when attempting to move past the beginning of the list. Removes all items from the control. Removes an existing item.The key of the item to remove.Indicates whether the current selection should be updated to the closest neighbor of the removed item, if it was previously selected. Selects all items. Selects the first item in the list. Selects or deselect the specified item.Key of the item to select or deselect.Indicates whether to select or deselect the specified item. Selects the last item in the list. Selects the item that follows the currently selected item (only in single-selection types). Deselects all items. Selects the item that precedes the currently selected item (only in single-selection types). Toggles the selection state of the specified item.Key of the item to toggle. Fires whenever the selection is changed.The current selection value (see <q ref="core.lib:Choice!value">value</q>).The key of the item that has changed. Fires whenever the cursor is moved.The key of the item that has the cursor. An enumeration of available choice types.The available choice types are listed below: <table class="VERT"><tr><td class="H V">RADIO </td><td class=H>A group of radio buttons </td></tr><tr><td class=V>CHECKLIST </td><td>A list of checkbox buttons </td></tr><tr><td class=V>SELECT </td><td>A single selection list </td></tr><tr><td class=V>MULTISEL </td><td>A multiple selection list </td></tr><tr><td class=V>DUALSEL </td><td>A multiple selection list with a cursor </td></tr></table>