com.smartgwt.client.widgets.chart

Class MetricSettings

java.lang.Object

com.smartgwt.client.core.JsObject

com.smartgwt.client.core.DataClass

com.smartgwt.client.widgets.chart.MetricSettings

All Implemented Interfaces:

com.google.gwt.event.shared.HasHandlers

public class MetricSettings
extends DataClass

Defines a set of properties that are applicable to additional value axes of a FacetChart.

These properties behave identically to the same-named properties of FacetChart. Two exceptions are the properties gradationLineProperties and gradationZeroLineProperties because they are used to draw tick marks along an extra value axis instead of lines through the chart rectangle. Also the default behavior of the dataColors property is different, in that the default is to use unused colors from, and in the order of, the main data colors array.

The extra value axes that are not positioned directly adjacent to the chart rect. of the FacetChart may additionally have an axis line to connect the gradation tick marks. Whether to draw this line is controlled by the showAxisLine property, and the properties of the line are specified using axisLineProperties. The default is to draw the axis lines whenever the chart rect. is drawn and to draw the line using the same properties as the lines of the chart rect. (for example, lineColor and lineWidth).

The extra value axis charts may be single- or multi-facet charts. If the underlying data is multi-facet then the extra value axes may use the facet whose values are labelled on the data axis or the facet used to create the legend (the first and second facets, respectively). Both types of charts vary the first facet to get a data series to plot. Multi-facet charts also vary the second facet, but single-facet charts keep the second facet fixed at a constant FacetValue.

The exact facet value to use for the second facet is specified using the fixedFacetValue property.

Field Summary

Fields inherited from class com.smartgwt.client.core.DataClass

factoryCreated, factoryProperties

Fields inherited from class com.smartgwt.client.core.JsObject

jsObj

Constructor Summary

Constructors

Constructor and Description
MetricSettings()
MetricSettings(com.google.gwt.core.client.JavaScriptObject jsObj)

Method Summary

