Class sap.ui.commons.SegmentedButtonModule: sap/ui/commons/SegmentedButton

extends Control
implements ToolbarItem

The SegmentedButton provides a group of multiple buttons. Only one button can be active. The behaviour is more ore less like a radio button group.

Deprecated API:Since version 1.38. Instead, use the sap.m.SegmentedButton control.

Constructor Summary
new sap.ui.commons.SegmentedButton(sId?, mSettings?)Constructor for a new SegmentedButton.
Event Summary
select(oControlEvent)Event fired when button selected
Events borrowed from class sap.ui.core.Control
validateFieldGroup
Events borrowed from class sap.ui.base.ManagedObject
formatError, modelContextChange, parseError, validationError, validationSuccess
Method Summary
sap.ui.commons.SegmentedButton.extend(sClassName, oClassInfo?, FNMetaImpl?)Creates a new subclass of class sap.ui.commons.SegmentedButton with name sClassName and enriches it with the information contained in oClassInfo.
sap.ui.commons.SegmentedButton.getMetadata()Returns a metadata object for class sap.ui.commons.SegmentedButton.
_rerenderButtons()Rerendering of the Buttons
addButton(oButton)Adds some button to the aggregation buttons.
attachSelect(oData?, fnFunction, oListener?)Attaches event handler fnFunction to the select event of this sap.ui.commons.SegmentedButton.
destroyButtons()Destroys all the buttons in the aggregation buttons.
detachSelect(fnFunction, oListener)Detaches event handler fnFunction from the select event of this sap.ui.commons.SegmentedButton.
fireSelect(mArguments?)Fires event select to attached listeners.
getButtons()Gets content of aggregation buttons.
getEnabled()Gets current value of property enabled.
getSelectedButton()ID of the element which is the current target of the association selectedButton, or null.
indexOfButton(oButton)Checks for the provided sap.ui.commons.Button in the aggregation buttons.
insertButton(oButton, iIndex)Inserts a button into the aggregation buttons.
removeAllButtons()Removes all the controls from the aggregation buttons.
removeButton(vButton)Removes a button from the aggregation buttons.
setEnabled(bEnabled)Sets a new value for property enabled.
setSelectedButton(oSelectedButton)Sets the associated selectedButton.
Methods borrowed from class sap.ui.core.Control
addStyleClass, allowTextSelection, attachBrowserEvent, attachValidateFieldGroup, checkFieldGroupIds, clone, detachBrowserEvent, detachValidateFieldGroup, fireValidateFieldGroup, getAccessibilityInfo, getBusy, getBusyIndicatorDelay, getControlsByFieldGroupId, getFieldGroupIds, getIdForLabel, getRenderer, getVisible, hasStyleClass, invalidate, isBusy, onBeforeRendering, placeAt, removeStyleClass, rerender, setBusy, setBusyIndicatorDelay, setFieldGroupIds, setVisible, toggleStyleClass, triggerValidateFieldGroup
Methods borrowed from class sap.ui.core.Element
$, addCustomData, addDependent, addEventDelegate, applyFocusInfo, bindElement, data, destroy, destroyCustomData, destroyDependents, destroyLayoutData, destroyTooltip, enhanceAccessibilityState, exit, findElements, fireEvent, focus, getCustomData, getDependents, getDomRef, getElementBinding, getFocusDomRef, getFocusInfo, getInterface, getLayoutData, getMetadata, getTooltip, getTooltip_AsString, getTooltip_Text, indexOfCustomData, indexOfDependent, insertCustomData, insertDependent, prop, removeAllCustomData, removeAllDependents, removeCustomData, removeDependent, removeEventDelegate, setLayoutData, setTooltip, toString, unbindElement
Methods borrowed from class sap.ui.base.ManagedObject
addAggregation, addAssociation, applySettings, attachFormatError, attachModelContextChange, attachParseError, attachValidationError, attachValidationSuccess, bindAggregation, bindContext, bindObject, bindProperty, destroyAggregation, detachFormatError, detachModelContextChange, detachParseError, detachValidationError, detachValidationSuccess, findAggregatedObjects, fireFormatError, fireModelContextChange, fireParseError, fireValidationError, fireValidationSuccess, getAggregation, getAssociation, getBinding, getBindingContext, getBindingInfo, getBindingPath, getEventingParent, getId, getModel, getObjectBinding, getOriginInfo, getParent, getProperty, hasModel, indexOfAggregation, insertAggregation, isBound, isInvalidateSuppressed, isTreeBinding, propagateMessages, removeAggregation, removeAllAggregation, removeAllAssociation, removeAssociation, setAggregation, setAssociation, setBindingContext, setModel, setProperty, unbindAggregation, unbindContext, unbindObject, unbindProperty, validateAggregation, validateProperty
Methods borrowed from class sap.ui.base.EventProvider
attachEvent, attachEventOnce, detachEvent, hasListeners
Constructor Detail
new sap.ui.commons.SegmentedButton(sId?, mSettings?)
Constructor for a new SegmentedButton.

Accepts an object literal mSettings that defines initial property values, aggregated and associated objects as well as event handlers. See sap.ui.base.ManagedObject for a general description of the syntax of the settings object.

The supported settings are:

  • Properties
  • Aggregations
  • Events
    • select : fnListenerFunction or [fnListenerFunction, oListenerObject] or [oData, fnListenerFunction, oListenerObject]

In addition, all settings applicable to the base type sap.ui.core.Control can be used as well.

