Class sap.landvisz.OptionEntityModule: sap/landvisz/OptionEntity
Options for solution entities
sClassName
and enriches it with the information contained in oClassInfo
.oOptionSource
to the aggregation named optionSources
.fnFunction
to the 'selectOption' event of this sap.landvisz.OptionEntity
.fnFunction
from the 'selectOption' event of this sap.landvisz.OptionEntity
.sap.landvisz.OptionSource
in the aggregation named optionSources
and returns its index if found or -1 otherwise.optionSources
. Accepts an object literal mSettings
that defines initial property values, aggregated and associated objects as well as event handlers.
If the name of a setting is ambiguous (e.g. a property has the same name as an event), then the framework assumes property, aggregation, association, event in that order. To override this automatic resolution, one of the prefixes "aggregation:", "association:" or "event:" can be added to the name of the setting (such a prefixed name must be enclosed in single or double quotes).
The supported settings are:
- Properties
- label : string
- selected : boolean (default: false)
- enable : boolean (default: true)
- optionTextTooltip : string
- Aggregations
- optionSources : sap.landvisz.OptionSource[]
- Associations
- Events
- selectOption : fnListenerFunction or [fnListenerFunction, oListenerObject] or [oData, fnListenerFunction, oListenerObject]
In addition, all settings applicable to the base type sap.landvisz.OptionSource can be used as well.
{string} | sId? | id for the new control, generated automatically if no id is given |
{object} | mSettings? | initial settings for the new control |
{sap.ui.base.Event} | oControlEvent | |
{sap.ui.base.EventProvider} | oControlEvent.getSource | |
{object} | oControlEvent.getParameters |
sClassName
and enriches it with the information contained in oClassInfo
. oClassInfo
might contain the same kind of informations as described in Element.extend.
{string} | sClassName | name of the class to be created |
{object} | oClassInfo? | object literal with informations about the class |
{function} | FNMetaImpl? | constructor function for the metadata object. If not given, it defaults to sap.ui.core.ElementMetadata. |
{function} | the created class / constructor function |
{sap.ui.base.Metadata} | Metadata object describing this class |
oOptionSource
to the aggregation named optionSources
. {sap.landvisz.OptionSource} | oOptionSource | the optionSource to add; if empty, nothing is inserted |
{sap.landvisz.OptionEntity} | this to allow method chaining |
fnFunction
to the 'selectOption' event of this sap.landvisz.OptionEntity
.. When called, the context of the event handler (its
this
) will be bound to oListener if specified otherwise to this sap.landvisz.OptionEntity
.
itself. Select event for option entity
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 call, when the event occurs. |
{object} | oListener? | Context object to call the event handler with. Defaults to this sap.landvisz.OptionEntity .itself. |
Returns:
{sap.landvisz.OptionEntity} | this to allow method chaining |
destroyOptionSources(): sap.landvisz.OptionEntity Destroys all the optionSources in the aggregation named optionSources
. Returns:{sap.landvisz.OptionEntity} this
to allow method chaining
detachSelectOption(fnFunction, oListener): sap.landvisz.OptionEntity Detach event handler fnFunction
from the 'selectOption' event of this sap.landvisz.OptionEntity
.
The passed function and listener object must match the ones used for event registration.
Parameters:{function} fnFunction The function to call, when the event occurs. {object} oListener Context object on which the given function had to be called.
Returns:{sap.landvisz.OptionEntity} this
to allow method chaining
fireSelectOption(mArguments?): sap.landvisz.OptionEntity Fire event selectOption to attached listeners. Parameters:{Map} mArguments? the arguments to pass along with the event.
Returns:{sap.landvisz.OptionEntity} this
to allow method chaining
getEnable(): boolean Getter for property enable
. enabling/disabling options Default value is true
Returns:{boolean} the value of property enable
getLabel(): string Getter for property label
. label for option entity Default value is empty/undefined
Returns:{string} the value of property label
getOptionSources(): sap.landvisz.OptionSource[] Getter for aggregation optionSources
.
Option Renderer Control Returns:{sap.landvisz.OptionSource[]}
getOptionTextTooltip(): string Getter for property optionTextTooltip
. tooltip for options Default value is empty/undefined
Returns:{string} the value of property optionTextTooltip
getSelected(): boolean Getter for property selected
. determines current selected option Default value is false
Returns:{boolean} the value of property selected
indexOfOptionSource(oOptionSource): int Checks for the provided sap.landvisz.OptionSource
in the aggregation named optionSources
and returns its index if found or -1 otherwise. Parameters:{sap.landvisz.OptionSource} oOptionSource the optionSource whose index is looked for.
Returns:{int} the index of the provided control in the aggregation if found, or -1 otherwise
insertOptionSource(oOptionSource, iIndex): sap.landvisz.OptionEntity Inserts a optionSource into the aggregation named optionSources
. Parameters:{sap.landvisz.OptionSource} oOptionSource the optionSource to insert; if empty, nothing is inserted {int} iIndex the 0
-based index the optionSource should be inserted at; for a negative value of iIndex
, the optionSource is inserted at position 0; for a value greater than the current size of the aggregation, the optionSource is inserted at the last position
Returns:{sap.landvisz.OptionEntity} this
to allow method chaining
removeAllOptionSources(): sap.landvisz.OptionSource[] Removes all the controls in the aggregation named optionSources
.
Additionally unregisters them from the hosting UIArea. Returns:{sap.landvisz.OptionSource[]} an array of the removed elements (might be empty)
removeOptionSource(vOptionSource): sap.landvisz.OptionSource Removes an optionSource from the aggregation named optionSources
. Parameters:{int|string|sap.landvisz.OptionSource} vOptionSource the optionSource to remove or its index or id
Returns:{sap.landvisz.OptionSource} the removed optionSource or null
setEnable(bEnable): sap.landvisz.OptionEntity Setter for property enable
. Default value is true
Parameters:{boolean} bEnable new value for property enable
Returns:{sap.landvisz.OptionEntity} this
to allow method chaining
setLabel(sLabel): sap.landvisz.OptionEntity Setter for property label
. Default value is empty/undefined
Parameters:{string} sLabel new value for property label
Returns:{sap.landvisz.OptionEntity} this
to allow method chaining
setOptionTextTooltip(sOptionTextTooltip): sap.landvisz.OptionEntity Setter for property optionTextTooltip
. Default value is empty/undefined
Parameters:{string} sOptionTextTooltip new value for property optionTextTooltip
Returns:{sap.landvisz.OptionEntity} this
to allow method chaining
setSelected(bSelected): sap.landvisz.OptionEntity Setter for property selected
. Default value is false
Parameters:{boolean} bSelected new value for property selected
Returns:{sap.landvisz.OptionEntity} this
to allow method chaining