Modifier and Type	Method and Description
static void	changeAutoChildDefaults(java.lang.String autoChildName, Canvas defaults) Changes the defaults for Canvas AutoChildren named autoChildName.
static void	changeAutoChildDefaults(java.lang.String autoChildName, FormItem defaults) Changes the defaults for FormItem AutoChildren named autoChildName.
DrawLine	getAxisLineProperties() Properties for the axis line drawn if this extra value axis is not positioned directly adjacent to the chart rect.
java.lang.Double	getAxisStartValue() Same as FacetChart.axisStartValue but affects only one metric.
ChartType	getChartType() See ChartType for a list of known types - Column, Bar, Line, Pie, Doughnut, Area, Radar, and Histogram charts are supported.
java.lang.String	getDataColor(int index) See getDataColor(int, java.lang.String, java.lang.String)
java.lang.String	getDataColor(int index, java.util.Date facetValueId, java.lang.String purpose) See getDataColor(int, java.lang.String, java.lang.String)
java.lang.String	getDataColor(int index, java.lang.Double facetValueId, java.lang.String purpose) See getDataColor(int, java.lang.String, java.lang.String)
java.lang.String	getDataColor(int index, java.lang.Integer facetValueId, java.lang.String purpose) See getDataColor(int, java.lang.String, java.lang.String)
java.lang.String	getDataColor(int index, java.lang.String facetValueId, java.lang.String purpose) Get a color from the dataColors Array.
java.lang.String[]	getDataColors() An array of colors to use for a series of visual elements representing data (eg columns, bars, pie slices), any of which may be adjacent to any other.
DrawLine	getDataLineProperties() Properties for lines that show data (as opposed to gradations or borders around the data area).
DrawItem	getDataOutlineProperties() Properties for lines that outline a data shape (in filled charts such as area or radar charts).
DrawItem	getDataPointProperties() Common properties to apply for all data points (see showDataPoints).
int	getDataPointSize() Size in pixels for data points drawn for line, area, radar and other chart types.
DrawPath	getDataShapeProperties() Properties for data shapes (filled areas in area or radar charts).
int	getDecimalPrecision() The FacetChart.decimalPrecision used to render the numeric labels of this metric axis.
java.lang.Boolean	getFilled() Whether shapes are filled, for example, whether a multi-series line chart appears as a stack of filled regions as opposed to just multiple lines.
java.lang.String	getFixedFacetValue() For a single-facet chart of an extra value axis, this property provides a constant facet value for the second facet.
DrawLabel	getGradationLabelProperties() Properties for gradation labels
DrawLine	getGradationLineProperties() Properties for gradation lines
float[]	getGradations() Return an array of the gradation values used in the current chart.
DrawLine	getGradationZeroLineProperties() Properties for the gradation line drawn for zero (slightly thicker by default).
java.lang.String	getLegendLabel() For single-facet charts embedded in a multi-facet main chart, the legendLabel defines the text of the legend label for this chart.
int	getLogBase() When useLogGradations, base value for logarithmic gradation lines.
float[]	getLogGradations() When useLogGradations is set, gradation lines to show in between powers, expressed as a series of integer or float values between 1 and logBase.
java.lang.Boolean	getLogScale() Whether to use logarithmic scaling for values.
java.lang.String	getMatchGradations() When this property is set to the metric of another MetricSettings object, the extra value axis and chart corresponding to these settings will use the same scale for the gradations as the extra value axis and chart of the other MetricSettings object.
java.lang.Integer	getMinDataSpreadPercent() Same as FacetChart.minDataSpreadPercent but affects only one metric.
java.lang.Boolean	getMultiFacet() Whether this extra value axis plots values while varying the facet values of just the first facet (single-facet) or both first and second facets (multi-facet).
static MetricSettings	getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
java.lang.Boolean	getProportional() For multi-facet charts, render data values as a proportion of the sum of all data values that have the same label.
java.lang.String	getProportionalAxisLabel() Default title for the value axis label when the chart is in proportional rendering mode.
DrawOval	getShadowProperties() Properties for shadows.
java.lang.Boolean	getShowAxis() Whether to show the extra value axis.
java.lang.Boolean	getShowAxisLine() Whether to show an axis line for this extra value axis if it is not placed directly adjacent to the chart rect.
java.lang.Boolean	getShowDataPoints() For Line, Area, Radar, Scatter or Bubble charts, whether to show data points for each individual data value.
java.lang.Boolean	getShowDataValues() Deprecated. in favor of FacetChart.showDataValuesMode, a compound setting that supports showing data-values in the chart and in hovers in various combinations. The equivalent to showDataValues:true is ShowDataValuesMode.inChartOnly or ShowDataValuesMode.inChartOrHover if showValueOnHover was also set to true.
java.lang.Boolean	getShowShadows() Whether to automatically show shadows for various charts.
java.lang.Boolean	getShowValueAxisLabel() Whether to show the valueTitle (or, in the case of proportional rendering mode, proportionalAxisLabel) as a label on this extra value axis.
java.lang.Boolean	getShowValueOnHover() Deprecated. in favor of FacetChart.showDataValuesMode, a compound setting that supports showing data-values in the chart and in hovers in various combinations. The equivalent to showValueOnHover:true is ShowDataValuesMode.inHoverOnly.
java.lang.Boolean	getStacked() If the ChartType is "Column" then the metric settings may include a setting for FacetChart.stacked.
java.lang.Boolean	getUseLogGradations() Whether to use classic logarithmic gradations, where each order of magnitude is shown as a gradation as well as a few intervening lines.
DrawLabel	getValueAxisLabelProperties() Properties for labels of value axis.
DrawLine	getValueLineProperties() Properties for a "value line" - a line shows where a particular discrete value is placed, eg, vertical lines connecting points of a line chart to the X axis, or radial lines in a Radar chart.
java.lang.String	getValueTitle() A label for the data values, such as "Sales in Thousands", typically used as the label for the value axis.
java.lang.Double	getXAxisEndValue() Same as FacetChart.xAxisEndValue but affects only one metric.
float	getXCoord(float value) Deprecated. GwtFloatVsDouble
java.lang.Double	getXCoordAsDouble(double value) Returns the X coordinate where the passed data value either was or would be drawn.
float	getYCoord(float value) Deprecated. GwtFloatVsDouble
double	getYCoordAsDouble(double value) Returns the Y coordinate where the passed data value either was or would be drawn.
MetricSettings	setAxisLineProperties(DrawLine axisLineProperties) Properties for the axis line drawn if this extra value axis is not positioned directly adjacent to the chart rect.
MetricSettings	setAxisStartValue(java.lang.Double axisStartValue) Same as FacetChart.axisStartValue but affects only one metric.
void	setAxisValueFormatter(ValueFormatter formatter) Formatter to apply to values displayed in the gradation labels.
MetricSettings	setChartType(ChartType chartType) See ChartType for a list of known types - Column, Bar, Line, Pie, Doughnut, Area, Radar, and Histogram charts are supported.
void	setDataColorMapper(ColorMapper colorMapper) Sets a customizer to redefine what colors are used when rendering the chart data.
MetricSettings	setDataColors(java.lang.String... dataColors) An array of colors to use for a series of visual elements representing data (eg columns, bars, pie slices), any of which may be adjacent to any other.
void	setDataGradientMapper(GradientMapper gradientMapper) Sets a customizer to redefine what gradients are used when rendering the chart data.
void	setDataLineColorMapper(ColorMapper colorMapper) Sets a customizer to redefine what colors are used when rendering lines for the chart data.
MetricSettings	setDataLineProperties(DrawLine dataLineProperties) Properties for lines that show data (as opposed to gradations or borders around the data area).
MetricSettings	setDataOutlineProperties(DrawItem dataOutlineProperties) Properties for lines that outline a data shape (in filled charts such as area or radar charts).
MetricSettings	setDataPointProperties(DrawItem dataPointProperties) Common properties to apply for all data points (see showDataPoints).
MetricSettings	setDataPointSize(int dataPointSize) Size in pixels for data points drawn for line, area, radar and other chart types.
MetricSettings	setDataShapeProperties(DrawPath dataShapeProperties) Properties for data shapes (filled areas in area or radar charts).
void	setDataValueFormatter(ValueFormatter formatter) Formatter to apply to values displayed in the hover labels and other value labels
MetricSettings	setDecimalPrecision(int decimalPrecision) The FacetChart.decimalPrecision used to render the numeric labels of this metric axis.
MetricSettings	setFilled(java.lang.Boolean filled) Whether shapes are filled, for example, whether a multi-series line chart appears as a stack of filled regions as opposed to just multiple lines.
MetricSettings	setFixedFacetValue(java.lang.Integer fixedFacetValue) For a single-facet chart of an extra value axis, this property provides a constant facet value for the second facet.
MetricSettings	setFixedFacetValue(java.lang.String fixedFacetValue) For a single-facet chart of an extra value axis, this property provides a constant facet value for the second facet.
MetricSettings	setGradationLabelProperties(DrawLabel gradationLabelProperties) Properties for gradation labels
MetricSettings	setGradationLineProperties(DrawLine gradationLineProperties) Properties for gradation lines
MetricSettings	setGradationZeroLineProperties(DrawLine gradationZeroLineProperties) Properties for the gradation line drawn for zero (slightly thicker by default).
MetricSettings	setLegendLabel(java.lang.String legendLabel) For single-facet charts embedded in a multi-facet main chart, the legendLabel defines the text of the legend label for this chart.
MetricSettings	setLogBase(int logBase) When useLogGradations, base value for logarithmic gradation lines.
MetricSettings	setLogGradations(float... logGradations) When useLogGradations is set, gradation lines to show in between powers, expressed as a series of integer or float values between 1 and logBase.
MetricSettings	setLogScale(java.lang.Boolean logScale) Whether to use logarithmic scaling for values.
MetricSettings	setMatchGradations(java.lang.String matchGradations) When this property is set to the metric of another MetricSettings object, the extra value axis and chart corresponding to these settings will use the same scale for the gradations as the extra value axis and chart of the other MetricSettings object.
MetricSettings	setMinDataSpreadPercent(java.lang.Integer minDataSpreadPercent) Same as FacetChart.minDataSpreadPercent but affects only one metric.
MetricSettings	setMultiFacet(java.lang.Boolean multiFacet) Whether this extra value axis plots values while varying the facet values of just the first facet (single-facet) or both first and second facets (multi-facet).
void	setPointClickHandler(ChartPointClickHandler handler) Apply a handler to fire when showDataPoints is true, and the user clicks on a point.
void	setPointHoverCustomizer(ChartPointHoverCustomizer hoverCustomizer) Display custom HTML when showDataPoints is true and the mouse hovers over a point.
MetricSettings	setProportional(java.lang.Boolean proportional) For multi-facet charts, render data values as a proportion of the sum of all data values that have the same label.
MetricSettings	setProportionalAxisLabel(java.lang.String proportionalAxisLabel) Default title for the value axis label when the chart is in proportional rendering mode.
MetricSettings	setShadowProperties(DrawOval shadowProperties) Properties for shadows.
MetricSettings	setShowAxis(java.lang.Boolean showAxis) Whether to show the extra value axis.
MetricSettings	setShowAxisLine(java.lang.Boolean showAxisLine) Whether to show an axis line for this extra value axis if it is not placed directly adjacent to the chart rect.
MetricSettings	setShowDataPoints(java.lang.Boolean showDataPoints) For Line, Area, Radar, Scatter or Bubble charts, whether to show data points for each individual data value.
MetricSettings	setShowDataValues(java.lang.Boolean showDataValues) Deprecated. in favor of FacetChart.showDataValuesMode, a compound setting that supports showing data-values in the chart and in hovers in various combinations. The equivalent to showDataValues:true is ShowDataValuesMode.inChartOnly or ShowDataValuesMode.inChartOrHover if showValueOnHover was also set to true.
MetricSettings	setShowShadows(java.lang.Boolean showShadows) Whether to automatically show shadows for various charts.
MetricSettings	setShowValueAxisLabel(java.lang.Boolean showValueAxisLabel) Whether to show the valueTitle (or, in the case of proportional rendering mode, proportionalAxisLabel) as a label on this extra value axis.
MetricSettings	setShowValueOnHover(java.lang.Boolean showValueOnHover) Deprecated. in favor of FacetChart.showDataValuesMode, a compound setting that supports showing data-values in the chart and in hovers in various combinations. The equivalent to showValueOnHover:true is ShowDataValuesMode.inHoverOnly.
MetricSettings	setStacked(java.lang.Boolean stacked) If the ChartType is "Column" then the metric settings may include a setting for FacetChart.stacked.
MetricSettings	setUseLogGradations(java.lang.Boolean useLogGradations) Whether to use classic logarithmic gradations, where each order of magnitude is shown as a gradation as well as a few intervening lines.
MetricSettings	setValueAxisLabelProperties(DrawLabel valueAxisLabelProperties) Properties for labels of value axis.
MetricSettings	setValueLineProperties(DrawLine valueLineProperties) Properties for a "value line" - a line shows where a particular discrete value is placed, eg, vertical lines connecting points of a line chart to the X axis, or radial lines in a Radar chart.
MetricSettings	setValueTitle(java.lang.String valueTitle) A label for the data values, such as "Sales in Thousands", typically used as the label for the value axis.
MetricSettings	setXAxisEndValue(java.lang.Double xAxisEndValue) Same as FacetChart.xAxisEndValue but affects only one metric.

