com.haulmont.charts.gui.amcharts.model

Class ChartCursorSettings

java.lang.Object

com.haulmont.charts.gui.amcharts.model.AbstractChartObject

com.haulmont.charts.gui.amcharts.model.ChartCursorSettings

All Implemented Interfaces:

java.io.Serializable

public class ChartCursorSettings
extends AbstractChartObject

Defines set of properties for chart cursor. If there is no default value specified, default value of Cursor class will be used.
See documentation for properties of ChartCursorSettings JS object.
http://docs.amcharts.com/3/javascriptstockchart/ChartCursorSettings

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ChartCursorSettings()

Method Summary

Modifier and Type	Method and Description
ChartCursorSettings	addCategoryBalloonDateFormats(DateFormat... categoryBalloonDateFormats) Adds date formats.
BalloonPointerOrientation	getBalloonPointerOrientation()
java.lang.Boolean	getBulletsEnabled()
java.lang.Integer	getBulletSize()
java.lang.Double	getCategoryBalloonAlpha()
Color	getCategoryBalloonColor()
java.util.List<DateFormat>	getCategoryBalloonDateFormats()
java.lang.Boolean	getCategoryBalloonEnabled()
java.lang.String	getCategoryBalloonText()
Color	getColor()
java.lang.Double	getCursorAlpha()
Color	getCursorColor()
CursorPosition	getCursorPosition()
java.lang.Boolean	getEnabled()
java.lang.Boolean	getFullWidth()
java.lang.Double	getGraphBulletSize()
java.lang.Boolean	getLeaveAfterTouch()
java.lang.Boolean	getLeaveCursor()
java.lang.Boolean	getOnePanelOnly()
java.lang.Boolean	getPan()
java.lang.Boolean	getSelectWithoutZooming()
java.lang.Boolean	getShowNextAvailable()
java.lang.Boolean	getValueBalloonsEnabled()
java.lang.Double	getValueLineAlpha()
java.lang.Boolean	getValueLineBalloonEnabled()
java.lang.Boolean	getValueLineEnabled()
java.lang.Boolean	getZoomable()
ChartCursorSettings	setBalloonPointerOrientation(BalloonPointerOrientation balloonPointerOrientation) Sets orientation of value balloon pointer.
ChartCursorSettings	setBulletsEnabled(java.lang.Boolean bulletsEnabled) Specifies if bullet for each graph will follow the cursor.
ChartCursorSettings	setBulletSize(java.lang.Integer bulletSize) Sets size of bullets, following the cursor.
ChartCursorSettings	setCategoryBalloonAlpha(java.lang.Double categoryBalloonAlpha) Sets opacity of the category balloon.
ChartCursorSettings	setCategoryBalloonColor(Color categoryBalloonColor) Sets color of the category balloon.
ChartCursorSettings	setCategoryBalloonDateFormats(java.util.List<DateFormat> categoryBalloonDateFormats) Sets list of date formats.
ChartCursorSettings	setCategoryBalloonEnabled(java.lang.Boolean categoryBalloonEnabled) Specifies whether category balloon is enabled.
ChartCursorSettings	setCategoryBalloonText(java.lang.String categoryBalloonText) Sets category balloon text.
ChartCursorSettings	setColor(Color color) Sets text color.
ChartCursorSettings	setCursorAlpha(java.lang.Double cursorAlpha) Sets opacity of the cursor line.
ChartCursorSettings	setCursorColor(Color cursorColor) Sets color of the cursor line.
ChartCursorSettings	setCursorPosition(CursorPosition cursorPosition) Sets cursor position.
ChartCursorSettings	setEnabled(java.lang.Boolean enabled) Set enabled to false if you don't want chart cursor to appear in your charts.
ChartCursorSettings	setFullWidth(java.lang.Boolean fullWidth) Set to true if you want instead of a cursor line user should see a fill which width will always be equal to the width of one data item.
ChartCursorSettings	setGraphBulletSize(java.lang.Double graphBulletSize) Sets size of a graph's bullet (if available) at the cursor position.
ChartCursorSettings	setLeaveAfterTouch(java.lang.Boolean leaveAfterTouch) Set leaveAfterTouch to false if cursor and balloons shouldn't remain after the user touches the chart.
ChartCursorSettings	setLeaveCursor(java.lang.Boolean leaveCursor) Set leaveCursor to true if cursor should be left at it's last position.
ChartCursorSettings	setOnePanelOnly(java.lang.Boolean onePanelOnly) Set onePanelOnly to true if stock chart should display value balloons on currently hovered panel only.
ChartCursorSettings	setPan(java.lang.Boolean pan) Set pan to true and the user will be able to pan the chart instead of zooming.
void	setSelectWithoutZooming(java.lang.Boolean selectWithoutZooming) Set selectWithoutZooming to true if cursor should only mark selected area but not zoom-in after user releases mouse button.
void	setShowNextAvailable(java.lang.Boolean showNextAvailable) If true, the graph will display balloon on next available data point if currently hovered item doesn't have value for this graph.
ChartCursorSettings	setValueBalloonsEnabled(java.lang.Boolean valueBalloonsEnabled) Set valueBalloonsEnabled to true if value balloons should be enabled.
ChartCursorSettings	setValueLineAlpha(java.lang.Double valueLineAlpha) Sets opacity of value line.
ChartCursorSettings	setValueLineBalloonEnabled(java.lang.Boolean valueLineBalloonEnabled) Set valueLineBalloonEnabled to true if value balloon next to value axis labels should be displayed.
ChartCursorSettings	setValueLineEnabled(java.lang.Boolean valueLineEnabled) Set valueLineEnabled to true if cursor of serial chart should display horizontal (or vertical if chart is rotated) line.
ChartCursorSettings	setZoomable(java.lang.Boolean zoomable) Set zoomable to true if the user should zoom-in the chart.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ChartCursorSettings

