Class sap.viz.ui5.types.TooltipModule: sap/viz/ui5/types/Tooltip


Module sap.viz.ui5.types.Tooltip

Deprecated API:Since version 1.32.0. The chart controls in the sap.viz.ui5 package (which were always marked as experimental) have been deprecated since 1.32.0. They are no longer actively developed and won't receive new features or improvements, only important bug fixes. They will only remain in the SAPUI5 distribution for backward compatibility.

SAP strongly recommends that existing consumers of those controls migrate to the new VizFrame control to benefit from new charting enhancements and timely support.

Note: As the feature set, design and API usage of VizFrame might differ from the old chart controls, make sure you evaluate it thoroughly before migration.

Experimental API:Since version 1.7.2. Charting API is not finished yet and might change completely.


Since: 1.7.2.
Constructor Summary
new sap.viz.ui5.types.Tooltip(sId?, mSettings?)Constructor for a new sap.viz.ui5.types.Tooltip

Accepts an object literal mSettings that defines initial property values, aggregated and associated objects as well as event handlers.

Method Summary
sap.viz.ui5.types.Tooltip.extend(sClassName, oClassInfo?, FNMetaImpl?)Creates a new subclass of class sap.viz.ui5.types.Tooltip with name sClassName and enriches it with the information contained in oClassInfo.
sap.viz.ui5.types.Tooltip.getMetadata()Returns a metadata object for class sap.viz.ui5.types.Tooltip.
destroyBackground()Destroys the background in the aggregation background.
getBackground()Gets content of aggregation background.
getFormatString()Gets current value of property formatString.
getLayinChart()Gets current value of property layinChart.
getPostRender()Gets current value of property postRender.
getPreRender()Gets current value of property preRender.
getVisible()Gets current value of property visible.
setBackground(oBackground)Sets the aggregated background.
setFormatString(sFormatString)Sets a new value for property formatString.
setLayinChart(bLayinChart)Sets a new value for property layinChart.
setPostRender(oPostRender)Sets a new value for property postRender.
setPreRender(oPreRender)Sets a new value for property preRender.
setVisible(bVisible)Sets a new value for property visible.
destroyBodyDimensionLabel()Destroys the bodyDimensionLabel in the aggregation bodyDimensionLabel.
destroyBodyDimensionValue()Destroys the bodyDimensionValue in the aggregation bodyDimensionValue.
destroyBodyMeasureLabel()Destroys the bodyMeasureLabel in the aggregation bodyMeasureLabel.
destroyBodyMeasureValue()Destroys the bodyMeasureValue in the aggregation bodyMeasureValue.
destroyCloseButton()Destroys the closeButton in the aggregation closeButton.
destroyFooterLabel()Destroys the footerLabel in the aggregation footerLabel.
destroySeparationLine()Destroys the separationLine in the aggregation separationLine.
getBodyDimensionLabel()Gets content of aggregation bodyDimensionLabel.
getBodyDimensionValue()Gets content of aggregation bodyDimensionValue.
getBodyMeasureLabel()Gets content of aggregation bodyMeasureLabel.
getBodyMeasureValue()Gets content of aggregation bodyMeasureValue.
getCloseButton()Gets content of aggregation closeButton.
getDrawingEffect()Gets current value of property drawingEffect.
getFooterLabel()Gets content of aggregation footerLabel.
getSeparationLine()Gets content of aggregation separationLine.
setBodyDimensionLabel(oBodyDimensionLabel)Sets the aggregated bodyDimensionLabel.
setBodyDimensionValue(oBodyDimensionValue)Sets the aggregated bodyDimensionValue.
setBodyMeasureLabel(oBodyMeasureLabel)Sets the aggregated bodyMeasureLabel.
setBodyMeasureValue(oBodyMeasureValue)Sets the aggregated bodyMeasureValue.
setCloseButton(oCloseButton)Sets the aggregated closeButton.
setDrawingEffect(sDrawingEffect)Sets a new value for property drawingEffect.
setFooterLabel(oFooterLabel)Sets the aggregated footerLabel.
setSeparationLine(oSeparationLine)Sets the aggregated separationLine.
Constructor Detail
new sap.viz.ui5.types.Tooltip(sId?, mSettings?)
Constructor for a new sap.viz.ui5.types.Tooltip

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:

In addition, all settings applicable to the base type sap.viz.ui5.core.BaseStructuredType 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.32.0. The chart controls in the sap.viz.ui5 package (which were always marked as experimental) have been deprecated since 1.32.0. They are no longer actively developed and won't receive new features or improvements, only important bug fixes. They will only remain in the SAPUI5 distribution for backward compatibility.