Methods inherited from class com.smartgwt.client.core.DataClass

applyFactoryProperties, doAddHandler, fireEvent, getAttribute, getAttributeAsBoolean, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsDoubleArray, getAttributeAsFloat, getAttributeAsInt, getAttributeAsIntArray, getAttributeAsJavaScriptObject, getAttributeAsLong, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsString, getAttributeAsStringArray, getAttributes, getHandlerCount, isFactoryCreated, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttributeAsJavaObject, setFactoryCreated

Methods inherited from class com.smartgwt.client.core.JsObject

equals, getJsObj, hashCode, isCreated, setJavaScriptObject, setJsObj

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MetricSettings

public MetricSettings()

MetricSettings

public MetricSettings(com.google.gwt.core.client.JavaScriptObject jsObj)

Method Detail

getOrCreateRef

public static MetricSettings getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)

changeAutoChildDefaults

public static void changeAutoChildDefaults(java.lang.String autoChildName,
                                           Canvas defaults)

Changes the defaults for Canvas AutoChildren named autoChildName.

Parameters:

autoChildName - name of an AutoChild to customize the defaults for.

defaults - Canvas defaults to apply. These defaults override any existing properties without destroying or wiping out non-overridden properties. For usage tips on this param, see SGWTProperties.

See Also:

AutoChildUsage

changeAutoChildDefaults

public static void changeAutoChildDefaults(java.lang.String autoChildName,
                                           FormItem defaults)

Changes the defaults for FormItem AutoChildren named autoChildName.

Parameters:

autoChildName - name of an AutoChild to customize the defaults for.

defaults - FormItem defaults to apply. These defaults override any existing properties without destroying or wiping out non-overridden properties. For usage tips on this param, see SGWTProperties.

See Also:

AutoChildUsage

setAxisLineProperties

public MetricSettings setAxisLineProperties(DrawLine axisLineProperties)

Properties for the axis line drawn if this extra value axis is not positioned directly adjacent to the chart rect. The default is to match the lineCap, lineColor, lineOpacity, linePattern, and lineWidth of the FacetChart's chart rect. for each axis line.

Parameters:

axisLineProperties - New axisLineProperties value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

SGWTProperties

getAxisLineProperties

public DrawLine getAxisLineProperties()

Properties for the axis line drawn if this extra value axis is not positioned directly adjacent to the chart rect. The default is to match the lineCap, lineColor, lineOpacity, linePattern, and lineWidth of the FacetChart's chart rect. for each axis line.

Returns:

Current axisLineProperties value. Default value is null

setAxisStartValue

public MetricSettings setAxisStartValue(java.lang.Double axisStartValue)

Same as FacetChart.axisStartValue but affects only one metric.

Parameters:

axisStartValue - New axisStartValue value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getAxisStartValue

public java.lang.Double getAxisStartValue()

Same as FacetChart.axisStartValue but affects only one metric.

Returns:

Current axisStartValue value. Default value is null

setChartType

public MetricSettings setChartType(ChartType chartType)

See ChartType for a list of known types - Column, Bar, Line, Pie, Doughnut, Area, Radar, and Histogram charts are supported.

If this method is called after the component has been drawn/initialized: Method to change the current chartType. Will redraw the chart if drawn. Will use default settings for the new chart type for stacked and filled if those values are null.

