Class sap.ui.vbm.HeatmapModule: sap/ui/vbm/Heatmap


Type specific Visual Object aggregation for HeatPoint instances.

Constructor Summary
new sap.ui.vbm.Heatmap(sId?, mSettings?)Constructor for a new Heatmap.
Method Summary
sap.ui.vbm.Heatmap.extend(sClassName, oClassInfo?, FNMetaImpl?)Creates a new subclass of class sap.ui.vbm.Heatmap with name sClassName and enriches it with the information contained in oClassInfo.
sap.ui.vbm.Heatmap.getMetadata()Returns a metadata object for class sap.ui.vbm.Heatmap.
addItem(oItem)Adds some item to the aggregation items.
destroyItems()Destroys all the items in the aggregation items.
getAlphaExponent()Gets current value of property alphaExponent.
getBehavior()Gets current value of property behavior.
getColorExponent()Gets current value of property colorExponent.
getGradient()Gets current value of property gradient.
getItems()Gets content of aggregation items.
getOpacity()Gets current value of property opacity.
getRadiusScale()Gets current value of property radiusScale.
getValueScale()Gets current value of property valueScale.
indexOfItem(oItem)Checks for the provided sap.ui.vbm.HeatPoint in the aggregation items.
insertItem(oItem, iIndex)Inserts a item into the aggregation items.
removeAllItems()Removes all the controls from the aggregation items.
removeItem(vItem)Removes a item from the aggregation items.
setAlphaExponent(sAlphaExponent)Sets a new value for property alphaExponent.
setBehavior(sBehavior)Sets a new value for property behavior.
setColorExponent(sColorExponent)Sets a new value for property colorExponent.
setGradient(sGradient)Sets a new value for property gradient.
setOpacity(sOpacity)Sets a new value for property opacity.
setRadiusScale(sRadiusScale)Sets a new value for property radiusScale.
setValueScale(sValueScale)Sets a new value for property valueScale.
Constructor Detail
new sap.ui.vbm.Heatmap(sId?, mSettings?)
Constructor for a new Heatmap.

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:

Parameters:
{string}sId? id for the new control, generated automatically if no id is given
{object}mSettings? initial settings for the new control
Method Detail
sap.ui.vbm.Heatmap.extend(sClassName, oClassInfo?, FNMetaImpl?): function
Creates a new subclass of class sap.ui.vbm.Heatmap with name sClassName and enriches it with the information contained in oClassInfo.

oClassInfo might contain the same kind of information as described in Object.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.vbm.Heatmap.getMetadata(): sap.ui.base.Metadata
Returns a metadata object for class sap.ui.vbm.Heatmap.
Returns:
{sap.ui.base.Metadata} Metadata object describing this class
addItem(oItem): sap.ui.vbm.Heatmap
Adds some item to the aggregation items.
Parameters:
{sap.ui.vbm.HeatPoint}oItem the item to add; if empty, nothing is inserted
Returns:
{sap.ui.vbm.Heatmap} Reference to this in order to allow method chaining
destroyItems(): sap.ui.vbm.Heatmap
Destroys all the items in the aggregation items.
Returns:
{sap.ui.vbm.Heatmap} Reference to this in order to allow method chaining
getAlphaExponent(): string
Gets current value of property alphaExponent.

Exponent for the alphaChannel
aE = 1 : alpha Channel remains linear
0 < aE < 1 : (e.g. aE=0.5 "square root") sub linear alpha channeling (lower value colors remain longer visible; range appears wider)
aE > 1 (e.g. aE=2: "squared") above linear alpha channeling ( lower value colors remain shortly visible; range appears chopped)

Default value is 1.0.

Returns:
{string} Value of property alphaExponent
getBehavior(): string
Gets current value of property behavior.

Behavior of the HeatPoint, 0 Density Map, 2: Heat Map, 1: Intermediate.

Default value is 2.

Returns:
{string} Value of property behavior
getColorExponent(): string
Gets current value of property colorExponent.

Exponent for the color
aE = 1 : Linear Gradient
0 < aE < 1 : Sublinear Gradient; i.E. with cE=0.5 point values are square rooted before usage [share of lower value cols will decrease]
aE > 1 : Higher Level Gradient; i.E. with cE=2 point values are squared before usage [share of lower value cols will increase]

Default value is 1.0.

Returns:
{string} Value of property colorExponent
getGradient(): array
Gets current value of property gradient.

Gradient Definition. Can be either provided as Ressource - then it is type string.
Or as Array [n0,c0,n1,c1,...,nk,ck] (ni > ni-1; ci respective colors) with an arbitrary number of color stops as in the following
Example: [0,'rgba(0,255,0,1)',220,'rgba(255,255,0,1)',255,'rgba(255,0,0,1)']

Returns:
{array} Value of property gradient
getItems(): sap.ui.vbm.HeatPoint[]
Gets content of aggregation items.

HeatPoint object aggregation

Returns:
{sap.ui.vbm.HeatPoint[]}
getOpacity(): string
Gets current value of property opacity.