SAP strongly recommends that existing consumers of those controls migrate to the new VizFrame control to benefit from new charting enhancements and timely support.

Note: As the feature set, design and API usage of VizFrame might differ from the old chart controls, make sure you evaluate it thoroughly before migration.

Method Detail
sap.viz.ui5.types.Tooltip.extend(sClassName, oClassInfo?, FNMetaImpl?): function
Creates a new subclass of class sap.viz.ui5.types.Tooltip with name sClassName and enriches it with the information contained in oClassInfo.

oClassInfo might contain the same kind of information as described in sap.viz.ui5.core.BaseStructuredType.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.viz.ui5.types.Tooltip.getMetadata(): sap.ui.base.Metadata
Returns a metadata object for class sap.viz.ui5.types.Tooltip.
Returns:
{sap.ui.base.Metadata} Metadata object describing this class
destroyBackground(): sap.viz.ui5.types.Tooltip
Destroys the background in the aggregation background.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
Gets content of aggregation background.

Define the background style of the tooltip.

Returns:
{sap.viz.ui5.types.Tooltip_background}
getFormatString(): any[]
Gets current value of property formatString.

Set the format strings for text in the tooltip. For dual axis charts, the first array is applied to the primary axis and the second array is applied to the second axis. If you enter fewer format strings into an array than there are measures in the respective axis, then the last format string is applied to all remaining measures. The following characters are reserved as tokens for format code: MDYHSAmdyhsa#?%0@.The following is an example of an array for a chart with two measures: [["#,##0.00 DM;-#,##.00 DM","#,##.00;-#,##.00"]].

Returns:
{any[]} Value of property formatString
getLayinChart(): boolean
Gets current value of property layinChart.

Set whether the tooltip appears in the chart area

Default value is true.

Returns:
{boolean} Value of property layinChart
getPostRender(): any
Gets current value of property postRender.

A callback function can be specified as a parameter and passed to chart options when the user calls the createViz function. This callback function is called after the tooltip is rendered. The user can select and change dom elements' properties under the tooltip element.

Returns:
{any} Value of property postRender
getPreRender(): any
Gets current value of property preRender.

A callback function can be specified as a parameter and passed to chart options when the user calls the createViz function. This callback function is called before the tooltip is rendered. The input parameter is a dom element, which is at the bottom of the tooltip. Any dom element such as a button can be appended to this parent node. It can only be called when the tooltip is in actionMode.

Returns:
{any} Value of property preRender
getVisible(): boolean
Gets current value of property visible.

Set the visibility of the tooltip

Default value is true.

Returns:
{boolean} Value of property visible
setBackground(oBackground): sap.viz.ui5.types.Tooltip
Sets the aggregated background.
Parameters:
{sap.viz.ui5.types.Tooltip_background}oBackground The background to set
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
setFormatString(sFormatString): sap.viz.ui5.types.Tooltip
Sets a new value for property formatString.

Set the format strings for text in the tooltip. For dual axis charts, the first array is applied to the primary axis and the second array is applied to the second axis. If you enter fewer format strings into an array than there are measures in the respective axis, then the last format string is applied to all remaining measures. The following characters are reserved as tokens for format code: MDYHSAmdyhsa#?%0@.The following is an example of an array for a chart with two measures: [["#,##0.00 DM;-#,##.00 DM","#,##.00;-#,##.00"]].

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

Parameters:
{any[]}sFormatString New value for property formatString
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
setLayinChart(bLayinChart): sap.viz.ui5.types.Tooltip
Sets a new value for property layinChart.

Set whether the tooltip appears in the chart area

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

Default value is true.

Parameters:
{boolean}bLayinChart New value for property layinChart
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
setPostRender(oPostRender): sap.viz.ui5.types.Tooltip
Sets a new value for property postRender.

A callback function can be specified as a parameter and passed to chart options when the user calls the createViz function. This callback function is called after the tooltip is rendered. The user can select and change dom elements' properties under the tooltip element.

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

Parameters:
{any}oPostRender New value for property postRender
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
setPreRender(oPreRender): sap.viz.ui5.types.Tooltip
Sets a new value for property preRender.

A callback function can be specified as a parameter and passed to chart options when the user calls the createViz function. This callback function is called before the tooltip is rendered. The input parameter is a dom element, which is at the bottom of the tooltip. Any dom element such as a button can be appended to this parent node. It can only be called when the tooltip is in actionMode.

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

Parameters:
{any}oPreRender New value for property preRender
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
setVisible(bVisible): sap.viz.ui5.types.Tooltip
Sets a new value for property visible.

Set the visibility of the tooltip

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

Default value is true.