Note that for multi-axis charts this method changes the chartType for the main value axis only.

Parameters:

chartType - new chart type. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getChartType

public ChartType getChartType()

See ChartType for a list of known types - Column, Bar, Line, Pie, Doughnut, Area, Radar, and Histogram charts are supported.

Returns:

Current chartType value. Default value is null

setDataColors

public MetricSettings setDataColors(java.lang.String... dataColors)

An array of colors to use for a series of visual elements representing data (eg columns, bars, pie slices), any of which may be adjacent to any other.

Colors must be in the format of a leading hash (#) plus 6 hexadecimal digits, for example, "#FFFFFF" is white, "#FF0000" is pure red.

If this method is called after the component has been drawn/initialized: Setter for dataColors.

Parameters:

dataColors - New set of data colors. Default value is see below

Returns:

MetricSettings instance, for chaining setter calls

See Also:

CSSColor

getDataColors

public java.lang.String[] getDataColors()

An array of colors to use for a series of visual elements representing data (eg columns, bars, pie slices), any of which may be adjacent to any other.

Colors must be in the format of a leading hash (#) plus 6 hexadecimal digits, for example, "#FFFFFF" is white, "#FF0000" is pure red.

Returns:

Current dataColors value. Default value is see below

See Also:

CSSColor

setDataLineProperties

public MetricSettings setDataLineProperties(DrawLine dataLineProperties)

Properties for lines that show data (as opposed to gradations or borders around the data area).

Parameters:

dataLineProperties - New dataLineProperties value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

SGWTProperties

getDataLineProperties

public DrawLine getDataLineProperties()

Properties for lines that show data (as opposed to gradations or borders around the data area).

Returns:

Current dataLineProperties value. Default value is null

setDataOutlineProperties

public MetricSettings setDataOutlineProperties(DrawItem dataOutlineProperties)

Properties for lines that outline a data shape (in filled charts such as area or radar charts).

Parameters:

dataOutlineProperties - New dataOutlineProperties value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

SGWTProperties

getDataOutlineProperties

public DrawItem getDataOutlineProperties()

Properties for lines that outline a data shape (in filled charts such as area or radar charts).

Returns:

Current dataOutlineProperties value. Default value is null

setDataPointProperties

public MetricSettings setDataPointProperties(DrawItem dataPointProperties)

Common properties to apply for all data points (see showDataPoints).

Parameters:

dataPointProperties - New dataPointProperties value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

SGWTProperties

getDataPointProperties

public DrawItem getDataPointProperties()

Common properties to apply for all data points (see showDataPoints).

Returns:

Current dataPointProperties value. Default value is null

setDataPointSize

public MetricSettings setDataPointSize(int dataPointSize)

Size in pixels for data points drawn for line, area, radar and other chart types.

Parameters:

dataPointSize - New dataPointSize value. Default value is 6

Returns:

MetricSettings instance, for chaining setter calls

getDataPointSize

public int getDataPointSize()

Size in pixels for data points drawn for line, area, radar and other chart types.

Returns:

Current dataPointSize value. Default value is 6

setDataShapeProperties

public MetricSettings setDataShapeProperties(DrawPath dataShapeProperties)

Properties for data shapes (filled areas in area or radar charts).

Parameters:

dataShapeProperties - New dataShapeProperties value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

SGWTProperties

getDataShapeProperties

public DrawPath getDataShapeProperties()

Properties for data shapes (filled areas in area or radar charts).

Returns:

Current dataShapeProperties value. Default value is null

setDecimalPrecision

public MetricSettings setDecimalPrecision(int decimalPrecision)

The FacetChart.decimalPrecision used to render the numeric labels of this metric axis.

Parameters:

decimalPrecision - New decimalPrecision value. Default value is 2

Returns:

MetricSettings instance, for chaining setter calls

getDecimalPrecision

public int getDecimalPrecision()

The FacetChart.decimalPrecision used to render the numeric labels of this metric axis.

Returns:

Current decimalPrecision value. Default value is 2

setFilled

public MetricSettings setFilled(java.lang.Boolean filled)

Whether shapes are filled, for example, whether a multi-series line chart appears as a stack of filled regions as opposed to just multiple lines.

If unset, fills will be automatically used when there are multiple facets and stacking is active (so Line and Radar charts will show stacked regions).

You can explicitly set filled:false to create multi-facet Line or Radar charts where translucent regions overlap, or filled:true to fill in a single-facet Line or Radar chart.

If this method is called after the component has been drawn/initialized: Method to change filled. Use null to apply a default value for the current chartType.

Parameters:

filled - new value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getFilled

public java.lang.Boolean getFilled()

Whether shapes are filled, for example, whether a multi-series line chart appears as a stack of filled regions as opposed to just multiple lines.

If unset, fills will be automatically used when there are multiple facets and stacking is active (so Line and Radar charts will show stacked regions).

You can explicitly set filled:false to create multi-facet Line or Radar charts where translucent regions overlap, or filled:true to fill in a single-facet Line or Radar chart.

Returns:

Current filled value. Default value is null

setFixedFacetValue

public MetricSettings setFixedFacetValue(java.lang.String fixedFacetValue)

For a single-facet chart of an extra value axis, this property provides a constant facet value for the second facet. By varying the value of the other facet in multi-facet data, the chart obtains the series of values to plot. The default facet value is the first facet value of the second facet.

Parameters:

fixedFacetValue - New fixedFacetValue value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getFixedFacetValue

public java.lang.String getFixedFacetValue()

For a single-facet chart of an extra value axis, this property provides a constant facet value for the second facet. By varying the value of the other facet in multi-facet data, the chart obtains the series of values to plot. The default facet value is the first facet value of the second facet.

Returns:

Current fixedFacetValue value. Default value is null

setFixedFacetValue

public MetricSettings setFixedFacetValue(java.lang.Integer fixedFacetValue)

For a single-facet chart of an extra value axis, this property provides a constant facet value for the second facet. By varying the value of the other facet in multi-facet data, the chart obtains the series of values to plot. The default facet value is the first facet value of the second facet.

Parameters:

fixedFacetValue - New fixedFacetValue value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

setGradationLabelProperties

public MetricSettings setGradationLabelProperties(DrawLabel gradationLabelProperties)

Properties for gradation labels

Parameters:

gradationLabelProperties - New gradationLabelProperties value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

SGWTProperties

getGradationLabelProperties

public DrawLabel getGradationLabelProperties()

Properties for gradation labels

Returns:

Current gradationLabelProperties value. Default value is null

setGradationLineProperties

public MetricSettings setGradationLineProperties(DrawLine gradationLineProperties)

Properties for gradation lines

Parameters:

gradationLineProperties - New gradationLineProperties value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

SGWTProperties

getGradationLineProperties

public DrawLine getGradationLineProperties()

Properties for gradation lines

Returns:

Current gradationLineProperties value. Default value is null

setGradationZeroLineProperties

public MetricSettings setGradationZeroLineProperties(DrawLine gradationZeroLineProperties)

Properties for the gradation line drawn for zero (slightly thicker by default).

Parameters:

gradationZeroLineProperties - New gradationZeroLineProperties value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

SGWTProperties

getGradationZeroLineProperties

public DrawLine getGradationZeroLineProperties()

Properties for the gradation line drawn for zero (slightly thicker by default).

Returns:

Current gradationZeroLineProperties value. Default value is null

setLegendLabel

public MetricSettings setLegendLabel(java.lang.String legendLabel)

For single-facet charts embedded in a multi-facet main chart, the legendLabel defines the text of the legend label for this chart. The default text is the title of the metric facet value of this value axis concatenated with the title of the fixed facet value in parentheses. Set the legendLabel to provide custom text for the legend label.

Parameters:

legendLabel - New legendLabel value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getLegendLabel

public java.lang.String getLegendLabel()

For single-facet charts embedded in a multi-facet main chart, the legendLabel defines the text of the legend label for this chart. The default text is the title of the metric facet value of this value axis concatenated with the title of the fixed facet value in parentheses. Set the legendLabel to provide custom text for the legend label.

Returns:

Current legendLabel value. Default value is null

setLogBase

public MetricSettings setLogBase(int logBase)

When useLogGradations, base value for logarithmic gradation lines. Gradation lines will be shown at every power of this value plus intervening values specified by logGradations.

Parameters:

logBase - New logBase value. Default value is 10

Returns:

MetricSettings instance, for chaining setter calls

getLogBase

public int getLogBase()

When useLogGradations, base value for logarithmic gradation lines. Gradation lines will be shown at every power of this value plus intervening values specified by logGradations.

Returns:

Current logBase value. Default value is 10

setLogGradations

public MetricSettings setLogGradations(float... logGradations)

When useLogGradations is set, gradation lines to show in between powers, expressed as a series of integer or float values between 1 and logBase.

Some common possibilities (for base 10):

     [ 1 ] // show only orders of magnitude (0.1, 1, 10, 100, etc)
     [ 1, 5 ] // show only orders of magnitude plus halfway mark
     [ 1, 2, 4, 8 ] // show powers of 2 between orders
     [ 1, 2.5, 5, 7.5 ] // show quarters
  

Or base 2:

     [ 1 ]
     [ 1, 1.5 ]
  

Parameters:

logGradations - New logGradations value. Default value is [ 1,2,4,6,8 ]

Returns:

MetricSettings instance, for chaining setter calls

getLogGradations

public float[] getLogGradations()

When useLogGradations is set, gradation lines to show in between powers, expressed as a series of integer or float values between 1 and logBase.

Some common possibilities (for base 10):

     [ 1 ] // show only orders of magnitude (0.1, 1, 10, 100, etc)
     [ 1, 5 ] // show only orders of magnitude plus halfway mark
     [ 1, 2, 4, 8 ] // show powers of 2 between orders
     [ 1, 2.5, 5, 7.5 ] // show quarters
  

Or base 2:

     [ 1 ]
     [ 1, 1.5 ]
  

Returns:

Current logGradations value. Default value is [ 1,2,4,6,8 ]

setLogScale

public MetricSettings setLogScale(java.lang.Boolean logScale)

Whether to use logarithmic scaling for values.

Logarithmic scale charts show an equivalent percentage increase as equivalent distance on the chart. That is, 10 and 100 are the same distance apart as 100 and 1000 (each being a 10 times or 1000% increase).

Parameters:

logScale - New logScale value. Default value is false

Returns:

MetricSettings instance, for chaining setter calls

getLogScale

public java.lang.Boolean getLogScale()

Whether to use logarithmic scaling for values.

Logarithmic scale charts show an equivalent percentage increase as equivalent distance on the chart. That is, 10 and 100 are the same distance apart as 100 and 1000 (each being a 10 times or 1000% increase).

Returns:

Current logScale value. Default value is false

setMatchGradations

public MetricSettings setMatchGradations(java.lang.String matchGradations)

When this property is set to the metric of another MetricSettings object, the extra value axis and chart corresponding to these settings will use the same scale for the gradations as the extra value axis and chart of the other MetricSettings object. The value of matchGradations can only be one of the metrics of the metric facet whose values will be displayed by the chart.

Parameters:

matchGradations - New matchGradations value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

FacetChart.setExtraAxisMetrics(java.lang.String...)

getMatchGradations

public java.lang.String getMatchGradations()

When this property is set to the metric of another MetricSettings object, the extra value axis and chart corresponding to these settings will use the same scale for the gradations as the extra value axis and chart of the other MetricSettings object. The value of matchGradations can only be one of the metrics of the metric facet whose values will be displayed by the chart.

Returns:

Current matchGradations value. Default value is null

See Also:

FacetChart.getExtraAxisMetrics()

setMinDataSpreadPercent

public MetricSettings setMinDataSpreadPercent(java.lang.Integer minDataSpreadPercent)

Same as FacetChart.minDataSpreadPercent but affects only one metric. Default of null means that the chart-wide setting facetChart.minDataSpreadPercent will be used.

Parameters:

minDataSpreadPercent - New minDataSpreadPercent value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getMinDataSpreadPercent

public java.lang.Integer getMinDataSpreadPercent()

Same as FacetChart.minDataSpreadPercent but affects only one metric. Default of null means that the chart-wide setting facetChart.minDataSpreadPercent will be used.

Returns:

Current minDataSpreadPercent value. Default value is null

setMultiFacet

public MetricSettings setMultiFacet(java.lang.Boolean multiFacet)

Whether this extra value axis plots values while varying the facet values of just the first facet (single-facet) or both first and second facets (multi-facet).

Parameters:

multiFacet - New multiFacet value. Default value is true

Returns:

MetricSettings instance, for chaining setter calls

getMultiFacet

public java.lang.Boolean getMultiFacet()

Whether this extra value axis plots values while varying the facet values of just the first facet (single-facet) or both first and second facets (multi-facet).

Returns:

Current multiFacet value. Default value is true

setProportional

public MetricSettings setProportional(java.lang.Boolean proportional)

For multi-facet charts, render data values as a proportion of the sum of all data values that have the same label.

Gradation labels will be switched to show percentage instead of absolute values.

This setting is valid only for Column, Bar, Area and Radar chart types and only in stacked mode. Stacked columns will be as tall as the chart rect and stacked bars will be as wide as the chart rect. Area and Radar charts will be completely filled except for facet values where all values are 0.

If this method is called after the component has been drawn/initialized: Setter for proportional.

Parameters:

proportional - Whether the chart should now use proportional mode. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

Multi-Series Chart Example

getProportional

public java.lang.Boolean getProportional()

For multi-facet charts, render data values as a proportion of the sum of all data values that have the same label.

Gradation labels will be switched to show percentage instead of absolute values.

This setting is valid only for Column, Bar, Area and Radar chart types and only in stacked mode. Stacked columns will be as tall as the chart rect and stacked bars will be as wide as the chart rect. Area and Radar charts will be completely filled except for facet values where all values are 0.

Returns:

Current proportional value. Default value is null

See Also:

Multi-Series Chart Example

setProportionalAxisLabel

public MetricSettings setProportionalAxisLabel(java.lang.String proportionalAxisLabel)

Default title for the value axis label when the chart is in proportional rendering mode. This title will be used unless the legend facet defines a proportionalTitle.

Parameters:

proportionalAxisLabel - New proportionalAxisLabel value. Default value is "Percent"

Returns:

MetricSettings instance, for chaining setter calls

getProportionalAxisLabel

public java.lang.String getProportionalAxisLabel()

Default title for the value axis label when the chart is in proportional rendering mode. This title will be used unless the legend facet defines a proportionalTitle.

Returns:

Current proportionalAxisLabel value. Default value is "Percent"

setShadowProperties

public MetricSettings setShadowProperties(DrawOval shadowProperties)

Properties for shadows.

Parameters:

shadowProperties - New shadowProperties value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

SGWTProperties

getShadowProperties

public DrawOval getShadowProperties()

Properties for shadows.

Returns:

Current shadowProperties value. Default value is null

setShowAxis

public MetricSettings setShowAxis(java.lang.Boolean showAxis)

Whether to show the extra value axis.

Parameters:

showAxis - New showAxis value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getShowAxis

public java.lang.Boolean getShowAxis()

Whether to show the extra value axis.

Returns:

Current showAxis value. Default value is null

setShowAxisLine

public MetricSettings setShowAxisLine(java.lang.Boolean showAxisLine)

Whether to show an axis line for this extra value axis if it is not placed directly adjacent to the chart rect. The default setting is the value of the showChartRect property of the FacetChart.

Parameters:

showAxisLine - New showAxisLine value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getShowAxisLine

public java.lang.Boolean getShowAxisLine()

Whether to show an axis line for this extra value axis if it is not placed directly adjacent to the chart rect. The default setting is the value of the showChartRect property of the FacetChart.

Returns:

Current showAxisLine value. Default value is null

setShowDataPoints

public MetricSettings setShowDataPoints(java.lang.Boolean showDataPoints)

For Line, Area, Radar, Scatter or Bubble charts, whether to show data points for each individual data value.

If shown, the pointClick() and getPointHoverHTML() APIs can be used to create interactivity.

Parameters:

showDataPoints - New showDataPoints value. Default value is false

Returns:

MetricSettings instance, for chaining setter calls

getShowDataPoints

public java.lang.Boolean getShowDataPoints()

For Line, Area, Radar, Scatter or Bubble charts, whether to show data points for each individual data value.

If shown, the pointClick() and getPointHoverHTML() APIs can be used to create interactivity.

Returns:

Current showDataPoints value. Default value is false

setShowDataValues

public MetricSettings setShowDataValues(java.lang.Boolean showDataValues)

Deprecated. in favor of FacetChart.showDataValuesMode, a compound setting that supports showing data-values in the chart and in hovers in various combinations. The equivalent to showDataValues:true is ShowDataValuesMode.inChartOnly or ShowDataValuesMode.inChartOrHover if showValueOnHover was also set to true.

Should data values be shown as text labels near the shape representing the value, for example, above columns of a column chart, or adjacent to points in a line chart?

If set to false, then data values will not be shown.

If set to true, data values will be shown unless the data density is high enough that labels will potentially overlap, in which case, data values will not be shown and hovers will be shown instead, in the same way as showValueOnHover shows hovers.

Parameters:

showDataValues - New showDataValues value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getShowDataValues

public java.lang.Boolean getShowDataValues()

Deprecated. in favor of FacetChart.showDataValuesMode, a compound setting that supports showing data-values in the chart and in hovers in various combinations. The equivalent to showDataValues:true is ShowDataValuesMode.inChartOnly or ShowDataValuesMode.inChartOrHover if showValueOnHover was also set to true.

Should data values be shown as text labels near the shape representing the value, for example, above columns of a column chart, or adjacent to points in a line chart?

If set to false, then data values will not be shown.

If set to true, data values will be shown unless the data density is high enough that labels will potentially overlap, in which case, data values will not be shown and hovers will be shown instead, in the same way as showValueOnHover shows hovers.

Returns:

Current showDataValues value. Default value is null

setShowShadows

public MetricSettings setShowShadows(java.lang.Boolean showShadows)

Whether to automatically show shadows for various charts.

Parameters:

showShadows - New showShadows value. Default value is true

Returns:

MetricSettings instance, for chaining setter calls

getShowShadows

public java.lang.Boolean getShowShadows()

Whether to automatically show shadows for various charts.

Returns:

Current showShadows value. Default value is true

setShowValueAxisLabel

public MetricSettings setShowValueAxisLabel(java.lang.Boolean showValueAxisLabel)

Whether to show the valueTitle (or, in the case of proportional rendering mode, proportionalAxisLabel) as a label on this extra value axis.

Parameters:

showValueAxisLabel - New showValueAxisLabel value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getShowValueAxisLabel

public java.lang.Boolean getShowValueAxisLabel()

Whether to show the valueTitle (or, in the case of proportional rendering mode, proportionalAxisLabel) as a label on this extra value axis.

Returns:

Current showValueAxisLabel value. Default value is null

setShowValueOnHover

public MetricSettings setShowValueOnHover(java.lang.Boolean showValueOnHover)

Deprecated. in favor of FacetChart.showDataValuesMode, a compound setting that supports showing data-values in the chart and in hovers in various combinations. The equivalent to showValueOnHover:true is ShowDataValuesMode.inHoverOnly.

Shows the value of the nearest data value in a floating label whenever the mouse moves within the main chart area. The visual element representing the data value will also be emphasized by brightening or highlighting it (appearance differs by chart type).

Calculates nearest value based on FacetChart.getNearestDrawnValue().

The data value will be formatted using FacetChart.setDataValueFormatter(). The label's appearance is controlled by FacetChart.hoverLabelProperties.

Parameters:

showValueOnHover - New showValueOnHover value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getShowValueOnHover

public java.lang.Boolean getShowValueOnHover()

Deprecated. in favor of FacetChart.showDataValuesMode, a compound setting that supports showing data-values in the chart and in hovers in various combinations. The equivalent to showValueOnHover:true is ShowDataValuesMode.inHoverOnly.

Shows the value of the nearest data value in a floating label whenever the mouse moves within the main chart area. The visual element representing the data value will also be emphasized by brightening or highlighting it (appearance differs by chart type).

Calculates nearest value based on FacetChart.getNearestDrawnValue().

The data value will be formatted using FacetChart.setDataValueFormatter(). The label's appearance is controlled by FacetChart.hoverLabelProperties.

Returns:

Current showValueOnHover value. Default value is null

setStacked

public MetricSettings setStacked(java.lang.Boolean stacked)

If the ChartType is "Column" then the metric settings may include a setting for FacetChart.stacked.

If this method is called after the component has been drawn/initialized: Method to change stacked. Use null to apply a default value for the current chartType.

Parameters:

stacked - new value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getStacked

public java.lang.Boolean getStacked()

If the ChartType is "Column" then the metric settings may include a setting for FacetChart.stacked.

Returns:

Current stacked value. Default value is null

setUseLogGradations

public MetricSettings setUseLogGradations(java.lang.Boolean useLogGradations)

Whether to use classic logarithmic gradations, where each order of magnitude is shown as a gradation as well as a few intervening lines. Gradations also begin and end on an order of magnitude. For example, 1,2,4,6,8,10,20,40,60,80,100.

Default gradations can be overridden via logBase and logGradations.

Parameters:

useLogGradations - New useLogGradations value. Default value is false

Returns:

MetricSettings instance, for chaining setter calls

getUseLogGradations

public java.lang.Boolean getUseLogGradations()

Whether to use classic logarithmic gradations, where each order of magnitude is shown as a gradation as well as a few intervening lines. Gradations also begin and end on an order of magnitude. For example, 1,2,4,6,8,10,20,40,60,80,100.

Default gradations can be overridden via logBase and logGradations.

Returns:

Current useLogGradations value. Default value is false

setValueAxisLabelProperties

public MetricSettings setValueAxisLabelProperties(DrawLabel valueAxisLabelProperties)

Properties for labels of value axis.

Parameters:

valueAxisLabelProperties - New valueAxisLabelProperties value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

SGWTProperties

getValueAxisLabelProperties

public DrawLabel getValueAxisLabelProperties()

Properties for labels of value axis.

Returns:

Current valueAxisLabelProperties value. Default value is null

setValueLineProperties

public MetricSettings setValueLineProperties(DrawLine valueLineProperties)

Properties for a "value line" - a line shows where a particular discrete value is placed, eg, vertical lines connecting points of a line chart to the X axis, or radial lines in a Radar chart.

Parameters:

valueLineProperties - New valueLineProperties value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

See Also:

SGWTProperties

getValueLineProperties

public DrawLine getValueLineProperties()

Properties for a "value line" - a line shows where a particular discrete value is placed, eg, vertical lines connecting points of a line chart to the X axis, or radial lines in a Radar chart.

Returns:

Current valueLineProperties value. Default value is null

setValueTitle

public MetricSettings setValueTitle(java.lang.String valueTitle)

A label for the data values, such as "Sales in Thousands", typically used as the label for the value axis.

Parameters:

valueTitle - New valueTitle value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getValueTitle

public java.lang.String getValueTitle()

A label for the data values, such as "Sales in Thousands", typically used as the label for the value axis.

Returns:

Current valueTitle value. Default value is null

setXAxisEndValue

public MetricSettings setXAxisEndValue(java.lang.Double xAxisEndValue)

Same as FacetChart.xAxisEndValue but affects only one metric.

Parameters:

xAxisEndValue - New xAxisEndValue value. Default value is null

Returns:

MetricSettings instance, for chaining setter calls

getXAxisEndValue

public java.lang.Double getXAxisEndValue()

Same as FacetChart.xAxisEndValue but affects only one metric.

Returns:

Current xAxisEndValue value. Default value is null

getGradations

public float[] getGradations()

Return an array of the gradation values used in the current chart. Pass these values to getXCoord() / getYCoord() (depending on the orientation of the chart) to discover the coordinates where gradations are drawn.

This is only allowed to be called when FacetChart.chartDrawn() fires.

Returns:

an array of gradation values used in the current chart.

getXCoord

public float getXCoord(float value)

Deprecated. GwtFloatVsDouble

Returns the X coordinate where the passed data value either was or would be drawn. For example, this would be the X coordinate where a bar would end in a bar chart.

This is only allowed to be called after FacetChart.chartDrawn() fires.

If the chartType is ChartType.BAR, ChartType.BUBBLE, or ChartType.SCATTER then the value argument should be a number. For other rectangular charts, this method expects a FacetValueMap that uniquely identifies the data cell whose X-axis coordinate is to be retrieved.

Note that when canZoom is enabled, this API is valid only for data values between zoomStartValue and zoomEndValue.

Parameters:

value - the value to be drawn.

Returns:

the X coordinate where the passed data value would be drawn; or null if the passed FacetValueMap does not identify a currently-drawn data cell.

getXCoordAsDouble

public java.lang.Double getXCoordAsDouble(double value)

Returns the X coordinate where the passed data value either was or would be drawn. For example, this would be the X coordinate where a bar would end in a bar chart.

This is only allowed to be called after FacetChart.chartDrawn() fires.

If the chartType is ChartType.BAR, ChartType.BUBBLE, or ChartType.SCATTER then the value argument should be a number. For other rectangular charts, this method expects a FacetValueMap that uniquely identifies the data cell whose X-axis coordinate is to be retrieved.

Note that when canZoom is enabled, this API is valid only for data values between zoomStartValue and zoomEndValue.

Parameters:

value - the value to be drawn.

Returns:

the X coordinate where the passed data value would be drawn; or null if the passed FacetValueMap does not identify a currently-drawn data cell.

getYCoord

public float getYCoord(float value)

Deprecated. GwtFloatVsDouble

Returns the Y coordinate where the passed data value either was or would be drawn. For example, this would be the Y coordinate that a line would pass through on a line chart, or the top of a column on a column chart.

This is only allowed to be called after FacetChart.chartDrawn() fires.

If the chartType is ChartType.AREA, ChartType.BUBBLE, ChartType.COLUMN, ChartType.HISTOGRAM, ChartType.LINE, or ChartType.SCATTER then the value argument should be a number. For ChartType.BAR charts this method expects a FacetValueMap that uniquely identifies the data cell whose Y-axis coordinate is to be retrieved.

Parameters:

value - the value to be drawn.

Returns:

the Y coordinate where the passed data value would be drawn.

getYCoordAsDouble

public double getYCoordAsDouble(double value)

Returns the Y coordinate where the passed data value either was or would be drawn. For example, this would be the Y coordinate that a line would pass through on a line chart, or the top of a column on a column chart.

This is only allowed to be called after FacetChart.chartDrawn() fires.

If the chartType is ChartType.AREA, ChartType.BUBBLE, ChartType.COLUMN, ChartType.HISTOGRAM, ChartType.LINE, or ChartType.SCATTER then the value argument should be a number. For ChartType.BAR charts this method expects a FacetValueMap that uniquely identifies the data cell whose Y-axis coordinate is to be retrieved.

Parameters:

value - the value to be drawn.

Returns:

the Y coordinate where the passed data value would be drawn.

setPointHoverCustomizer

public void setPointHoverCustomizer(ChartPointHoverCustomizer hoverCustomizer)

Display custom HTML when showDataPoints is true and the mouse hovers over a point.

Parameters:

hoverCustomizer -

setPointClickHandler

public void setPointClickHandler(ChartPointClickHandler handler)

Apply a handler to fire when showDataPoints is true, and the user clicks on a point.

Parameters:

handler -

setAxisValueFormatter

public void setAxisValueFormatter(ValueFormatter formatter)

Formatter to apply to values displayed in the gradation labels.

Parameters:

formatter - Formatter to apply to values displayed in the gradation labels

setDataValueFormatter

public void setDataValueFormatter(ValueFormatter formatter)

Formatter to apply to values displayed in the hover labels and other value labels

Parameters:

formatter - Formatter to apply to values displayed in the hover labels and other value labels

getDataColor

public java.lang.String getDataColor(int index,
                                     java.lang.String facetValueId,
                                     java.lang.String purpose)

Get a color from the dataColors Array. The colors returned by this method define what colors are used for the data in the chart.

This is not an override point, but you can provide your own function by setting a customizer with setDataColorMapper().

Parameters:

index - index of the visual element to be colored

facetValueId - id of the facet value to be colored

purpose - purpose for the requested color - such as "legend", "line", "area", "points", etc.

Returns:

chosen color

See Also:

ColorMapper, setDataLineColorMapper(com.smartgwt.client.widgets.chart.ColorMapper), setDataGradientMapper(com.smartgwt.client.widgets.chart.GradientMapper)

getDataColor

public java.lang.String getDataColor(int index,
                                     java.lang.Integer facetValueId,
                                     java.lang.String purpose)

See getDataColor(int, java.lang.String, java.lang.String)

getDataColor

public java.lang.String getDataColor(int index,
                                     java.lang.Double facetValueId,
                                     java.lang.String purpose)

See getDataColor(int, java.lang.String, java.lang.String)

getDataColor

public java.lang.String getDataColor(int index,
                                     java.util.Date facetValueId,
                                     java.lang.String purpose)

See getDataColor(int, java.lang.String, java.lang.String)

getDataColor

public java.lang.String getDataColor(int index)

See getDataColor(int, java.lang.String, java.lang.String)

setDataColorMapper

public void setDataColorMapper(ColorMapper colorMapper)

Sets a customizer to redefine what colors are used when rendering the chart data.

Parameters:

colorMapper - the customizer redefining what colors are used for chart data

See Also:

getDataColor(int, java.lang.String, java.lang.String), setDataLineColorMapper(com.smartgwt.client.widgets.chart.ColorMapper), setDataGradientMapper(com.smartgwt.client.widgets.chart.GradientMapper)

setDataLineColorMapper

public void setDataLineColorMapper(ColorMapper colorMapper)

Sets a customizer to redefine what colors are used when rendering lines for the chart data. No default implementation. If not defined or null is returned, the Framework will default to using the datacolor - either getDataColor() or the ColorMapper installed by setDataColorMapper() if one has been provided.

Parameters:

colorMapper - the customizer redefining what line colors are used for chart data

See Also:

getDataColor(int, java.lang.String, java.lang.String), setDataColorMapper(com.smartgwt.client.widgets.chart.ColorMapper), setDataGradientMapper(com.smartgwt.client.widgets.chart.GradientMapper)

setDataGradientMapper

public void setDataGradientMapper(GradientMapper gradientMapper)

Sets a customizer to redefine what gradients are used when rendering the chart data.

Parameters:

gradientMapper - the customizer redefining what gradients are used for chart data

See Also:

getDataColor(int, java.lang.String, java.lang.String), setDataLineColorMapper(com.smartgwt.client.widgets.chart.ColorMapper), setDataGradientMapper(com.smartgwt.client.widgets.chart.GradientMapper)