Opacity of the heatmap.

Default value is 0.5.

Returns:
{string} Value of property opacity
getRadiusScale(): string
Gets current value of property radiusScale.

Scaling factor for the sample radiuses.

Default value is 1.0.

Returns:
{string} Value of property radiusScale
getValueScale(): string
Gets current value of property valueScale.

Scaling factor for the sample values.

Default value is 1.0.

Returns:
{string} Value of property valueScale
indexOfItem(oItem): int
Checks for the provided sap.ui.vbm.HeatPoint in the aggregation items. and returns its index if found or -1 otherwise.
Parameters:
{sap.ui.vbm.HeatPoint}oItem The item whose index is looked for
Returns:
{int} The index of the provided control in the aggregation if found, or -1 otherwise
insertItem(oItem, iIndex): sap.ui.vbm.Heatmap
Inserts a item into the aggregation items.
Parameters:
{sap.ui.vbm.HeatPoint}oItem the item to insert; if empty, nothing is inserted
{int}iIndex the 0-based index the item should be inserted at; for a negative value of iIndex, the item is inserted at position 0; for a value greater than the current size of the aggregation, the item is inserted at the last position
Returns:
{sap.ui.vbm.Heatmap} Reference to this in order to allow method chaining
removeAllItems(): sap.ui.vbm.HeatPoint[]
Removes all the controls from the aggregation items.

Additionally, it unregisters them from the hosting UIArea.

Returns:
{sap.ui.vbm.HeatPoint[]} An array of the removed elements (might be empty)
removeItem(vItem): sap.ui.vbm.HeatPoint
Removes a item from the aggregation items.
Parameters:
{int|string|sap.ui.vbm.HeatPoint}vItem The itemto remove or its index or id
Returns:
{sap.ui.vbm.HeatPoint} The removed item or null
setAlphaExponent(sAlphaExponent): sap.ui.vbm.Heatmap
Sets a new value for property alphaExponent.

Exponent for the alphaChannel
aE = 1 : alpha Channel remains linear
0 < aE < 1 : (e.g. aE=0.5 "square root") sub linear alpha channeling (lower value colors remain longer visible; range appears wider)
aE > 1 (e.g. aE=2: "squared") above linear alpha channeling ( lower value colors remain shortly visible; range appears chopped)

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

Default value is 1.0.

Parameters:
{string}sAlphaExponent New value for property alphaExponent
Returns:
{sap.ui.vbm.Heatmap} Reference to this in order to allow method chaining
setBehavior(sBehavior): sap.ui.vbm.Heatmap
Sets a new value for property behavior.

Behavior of the HeatPoint, 0 Density Map, 2: Heat Map, 1: Intermediate.

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

Default value is 2.

Parameters:
{string}sBehavior New value for property behavior
Returns:
{sap.ui.vbm.Heatmap} Reference to this in order to allow method chaining
setColorExponent(sColorExponent): sap.ui.vbm.Heatmap
Sets a new value for property colorExponent.

Exponent for the color
aE = 1 : Linear Gradient
0 < aE < 1 : Sublinear Gradient; i.E. with cE=0.5 point values are square rooted before usage [share of lower value cols will decrease]
aE > 1 : Higher Level Gradient; i.E. with cE=2 point values are squared before usage [share of lower value cols will increase]

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

Default value is 1.0.

Parameters:
{string}sColorExponent New value for property colorExponent
Returns:
{sap.ui.vbm.Heatmap} Reference to this in order to allow method chaining
setGradient(sGradient): sap.ui.vbm.Heatmap
Sets a new value for property gradient.

Gradient Definition. Can be either provided as Ressource - then it is type string.
Or as Array [n0,c0,n1,c1,...,nk,ck] (ni > ni-1; ci respective colors) with an arbitrary number of color stops as in the following
Example: [0,'rgba(0,255,0,1)',220,'rgba(255,255,0,1)',255,'rgba(255,0,0,1)']

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

Parameters:
{array}sGradient New value for property gradient
Returns:
{sap.ui.vbm.Heatmap} Reference to this in order to allow method chaining
setOpacity(sOpacity): sap.ui.vbm.Heatmap
Sets a new value for property opacity.

Opacity of the heatmap.

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

Default value is 0.5.

Parameters:
{string}sOpacity New value for property opacity
Returns:
{sap.ui.vbm.Heatmap} Reference to this in order to allow method chaining
setRadiusScale(sRadiusScale): sap.ui.vbm.Heatmap
Sets a new value for property radiusScale.

Scaling factor for the sample radiuses.

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

Default value is 1.0.

Parameters:
{string}sRadiusScale New value for property radiusScale
Returns:
{sap.ui.vbm.Heatmap} Reference to this in order to allow method chaining
setValueScale(sValueScale): sap.ui.vbm.Heatmap
Sets a new value for property valueScale.

Scaling factor for the sample values.

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

Default value is 1.0.

Parameters:
{string}sValueScale New value for property valueScale
Returns:
{sap.ui.vbm.Heatmap} Reference to this in order to allow method chaining