Parameters:
{boolean}bVisible New value for property visible
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
destroyBodyDimensionLabel(): sap.viz.ui5.types.Tooltip
Destroys the bodyDimensionLabel in the aggregation bodyDimensionLabel.
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
destroyBodyDimensionValue(): sap.viz.ui5.types.Tooltip
Destroys the bodyDimensionValue in the aggregation bodyDimensionValue.
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
destroyBodyMeasureLabel(): sap.viz.ui5.types.Tooltip
Destroys the bodyMeasureLabel in the aggregation bodyMeasureLabel.
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
destroyBodyMeasureValue(): sap.viz.ui5.types.Tooltip
Destroys the bodyMeasureValue in the aggregation bodyMeasureValue.
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
destroyCloseButton(): sap.viz.ui5.types.Tooltip
Destroys the closeButton in the aggregation closeButton.
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
destroyFooterLabel(): sap.viz.ui5.types.Tooltip
Destroys the footerLabel in the aggregation footerLabel.
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
destroySeparationLine(): sap.viz.ui5.types.Tooltip
Destroys the separationLine in the aggregation separationLine.
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
Gets content of aggregation bodyDimensionLabel.

Define the color of the dimension name of the tooltip body.

Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip_bodyDimensionLabel}
Gets content of aggregation bodyDimensionValue.

Define the color of the dimension value of the tooltip body.

Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip_bodyDimensionValue}
Gets content of aggregation bodyMeasureLabel.

Define the color of the measure name of the tooltip body.

Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip_bodyMeasureLabel}
Gets content of aggregation bodyMeasureValue.

Define the color of the measure value of the tooltip body.

Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip_bodyMeasureValue}
Gets content of aggregation closeButton.

Define the background and border color of tooltip close button.

Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip_closeButton}
Gets current value of property drawingEffect.

Set the drawing effect for the tooltip

Default value is normal.

Deprecated:
Since version 1.19. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip_drawingEffect} Value of property drawingEffect
Gets content of aggregation footerLabel.

Define the style of the label of the tooltip footer.

Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip_footerLabel}
Gets content of aggregation separationLine.

Define the color of the value of the tooltip separation line.

Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip_separationLine}
setBodyDimensionLabel(oBodyDimensionLabel): sap.viz.ui5.types.Tooltip
Sets the aggregated bodyDimensionLabel.
Parameters:
{sap.viz.ui5.types.Tooltip_bodyDimensionLabel}oBodyDimensionLabel The bodyDimensionLabel to set
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
setBodyDimensionValue(oBodyDimensionValue): sap.viz.ui5.types.Tooltip
Sets the aggregated bodyDimensionValue.
Parameters:
{sap.viz.ui5.types.Tooltip_bodyDimensionValue}oBodyDimensionValue The bodyDimensionValue to set
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
setBodyMeasureLabel(oBodyMeasureLabel): sap.viz.ui5.types.Tooltip
Sets the aggregated bodyMeasureLabel.
Parameters:
{sap.viz.ui5.types.Tooltip_bodyMeasureLabel}oBodyMeasureLabel The bodyMeasureLabel to set
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
setBodyMeasureValue(oBodyMeasureValue): sap.viz.ui5.types.Tooltip
Sets the aggregated bodyMeasureValue.
Parameters:
{sap.viz.ui5.types.Tooltip_bodyMeasureValue}oBodyMeasureValue The bodyMeasureValue to set
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
setCloseButton(oCloseButton): sap.viz.ui5.types.Tooltip
Sets the aggregated closeButton.
Parameters:
{sap.viz.ui5.types.Tooltip_closeButton}oCloseButton The closeButton to set
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
setDrawingEffect(sDrawingEffect): sap.viz.ui5.types.Tooltip
Sets a new value for property drawingEffect.

Set the drawing effect for the tooltip

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

Default value is normal.

Parameters:
{sap.viz.ui5.types.Tooltip_drawingEffect}sDrawingEffect New value for property drawingEffect
Deprecated:
Since version 1.19. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
setFooterLabel(oFooterLabel): sap.viz.ui5.types.Tooltip
Sets the aggregated footerLabel.
Parameters:
{sap.viz.ui5.types.Tooltip_footerLabel}oFooterLabel The footerLabel to set
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining
setSeparationLine(oSeparationLine): sap.viz.ui5.types.Tooltip
Sets the aggregated separationLine.
Parameters:
{sap.viz.ui5.types.Tooltip_separationLine}oSeparationLine The separationLine to set
Deprecated:
Since version 1.12. This Property has been deprecated. This interface will be removed from the SAPUI5 delivery in one of the next releases.
Returns:
{sap.viz.ui5.types.Tooltip} Reference to this in order to allow method chaining