Parameters:
{string}sId? id for the new control, generated automatically if no id is given
{object}mSettings? initial settings for the new control
Deprecated:
Since version 1.38. Instead, use the sap.m.SegmentedButton control.
Event Detail
select(oControlEvent)
Event fired when button selected
Parameters:
{sap.ui.base.Event}oControlEvent
{sap.ui.base.EventProvider}oControlEvent.getSource
{object}oControlEvent.getParameters
{string}oControlEvent.getParameters.selectedButtonId Id of selected ToggleButton
Method Detail
sap.ui.commons.SegmentedButton.extend(sClassName, oClassInfo?, FNMetaImpl?): function
Creates a new subclass of class sap.ui.commons.SegmentedButton with name sClassName and enriches it with the information contained in oClassInfo.

oClassInfo might contain the same kind of information as described in sap.ui.core.Control.extend.

Parameters:
{string}sClassName Name of the class being created
{object}oClassInfo? Object literal with information about the class
{function}FNMetaImpl? Constructor function for the metadata object; if not given, it defaults to sap.ui.core.ElementMetadata
Returns:
{function} Created class / constructor function
sap.ui.commons.SegmentedButton.getMetadata(): sap.ui.base.Metadata
Returns a metadata object for class sap.ui.commons.SegmentedButton.
Returns:
{sap.ui.base.Metadata} Metadata object describing this class
_rerenderButtons()
Rerendering of the Buttons
addButton(oButton): sap.ui.commons.SegmentedButton
Adds some button to the aggregation buttons.
Parameters:
{sap.ui.commons.Button}oButton the button to add; if empty, nothing is inserted
Returns:
{sap.ui.commons.SegmentedButton} Reference to this in order to allow method chaining
attachSelect(oData?, fnFunction, oListener?): sap.ui.commons.SegmentedButton
Attaches event handler fnFunction to the select event of this sap.ui.commons.SegmentedButton.

When called, the context of the event handler (its this) will be bound to oListener if specified, otherwise it will be bound to this sap.ui.commons.SegmentedButton itself.

Event fired when button selected

Parameters:
{object}oData? An application-specific payload object that will be passed to the event handler along with the event object when firing the event
{function}fnFunction The function to be called when the event occurs
{object}oListener? Context object to call the event handler with. Defaults to this sap.ui.commons.SegmentedButton itself
Returns:
{sap.ui.commons.SegmentedButton} Reference to this in order to allow method chaining
destroyButtons(): sap.ui.commons.SegmentedButton
Destroys all the buttons in the aggregation buttons.
Returns:
{sap.ui.commons.SegmentedButton} Reference to this in order to allow method chaining
detachSelect(fnFunction, oListener): sap.ui.commons.SegmentedButton
Detaches event handler fnFunction from the select event of this sap.ui.commons.SegmentedButton.

The passed function and listener object must match the ones used for event registration.

Parameters:
{function}fnFunction The function to be called, when the event occurs
{object}oListener Context object on which the given function had to be called
Returns:
{sap.ui.commons.SegmentedButton} Reference to this in order to allow method chaining
fireSelect(mArguments?): sap.ui.commons.SegmentedButton
Fires event select to attached listeners.

Expects the following event parameters:

  • selectedButtonId of type stringId of selected ToggleButton
Parameters:
{Map}mArguments? The arguments to pass along with the event
Returns:
{sap.ui.commons.SegmentedButton} Reference to this in order to allow method chaining
getButtons(): sap.ui.commons.Button[]
Gets content of aggregation buttons.

Buttons

Returns:
{sap.ui.commons.Button[]}
getEnabled(): boolean
Gets current value of property enabled.

enabled

Default value is true.

Returns:
{boolean} Value of property enabled
getSelectedButton(): sap.ui.commons.Button
ID of the element which is the current target of the association selectedButton, or null.
Returns:
{sap.ui.commons.Button}
indexOfButton(oButton): int
Checks for the provided sap.ui.commons.Button in the aggregation buttons. and returns its index if found or -1 otherwise.
Parameters:
{sap.ui.commons.Button}oButton The button whose index is looked for
Returns:
{int} The index of the provided control in the aggregation if found, or -1 otherwise
insertButton(oButton, iIndex): sap.ui.commons.SegmentedButton
Inserts a button into the aggregation buttons.
Parameters:
{sap.ui.commons.Button}oButton the button to insert; if empty, nothing is inserted
{int}iIndex the 0-based index the button should be inserted at; for a negative value of iIndex, the button is inserted at position 0; for a value greater than the current size of the aggregation, the button is inserted at the last position
Returns:
{sap.ui.commons.SegmentedButton} Reference to this in order to allow method chaining
removeAllButtons(): sap.ui.commons.Button[]
Removes all the controls from the aggregation buttons.

Additionally, it unregisters them from the hosting UIArea.

Returns:
{sap.ui.commons.Button[]} An array of the removed elements (might be empty)
removeButton(vButton): sap.ui.commons.Button
Removes a button from the aggregation buttons.
Parameters:
{int|string|sap.ui.commons.Button}vButton The buttonto remove or its index or id
Returns:
{sap.ui.commons.Button} The removed button or null
setEnabled(bEnabled): sap.ui.commons.SegmentedButton
Sets a new value for property enabled.

enabled

When called with a value of null or undefined, the default value of the property will be restored.

Default value is true.

Parameters:
{boolean}bEnabled New value for property enabled
Returns:
{sap.ui.commons.SegmentedButton} Reference to this in order to allow method chaining
setSelectedButton(oSelectedButton): sap.ui.commons.SegmentedButton
Sets the associated selectedButton.
Parameters:
{sap.ui.commons.Button}oSelectedButton Id of an element which becomes the new target of this selectedButton association; alternatively, an element instance may be given
Returns:
{sap.ui.commons.SegmentedButton} Reference to this in order to allow method chaining