public ChartCursorSettings()

Method Detail

getBalloonPointerOrientation

public BalloonPointerOrientation getBalloonPointerOrientation()

Returns:

orientation of value balloon pointer

setBalloonPointerOrientation

public ChartCursorSettings setBalloonPointerOrientation(BalloonPointerOrientation balloonPointerOrientation)

Sets orientation of value balloon pointer. If not set the default value is HORIZONTAL.

Parameters:

balloonPointerOrientation - orientation of value balloon pointer

getBulletsEnabled

public java.lang.Boolean getBulletsEnabled()

Returns:

true if bulletsEnabled is enabled

setBulletsEnabled

public ChartCursorSettings setBulletsEnabled(java.lang.Boolean bulletsEnabled)

Specifies if bullet for each graph will follow the cursor.

Parameters:

bulletsEnabled - bulletsEnabled option

getBulletSize

public java.lang.Integer getBulletSize()

Returns:

bullet size

setBulletSize

public ChartCursorSettings setBulletSize(java.lang.Integer bulletSize)

Sets size of bullets, following the cursor.

Parameters:

bulletSize - bullet size

getCategoryBalloonAlpha

public java.lang.Double getCategoryBalloonAlpha()

Returns:

opacity of the category balloon

setCategoryBalloonAlpha

public ChartCursorSettings setCategoryBalloonAlpha(java.lang.Double categoryBalloonAlpha)

Sets opacity of the category balloon.

Parameters:

categoryBalloonAlpha - opacity of the category balloon

getCategoryBalloonColor

public Color getCategoryBalloonColor()

Returns:

color of the category balloon

setCategoryBalloonColor

public ChartCursorSettings setCategoryBalloonColor(Color categoryBalloonColor)

Sets color of the category balloon.

Parameters:

categoryBalloonColor - color of the category balloon

getCategoryBalloonDateFormats

public java.util.List<DateFormat> getCategoryBalloonDateFormats()

Returns:

list of date formats

setCategoryBalloonDateFormats

public ChartCursorSettings setCategoryBalloonDateFormats(java.util.List<DateFormat> categoryBalloonDateFormats)

Sets list of date formats. If not set the default value is

 [{period:"YYYY", format:"YYYY"},
  {period:"MM",   format:"MMM, YYYY"},
  {period:"WW",   format:"MMM DD, YYYY"},
  {period:"DD",   format:"MMM DD, YYYY"},
  {period:"hh",   format:"JJ:NN"},
  {period:"mm",   format:"JJ:NN"},
  {period:"ss",   format:"JJ:NN:SS"},
  {period:"fff",  format:"JJ:NN:SS"}]
 

