sap.suite.ui.commons.ChartContainer.extend(sClassName, oClassInfo?, FNMetaImpl?): function
Creates a new subclass of class sap.suite.ui.commons.ChartContainer with name
sClassName
and enriches it with the information contained in
oClassInfo
.
oClassInfo
might contain the same kind of informations as described in Element.extend.
Parameters:
{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. |
Returns:
{function} | the created class / constructor function |
Returns a metadata object for class sap.suite.ui.commons.ChartContainer.
Returns:
Adds some content oContent
to the aggregation named content
.
Parameters:
Returns:
Adds some customIcon oCustomIcon
to the aggregation named customIcons
.
Parameters:
{sap.ui.core.Icon} | oCustomIcon | the customIcon to add; if empty, nothing is inserted |
Returns:
Adds some dimensionSelector oDimensionSelector
to the aggregation named dimensionSelectors
.
Parameters:
{sap.ui.core.Control} | oDimensionSelector | the dimensionSelector to add; if empty, nothing is inserted |
Returns:
Attach event handler
fnFunction
to the 'contentChange' event of this
sap.suite.ui.commons.ChartContainer
.
. When called, the context of the event handler (its
this
) will be bound to
oListener if specified otherwise to this sap.suite.ui.commons.ChartContainer
.
itself. Event fired when a user changes the displayed content.
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.suite.ui.commons.ChartContainer . itself. |
Returns:
Attach event handler
fnFunction
to the 'customZoomInPress' event of this
sap.suite.ui.commons.ChartContainer
.
. When called, the context of the event handler (its
this
) will be bound to
oListener if specified otherwise to this sap.suite.ui.commons.ChartContainer
.
itself. Custom event for zoom in.
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.suite.ui.commons.ChartContainer . itself. |
Returns:
Attach event handler
fnFunction
to the 'customZoomOutPress' event of this
sap.suite.ui.commons.ChartContainer
.
. When called, the context of the event handler (its
this
) will be bound to
oListener if specified otherwise to this sap.suite.ui.commons.ChartContainer
.
itself. Custom event for zoom out.
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.suite.ui.commons.ChartContainer . itself. |
Returns:
Attach event handler
fnFunction
to the 'personalizationPress' event of this
sap.suite.ui.commons.ChartContainer
.
. When called, the context of the event handler (its
this
) will be bound to
oListener if specified otherwise to this sap.suite.ui.commons.ChartContainer
.
itself. Event fired when a user clicks on the personalization icon.
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.suite.ui.commons.ChartContainer . itself. |
Returns:
Destroys all the content in the aggregation named content
.
Returns:
Destroys all the customIcons in the aggregation named customIcons
.
Returns:
Destroys all the dimensionSelectors in the aggregation named dimensionSelectors
.
Returns:
Detach event handler
fnFunction
from the 'contentChange' event of this
sap.suite.ui.commons.ChartContainer
.
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:
Detach event handler
fnFunction
from the 'customZoomInPress' event of this
sap.suite.ui.commons.ChartContainer
.
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:
Detach event handler
fnFunction
from the 'customZoomOutPress' event of this
sap.suite.ui.commons.ChartContainer
.
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:
Detach event handler
fnFunction
from the 'personalizationPress' event of this
sap.suite.ui.commons.ChartContainer
.
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:
Fire event contentChange to attached listeners.
Expects following event parameters:
- 'selectedItemId' of type
string
Id of the selected item.
Parameters:
{Map} | mArguments? | the arguments to pass along with the event. |
Returns:
Fire event customZoomInPress to attached listeners.
Parameters:
{Map} | mArguments? | the arguments to pass along with the event. |
Returns:
Fire event customZoomOutPress to attached listeners.
Parameters:
{Map} | mArguments? | the arguments to pass along with the event. |
Returns:
Fire event personalizationPress to attached listeners.
Parameters:
{Map} | mArguments? | the arguments to pass along with the event. |
Returns:
getAutoAdjustHeight(): boolean
Getter for property
autoAdjustHeight
. Determine whether to stretch the chart height to the maximum possible height of ChartContainer's parent container. As a prerequisite, the parent container needs to have a fixed value height or be able to determine height from its parent.
Default value is false
Returns:
{boolean} | the value of property autoAdjustHeight |
Getter for aggregation
content
.
ChartToolBar Content aggregation. Only vizFrame, sap.m.Table and sap.ui.table.Table can be embedded. If not specified explicitly, the rendering order of the charts is determined by the sequence of contents provided by the application via this aggregation. That means, per default the first chart of the aggregation will be rendered within the container.
Note: this is the default aggregation for ChartContainer.
Returns:
Getter for aggregation customIcons
.
This aggregation contains the custom icons that should be displayed additionally on the toolbar. It is not guaranteed that the same instance of the sap.ui.core.Icon control will be used within the toolbar, but the toolbar will contain a sap.m.OverflowToolbarButton with an icon property equal to the src property of the sap.ui.core.Icon provided in the aggregation. If a press event is triggered by the icon displayed on the toolbar, then the press handler of the original sap.ui.core.Icon control is used. The instance of the control, that has triggered the press event, can be accessed using the "controlReference" parameter of the event object.
Returns:
Getter for aggregation dimensionSelectors
.
Dimension Selects.
Returns:
getFullScreen(): boolean
Getter for property
fullScreen
. Display the chart and the toolbar in full screen or normal mode.
Default value is false
Returns:
{boolean} | the value of property fullScreen |
Returns the current instance of the delegate to other controls.
Returns:
Returns the currently selected content control.
Returns:
getShowFullScreen(): boolean
Getter for property
showFullScreen
. Set to true to display the full screen icon. Set to false to hide it.
Default value is false
Returns:
{boolean} | the value of property showFullScreen |
getShowLegend(): boolean
Getter for property
showLegend
. Set to true to display the charts' legends. Set to false to hide them. See also showLegendButton.
Default value is true
Returns:
{boolean} | the value of property showLegend |
getShowLegendButton(): boolean
Getter for property
showLegendButton
. Set to true or false to display or hide a button for controlling the visbility of the chart's legend. Please be aware that setting this property to true indirectly is setting showLegend to false. If you need to hide the button but to show the legend, you need to set showLegend at a later point in time (onBeforeRendering). The execution order of the combined properties is not guaranteed by the control.
Default value is true
Returns:
{boolean} | the value of property showLegendButton |
getShowPersonalization(): boolean
Getter for property
showPersonalization
. Set to true to display the personalization icon. Set to false to hide it.
Default value is false
Returns:
{boolean} | the value of property showPersonalization |
getShowZoom(): boolean
Getter for property
showZoom
. Set to true to display zoom icons. Set to false to hide them.
Default value is true
Returns:
{boolean} | the value of property showZoom |
getTitle(): string
Getter for property
title
. String shown if there are no dimensions to display.
Default value is empty/undefined
Returns:
{string} | the value of property title |
indexOfContent(oContent): int
Checks for the provided sap.suite.ui.commons.ChartContainerContent
in the aggregation named content
and returns its index if found or -1 otherwise.
Parameters:
Returns:
{int} | the index of the provided control in the aggregation if found, or -1 otherwise |
indexOfCustomIcon(oCustomIcon): int
Checks for the provided sap.ui.core.Icon
in the aggregation named customIcons
and returns its index if found or -1 otherwise.
Parameters:
Returns:
{int} | the index of the provided control in the aggregation if found, or -1 otherwise |
indexOfDimensionSelector(oDimensionSelector): int
Checks for the provided sap.ui.core.Control
in the aggregation named dimensionSelectors
and returns its index if found or -1 otherwise.
Parameters:
Returns:
{int} | the index of the provided control in the aggregation if found, or -1 otherwise |
Inserts a content into the aggregation named content
.
Parameters:
{sap.suite.ui.commons.ChartContainerContent} | oContent | the content to insert; if empty, nothing is inserted |
{int} | iIndex | the 0 -based index the content should be inserted at; for a negative value of iIndex , the content is inserted at position 0; for a value greater than the current size of the aggregation, the content is inserted at the last position |
Returns:
Inserts a customIcon into the aggregation named customIcons
.
Parameters:
{sap.ui.core.Icon} | oCustomIcon | the customIcon to insert; if empty, nothing is inserted |
{int} | iIndex | the 0 -based index the customIcon should be inserted at; for a negative value of iIndex , the customIcon is inserted at position 0; for a value greater than the current size of the aggregation, the customIcon is inserted at the last position |
Returns:
Inserts a dimensionSelector into the aggregation named dimensionSelectors
.
Parameters:
{sap.ui.core.Control} | oDimensionSelector | the dimensionSelector to insert; if empty, nothing is inserted |
{int} | iIndex | the 0 -based index the dimensionSelector should be inserted at; for a negative value of iIndex , the dimensionSelector is inserted at position 0; for a value greater than the current size of the aggregation, the dimensionSelector is inserted at the last position |
Returns:
Removes all the controls in the aggregation named content
.
Additionally unregisters them from the hosting UIArea.
Returns:
Removes all the controls in the aggregation named customIcons
.
Additionally unregisters them from the hosting UIArea.
Returns:
Removes all the controls in the aggregation named dimensionSelectors
.
Additionally unregisters them from the hosting UIArea.
Returns:
Removes an content from the aggregation named content
.
Parameters:
Returns:
Removes an customIcon from the aggregation named customIcons
.
Parameters:
{int|string|sap.ui.core.Icon} | vCustomIcon | the customIcon to remove or its index or id |
Returns:
Removes an dimensionSelector from the aggregation named dimensionSelectors
.
Parameters:
{int|string|sap.ui.core.Control} | vDimensionSelector | the dimensionSelector to remove or its index or id |
Returns:
Setter for property
autoAdjustHeight
.
Default value is false
Parameters:
{boolean} | bAutoAdjustHeight | new value for property autoAdjustHeight |
Returns:
Setter for property
fullScreen
.
Default value is false
Parameters:
{boolean} | bFullScreen | new value for property fullScreen |
Returns:
Setter for property
showFullScreen
.
Default value is false
Parameters:
{boolean} | bShowFullScreen | new value for property showFullScreen |
Returns:
Setter for property
showLegend
.
Default value is true
Parameters:
{boolean} | bShowLegend | new value for property showLegend |
Returns:
Setter for property
showLegendButton
.
Default value is true
Parameters:
{boolean} | bShowLegendButton | new value for property showLegendButton |
Returns:
Setter for property
showPersonalization
.
Default value is false
Parameters:
{boolean} | bShowPersonalization | new value for property showPersonalization |
Returns:
Setter for property
showZoom
.
Default value is true
Parameters:
{boolean} | bShowZoom | new value for property showZoom |
Returns:
Setter for property
title
.
Default value is empty/undefined
Parameters:
{string} | sTitle | new value for property title |
Returns:
switchChart(chart)
Switches the currently viewed content (triggers re-rendering).
Parameters:
Updates ChartContainer and re-renders all its contents.
Returns:
getSelectorGroupLabel(): string
Getter for property
selectorGroupLabel
. Custom Label for Selectors Group.
Default value is empty/undefined
- Deprecated:
- Since version 1.32.0. Obsolete property as sap.m.Toolbar is replaced by sap.m.OverflowToolbar.
Returns:
{string} | the value of property selectorGroupLabel |