Deprecated API

Contents

• Deprecated Fields
• Deprecated Methods

Deprecated Fields

com.googlecode.gchart.client.GChart.SymbolType.HBAR_NEXT
As of version 2.4, this symbol has been redefined to be synonomous with the LINE symbol type.

Prior to v2.4, this symbol drew a horizontal bar from each point to the x coordinate of the next point. Some applications may need to use a revised point set in order to produce the same curves using LINE that they used to produce with this symbol.

See the discussion within the VBAR_NEXT symbol for more information about why support for these vertically and horizontally constrained connecting line symbol types was dropped.

com.googlecode.gchart.client.GChart.SymbolType.HBAR_PREV
As of version 2.4, this symbol has been redefined to be synonymous with the LINE symbol type.

Prior to v2.4, this symbol drew a horizontal bar from each point to the x coordinate of the previous point. Some applications may need to use a revised point set in order to produce the same curves using LINE that they used to produce with this symbol.

See the discussion within the VBAR_NEXT symbol for more information about why support for these vertically and horizontally constrained connecting line symbol types was dropped.

com.googlecode.gchart.client.GChart.SymbolType.LINE_CANVAS
In GChart 2.3, you had to use this special symbol type to get GChart to use an external canvas library to draw crisp connecting lines.

As of GChart 2.5, the LINE symbol type will, by default, be rendered with whatever external canvas library you provide to GChart via the setCanvasFactory method.

So now, LINE_CANVAS is just another name for LINE. Please replace LINE_CANVAS with LINE in your code.

Note that LINE only draws continuous lines if fill spacing (setFillSpacing) is 0. With fill spacing > 0, it uses the old HTML-rendering method. Since 0 is now the new default fill spacing for the LINE symbol type, normally LINE works exactly like LINE_CANVAS did. But, if you had explicitly set the fill spacing, you may have to remove this specification, or set it to 0, to get the same behavior you had before with LINE_CANVAS.

com.googlecode.gchart.client.GChart.SymbolType.VBAR_NEXT
As of version 2.4, this symbol has been redefined to be synonomous with the LINE symbol type.

Prior to v2.4, this symbol drew a vertical bar from each point to the y coordinate of the next point. Some applications may need to use a revised point set in order to produce the same curves with LINE that they used to produce with this symbol.

Support was dropped because:

1. Continued support would have complicated implementation of the new hover feedback system introduced with v2.4 (these are the only symbols whose hit-testing-related size depends on preceding or subsequent points).

2. With the introduction of LINE the main reason for this, and related, vertically (or horizontally) constrained line drawing symbol types had been eliminated (had LINE existed at the beginning, these constrained line drawing symbol types would never have been added).

Finally, note that if lines are vertical or horizontal, and solidly connected, LINE automatically collapses them into a single element, so no element-based efficiency losses need be associated with replacing curves using such rectilinear symbol types with equivalent curves rendered via the LINE symbol type.

com.googlecode.gchart.client.GChart.SymbolType.VBAR_PREV
As of version 2.4, this symbol has been redefined to be synonomous with the LINE symbol type.

Prior to v2.4, this symbol drew a vertical bar from each point to the y coordinate of the previous point. Some applications may need to use a revised point set in order to produce the same curves using LINE that they used to produce with this symbol.

See the discussion within the VBAR_NEXT symbol for more information about why support for these vertically and horizontally constrained connecting line symbol types was dropped.

com.googlecode.gchart.client.GChart.SymbolType.Y2GRIDLINE
This symbol is the same as YGRIDLINE and was added by mistake in version 1. (the y-axis isn't defined by the symbol type, but rather by the curve's setYAxis method).

Please use YGRIDLINE instead.

Deprecated Methods

com.googlecode.gchart.client.GChart.Axis.formatNumberAsTickLabel(double)
Equivalent to the better-named formatAsTickLabel.

com.googlecode.gchart.client.GChart.Symbol.getFillHasHovertext()
Returns the value previously set by setFillHasHovertext.

com.googlecode.gchart.client.GChart.Curve.getHovertextTemplate()
This method is equivalent to:

getSymbol().getHovertextTemplate()

It is retained only for GChart 1.1 compatibility purposes.

com.googlecode.gchart.client.GChart.getShowOffChartPoints()
Equivalent to !getClipToPlotArea(). Use that method instead.

com.googlecode.gchart.client.GChart.getShowOffDecoratedChartGlyphs()
Equivalent to !getClipToDecoratedChart(). Use that method instead.

com.googlecode.gchart.client.GChart.Symbol.setFillHasHovertext(boolean)
As of GChart 2.4, hover feedback has been completely redesigned. Though these changes are mostly positive, one downside is that, to simplify its hit-testing algorithms, GChart only provides hover feedback for the explicitly specified data points on a line chart; it can no longer provide feedback for the "filled in" points connecting successive data points. If you need hover feedback on such interpolated points you will have to explicitly add individual data points to the curve representing the interpolated values.

Another difference is that you can no longer turn off hover feedback for a pie slice via this method. If you need to turn hover feedback off for a pie slice (or for any other symbol, for that matter) you can use the (new with 2.4) setHoverAnnotationEnabled and setHoverSelectionEnabled methods.

com.googlecode.gchart.client.GChart.Curve.setHovertextTemplate(String)
This method is equivalent to:

getSymbol().setHovertextTemplate(hovertextTemplate)

It is retained only for GChart 1.1 compatibility purposes.

com.googlecode.gchart.client.GChart.setShowOffChartPoints(boolean)
Equivalent to setClipToPlotArea(!showOffChartPoints). Use that method instead.

As of GChart 2.5, the clip-to-plot-area algorithm no longer drops the entire symbol if it's x,y coordinates are outside of the plot area; instead, it clips them off in the traditional "overflow: hidden" manner. Though unlikely you would need to, there is no easy way to recreate the previous behavior.

This change was made so that both rectangular HTML and continuous, canvas-rendered chart elements would be clipped in a consistent and sensible way.

com.googlecode.gchart.client.GChart.setShowOffDecoratedChartGlyphs(boolean)
Equivalent to setClipToDecoratedChart(!showOffDecoratedChart), please use that method instead.