Parameters:

categoryBalloonDateFormats - list of date formats

addCategoryBalloonDateFormats

public ChartCursorSettings addCategoryBalloonDateFormats(DateFormat... categoryBalloonDateFormats)

Adds date formats.

Parameters:

categoryBalloonDateFormats - date formats

getCategoryBalloonEnabled

public java.lang.Boolean getCategoryBalloonEnabled()

Returns:

true if categoryBalloonEnabled is enabled

setCategoryBalloonEnabled

public ChartCursorSettings setCategoryBalloonEnabled(java.lang.Boolean categoryBalloonEnabled)

Specifies whether category balloon is enabled.

Parameters:

categoryBalloonEnabled - categoryBalloonEnabled option

getCategoryBalloonText

public java.lang.String getCategoryBalloonText()

Returns:

category balloon text

setCategoryBalloonText

public ChartCursorSettings setCategoryBalloonText(java.lang.String categoryBalloonText)

Sets category balloon text. You can have [[category]] - [[toCategory]] tags in there and show category ranges this way. If not set the default value is "[[category]]".

Parameters:

categoryBalloonText - category balloon text

getCursorAlpha

public java.lang.Double getCursorAlpha()

Returns:

opacity of the cursor line

setCursorAlpha

public ChartCursorSettings setCursorAlpha(java.lang.Double cursorAlpha)

Sets opacity of the cursor line.

Parameters:

cursorAlpha - opacity of the cursor line

getCursorColor

public Color getCursorColor()

Returns:

color of the cursor line

setCursorColor

public ChartCursorSettings setCursorColor(Color cursorColor)

Sets color of the cursor line. If not set the default value is #FFFFFF.

Parameters:

cursorColor - color of the cursor line

getCursorPosition

public CursorPosition getCursorPosition()

Returns:

cursor position

setCursorPosition

public ChartCursorSettings setCursorPosition(CursorPosition cursorPosition)

Sets cursor position. Possible values: start, middle, mouse.

Parameters:

cursorPosition - cursor position

getEnabled

public java.lang.Boolean getEnabled()

Returns:

true if this property is enabled

setEnabled

public ChartCursorSettings setEnabled(java.lang.Boolean enabled)

Set enabled to false if you don't want chart cursor to appear in your charts. If not set the default value is true.

Parameters:

enabled - enabled option

getFullWidth

public java.lang.Boolean getFullWidth()

Returns:

true if a fill width always equals to the width of one data item

setFullWidth

public ChartCursorSettings setFullWidth(java.lang.Boolean fullWidth)

Set to true if you want instead of a cursor line user should see a fill which width will always be equal to the width of one data item. It is recommended setting cursorAlpha to 0.1 or some other small number if using this feature. If not set the default value is false.

Parameters:

fullWidth - fullWidth option

getGraphBulletSize

public java.lang.Double getGraphBulletSize()

Returns:

size of a graph's bullet

setGraphBulletSize

public ChartCursorSettings setGraphBulletSize(java.lang.Double graphBulletSize)

Sets size of a graph's bullet (if available) at the cursor position. If you don't want the bullet to change its size, set this property to 1. If not set the default value is 1.7

Parameters:

graphBulletSize - size of a graph's bullet

getLeaveAfterTouch

public java.lang.Boolean getLeaveAfterTouch()

Returns:

true if cursor and balloons remain after the user touches the chart

setLeaveAfterTouch

public ChartCursorSettings setLeaveAfterTouch(java.lang.Boolean leaveAfterTouch)

Set leaveAfterTouch to false if cursor and balloons shouldn't remain after the user touches the chart. If not set the default value is true.

Parameters:

leaveAfterTouch - leaveAfterTouch option

getLeaveCursor

public java.lang.Boolean getLeaveCursor()

Returns:

true if the cursor remains in the last position

setLeaveCursor

public ChartCursorSettings setLeaveCursor(java.lang.Boolean leaveCursor)

Set leaveCursor to true if cursor should be left at it's last position. Useful for touch devices - user might want to see the balloons after he moves finger away. If not set the default value is false.

Parameters:

leaveCursor - leaveCursor option

getOnePanelOnly

public java.lang.Boolean getOnePanelOnly()

Returns:

true if stock chart displays value balloons on currently hovered panel only

setOnePanelOnly

public ChartCursorSettings setOnePanelOnly(java.lang.Boolean onePanelOnly)

Set onePanelOnly to true if stock chart should display value balloons on currently hovered panel only. If not set the default value is false.

Parameters:

onePanelOnly - onePanelOnly option

getPan

public java.lang.Boolean getPan()

Returns:

true if the user can pan the chart instead of zooming

setPan

public ChartCursorSettings setPan(java.lang.Boolean pan)

Set pan to true and the user will be able to pan the chart instead of zooming.

Parameters:

pan - pan option

getValueBalloonsEnabled

public java.lang.Boolean getValueBalloonsEnabled()

Returns:

true if value balloons is enabled

setValueBalloonsEnabled

public ChartCursorSettings setValueBalloonsEnabled(java.lang.Boolean valueBalloonsEnabled)

Set valueBalloonsEnabled to true if value balloons should be enabled. In case they are not enabled, the balloons might be displayed anyway, when the user rolls-over the column or bullet. If not set the default value is false.

Parameters:

valueBalloonsEnabled - valueBalloonsEnabled option

getValueLineAlpha

public java.lang.Double getValueLineAlpha()

Returns:

opacity of value line

setValueLineAlpha

public ChartCursorSettings setValueLineAlpha(java.lang.Double valueLineAlpha)

Sets opacity of value line. Will use cursorAlpha value if not set.

Parameters:

valueLineAlpha - opacity of value line

getValueLineBalloonEnabled

public java.lang.Boolean getValueLineBalloonEnabled()

Returns:

true if value balloon next to value axis labels is displayed

setValueLineBalloonEnabled

public ChartCursorSettings setValueLineBalloonEnabled(java.lang.Boolean valueLineBalloonEnabled)

Set valueLineBalloonEnabled to true if value balloon next to value axis labels should be displayed. If you have more than one axis, set Cursor.valueLineAxis to indicate which axis should display the balloon. If not set the default value is false.

Parameters:

valueLineBalloonEnabled - valueLineBalloonEnabled option

getValueLineEnabled

public java.lang.Boolean getValueLineEnabled()

Returns:

true if cursor of serial chart displays horizontal (or vertical if chart is rotated) line

setValueLineEnabled

public ChartCursorSettings setValueLineEnabled(java.lang.Boolean valueLineEnabled)

Set valueLineEnabled to true if cursor of serial chart should display horizontal (or vertical if chart is rotated) line. This line might help users to compare distant values of a chart. You can also enable value balloon on this line by setting Cursor.valueLineAxis property. If not set the default value is false.

Parameters:

valueLineEnabled - valueLineEnabled option

getZoomable

public java.lang.Boolean getZoomable()

Returns:

true if the user can zoom-in the chart

setZoomable

public ChartCursorSettings setZoomable(java.lang.Boolean zoomable)

Set zoomable to true if the user should zoom-in the chart. If pan is set to true, zoomable is switched to false automatically.

Parameters:

zoomable - zoomable option

getColor

public Color getColor()

Returns:

text color

setColor

public ChartCursorSettings setColor(Color color)

Sets text color.

Parameters:

color - text color

getSelectWithoutZooming

public java.lang.Boolean getSelectWithoutZooming()

Returns:

true if cursor selects area but not zoom-in

setSelectWithoutZooming

public void setSelectWithoutZooming(java.lang.Boolean selectWithoutZooming)

Set selectWithoutZooming to true if cursor should only mark selected area but not zoom-in after user releases mouse button. If not set the default value is false.

Parameters:

selectWithoutZooming - selectWithoutZooming option

getShowNextAvailable

public java.lang.Boolean getShowNextAvailable()

Returns:

true if graph displays balloon on next available data point while currently hovered item doesn't have value for this graph

setShowNextAvailable

public void setShowNextAvailable(java.lang.Boolean showNextAvailable)

If true, the graph will display balloon on next available data point if currently hovered item doesn't have value for this graph. If not set the default value is false.

Parameters:

showNextAvailable - showNextAvailable option