Package com.amalgamasimulation.charts

Class AbstractBarChart

java.lang.Object

com.amalgamasimulation.charts.Chart<IBarChartVisualSet,BarVisualSetContainer>

com.amalgamasimulation.charts.AbstractBarChart

All Implemented Interfaces:

IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Direct Known Subclasses:

BarChart, HistogramChart

public abstract class AbstractBarChart
extends Chart<IBarChartVisualSet,BarVisualSetContainer>
implements IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Abstract class for charts used to show statistical data by categories as well as histograms.

Author:

Aleksey Kirillov

Field Summary

Fields

Modifier and Type	Field	Description
protected com.amalgamasimulation.charts.internals.charts.AbstractBarChartInternal	internalBarChart

Constructor Summary

Constructors

Constructor	Description
AbstractBarChart()

Method Summary

Modifier and Type	Method	Description
AbstractBarChart	addContextMenuItem(BarChartContextMenuItem contextMenuItem)	Adds the new context menu item to the end of the items list.
void	addVerticalGuidelineChangeHandler(BiConsumer<Boolean,Double> handler)	Adds the action to be executed every time the vertical guideline visibility or position is changed.
AbstractBarChart	clearContextMenuItems()	Removes all context menu items added by the 'addContextMenuItem' calls.
void	clearVerticalGuidelineChangeHandlers()	Clear all the vertical guideline visibility or position changed actions.
protected com.amalgamasimulation.charts.internals.charts.AbstractBarChartInternal	getChartInternal()
abstract Legend<Object>	getLegend()	Returns the Legend currently shown on this chart.
javafx.scene.paint.Color	getVerticalGuidelineColor()	Returns the current color of the vertical guideline.
double	getVerticalGuidelinePosition()	Returns the current X-axis position of vertical guideline.
double	getVerticalGuidelineWidth()	Returns the current width of the vertical guideline.
AbstractBarChart	hideVerticalGuideline()	Hides the currently displayed vertical guideline.
boolean	isVerticalGuidelineDisplayed()	Checks whether vertical guideline is displayed.
boolean	isVerticalGuidelineLabelVisible()	Checks whether the vertical guideline label is drawn.
boolean	isVerticalGuidelineSnapToGridLines()	Checks whether vertical guideline is snapped to grid lines.
boolean	isVerticalGuidelineValuesVisible()	Checks whether the legend values are drawn.
boolean	isVerticalGuidelineVisible()	Checks whether vertical guideline is drawn.
AbstractBarChart	removeContextMenuItem(BarChartContextMenuItem contextMenuHandler)	Removes the context menu item.
void	removeVerticalGuidelineChangeHandler(BiConsumer<Boolean,Double> handler)	Removes the vertical guideline visibility or position changed action.
AbstractBarChart	setVerticalGuidelineColor(Color color)	Sets the new color to the vertical guideline.
AbstractBarChart	setVerticalGuidelineColor(javafx.scene.paint.Color color)	Sets the new color to the vertical guideline.
AbstractBarChart	setVerticalGuidelineLabelVisible(boolean visible)	Specifies whether the vertical guideline label should be drawn.
AbstractBarChart	setVerticalGuidelineSnapToGridLines(boolean snapToGridLines)	Specifies whether the vertical guideline should be snapped to grid lines.
AbstractBarChart	setVerticalGuidelineValuesVisible(boolean visible)	Specifies whether the legend values of the applicable visual sets should be drawn when a vertical guideline is shown.
AbstractBarChart	setVerticalGuidelineVisible(boolean visible)	Specifies whether the vertical guideline functionality should be enabled for the end users of this chart.
AbstractBarChart	setVerticalGuidelineWidth(double width)	Sets the new width to the vertical guideline, in pixels.
AbstractBarChart	showVerticalGuidelineDisplayed(double position)	Shows a vertical guideline at the specified X-axis position.

Methods inherited from class com.amalgamasimulation.charts.Chart

addKeyPressedHandler, addKeyReleasedHandler, addMouseDragExitedHandler, addMouseDraggedHandler, addMouseDragOverHandler, addMouseDragReleasedHandler, addMouseEnteredHandlers, addMouseExitedHandler, addMousePressedHandler, addMouseReleasedHandler, addMouseScrollHandler, addRedrawFinishedHandler, addTextLabel, addTextLabel, clearKeyPressedHandlers, clearKeyReleasedHandlers, clearMouseDragExitedHandlers, clearMouseDraggedHandlers, clearMouseDragOverHandlers, clearMouseDragReleasedHandlers, clearMouseEnteredHandlers, clearMouseExitedHandlers, clearMousePressedHandlers, clearMouseReleasedHandlers, clearMouseScrollHandlers, clearRedrawFinishedHandlers, copyToClipboard, dispose, getBackgroundColor, getBottomMargin, getContentBackgroundColor, getLeftMargin, getTitle, getTitleColor, getTitleFont, getTitleFontSize, getTopMargin, getVisualSetContainer, getXAxis, getYAxis, initializeChartGroup, isDisposed, isRedrawInProgress, isTitleVisible, isVisible, isVisualSetVisible, redraw, removeKeyPressedHandler, removeKeyReleasedHandler, removeMouseDragExitedHandler, removeMouseDraggedHandler, removeMouseDragOverHandler, removeMouseDragReleasedHandler, removeMouseEnteredHandler, removeMouseExitedHandler, removeMousePressedHandler, removeMouseReleasedHandler, removeMouseScrollHandler, removeRedrawFinishedHandler, removeTextLabel, resizeChart, setBackgroundColor, setBackgroundColor, setBottomMargin, setContentBackgroundColor, setContentBackgroundColor, setContextMenuVisible, setCopyToClipboardContextMenuItemVisible, setLeftMargin, setTitle, setTitleColor, setTitleColor, setTitleFont, setTitleFontSize, setTitleVisible, setTopMargin, setVisibility, setVisualSetContainer, setVisualSetVisible, updateSize

Methods inherited from class java.lang.Object

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

Field Details

internalBarChart

protected com.amalgamasimulation.charts.internals.charts.AbstractBarChartInternal internalBarChart

Constructor Details

AbstractBarChart

public AbstractBarChart()

Method Details

getChartInternal

protected com.amalgamasimulation.charts.internals.charts.AbstractBarChartInternal getChartInternal()

Specified by:

getChartInternal in class Chart<IBarChartVisualSet,BarVisualSetContainer>

getLegend

public abstract Legend<Object> getLegend()

Returns the Legend currently shown on this chart.

Returns:

the Legend currently shown on this chart

addContextMenuItem

public AbstractBarChart addContextMenuItem(BarChartContextMenuItem contextMenuItem)

Adds the new context menu item to the end of the items list.

Parameters:

contextMenuItem - new context menu item

Returns:

reference to this object

removeContextMenuItem

public AbstractBarChart removeContextMenuItem(BarChartContextMenuItem contextMenuHandler)

Removes the context menu item.

Parameters:

contextMenuHandler - removed context menu item

Returns:

reference to this object

clearContextMenuItems

public AbstractBarChart clearContextMenuItems()

Removes all context menu items added by the 'addContextMenuItem' calls. Does not affect pre-installed items such as 'copy to clipboard'.

Returns:

reference to this object

setVerticalGuidelineVisible

public AbstractBarChart setVerticalGuidelineVisible(boolean visible)

Description copied from interface: IVerticalGuidelineOwner

Specifies whether the vertical guideline functionality should be enabled for the end users of this chart. This functionality allows the users to show and hide the vertical guideline by clicking on the chart contents area. Redraws this chart if visibility is changed.

Vertical guideline functionality is enabled by default.

Specified by:

setVerticalGuidelineVisible in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Parameters:

visible - true if vertical guideline functionality should be enabled, false otherwise

Returns:

reference to this object

setVerticalGuidelineLabelVisible

public AbstractBarChart setVerticalGuidelineLabelVisible(boolean visible)

Description copied from interface: IVerticalGuidelineOwner

Specifies whether the vertical guideline label should be drawn. Is true by default. Redraws this chart if visibility is changed.

Specified by:

setVerticalGuidelineLabelVisible in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Parameters:

visible - new vertical guideline label visibility

Returns:

reference to this object

setVerticalGuidelineValuesVisible

public AbstractBarChart setVerticalGuidelineValuesVisible(boolean visible)

Description copied from interface: IVerticalGuidelineOwner

Specifies whether the legend values of the applicable visual sets should be drawn when a vertical guideline is shown. The displayed values are the result of the intersection of the corresponding data elements with a vertical guideline. Is true by default. Redraws this chart if visibility is changed.

Specified by:

setVerticalGuidelineValuesVisible in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Parameters:

visible - true if the legend values should be drawn, false otherwise

Returns:

reference to this object

showVerticalGuidelineDisplayed

public AbstractBarChart showVerticalGuidelineDisplayed(double position)

Description copied from interface: IVerticalGuidelineOwner

Shows a vertical guideline at the specified X-axis position. Redraws this chart.

Specified by:

showVerticalGuidelineDisplayed in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Parameters:

position - specified X-axis position of the vertical guideline

Returns:

reference to this object

setVerticalGuidelineColor

public AbstractBarChart setVerticalGuidelineColor(Color color)

Description copied from interface: IVerticalGuidelineOwner

Sets the new color to the vertical guideline. Redraws this chart if color is changed.

Specified by:

setVerticalGuidelineColor in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Parameters:

color - new vertical guideline color

Returns:

reference to this object

setVerticalGuidelineColor

public AbstractBarChart setVerticalGuidelineColor(javafx.scene.paint.Color color)

Description copied from interface: IVerticalGuidelineOwner

Sets the new color to the vertical guideline. Redraws this chart if color is changed.

Specified by:

setVerticalGuidelineColor in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Parameters:

color - new vertical guideline color

Returns:

reference to this object

setVerticalGuidelineWidth

public AbstractBarChart setVerticalGuidelineWidth(double width)

Description copied from interface: IVerticalGuidelineOwner

Sets the new width to the vertical guideline, in pixels. Redraws this chart if width is changed.

Specified by:

setVerticalGuidelineWidth in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Parameters:

width - new vertical guideline width, in pixels

Returns:

reference to this object

isVerticalGuidelineVisible

public boolean isVerticalGuidelineVisible()

Description copied from interface: IVerticalGuidelineOwner

Checks whether vertical guideline is drawn.

Specified by:

isVerticalGuidelineVisible in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Returns:

true if vertical guideline is drawn, false otherwise

isVerticalGuidelineLabelVisible

public boolean isVerticalGuidelineLabelVisible()

Description copied from interface: IVerticalGuidelineOwner

Checks whether the vertical guideline label is drawn.

Specified by:

isVerticalGuidelineLabelVisible in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Returns:

true if the vertical guideline label is drawn, false otherwise

isVerticalGuidelineValuesVisible

public boolean isVerticalGuidelineValuesVisible()

Description copied from interface: IVerticalGuidelineOwner

Checks whether the legend values are drawn.

Specified by:

isVerticalGuidelineValuesVisible in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Returns:

true if the legend values are drawn, false otherwise

getVerticalGuidelineColor

public javafx.scene.paint.Color getVerticalGuidelineColor()

Description copied from interface: IVerticalGuidelineOwner

Returns the current color of the vertical guideline.

Specified by:

getVerticalGuidelineColor in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Returns:

the current color of the vertical guideline

getVerticalGuidelineWidth

public double getVerticalGuidelineWidth()

Description copied from interface: IVerticalGuidelineOwner

Returns the current width of the vertical guideline.

Specified by:

getVerticalGuidelineWidth in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Returns:

the current width of the vertical guideline

setVerticalGuidelineSnapToGridLines

public AbstractBarChart setVerticalGuidelineSnapToGridLines(boolean snapToGridLines)

Description copied from interface: IVerticalGuidelineOwner

Specifies whether the vertical guideline should be snapped to grid lines.

Specified by:

setVerticalGuidelineSnapToGridLines in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Parameters:

snapToGridLines - new value of property vertical guideline snapped to grid lines

Returns:

reference to this object

isVerticalGuidelineSnapToGridLines

public boolean isVerticalGuidelineSnapToGridLines()

Description copied from interface: IVerticalGuidelineOwner

Checks whether vertical guideline is snapped to grid lines.

Specified by:

isVerticalGuidelineSnapToGridLines in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Returns:

true if vertical guideline is snapped to grid lines

hideVerticalGuideline

public AbstractBarChart hideVerticalGuideline()

Description copied from interface: IVerticalGuidelineOwner

Hides the currently displayed vertical guideline. Redraws this chart. Does nothing if the vertical guideline is not currently displayed.

Specified by:

hideVerticalGuideline in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Returns:

reference to this object

isVerticalGuidelineDisplayed

public boolean isVerticalGuidelineDisplayed()

Description copied from interface: IVerticalGuidelineOwner

Checks whether vertical guideline is displayed.

Specified by:

isVerticalGuidelineDisplayed in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Returns:

true if vertical guideline is displayed

getVerticalGuidelinePosition

public double getVerticalGuidelinePosition()

Description copied from interface: IVerticalGuidelineOwner

Returns the current X-axis position of vertical guideline.

Specified by:

getVerticalGuidelinePosition in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Returns:

the current X-axis position of vertical guideline

addVerticalGuidelineChangeHandler

public void addVerticalGuidelineChangeHandler(BiConsumer<Boolean,Double> handler)

Description copied from interface: IVerticalGuidelineOwner

Adds the action to be executed every time the vertical guideline visibility or position is changed.

Specified by:

addVerticalGuidelineChangeHandler in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Parameters:

handler - new action to be executed every time the vertical guideline visibility or position is changed

removeVerticalGuidelineChangeHandler

public void removeVerticalGuidelineChangeHandler(BiConsumer<Boolean,Double> handler)

Description copied from interface: IVerticalGuidelineOwner

Removes the vertical guideline visibility or position changed action.

Specified by:

removeVerticalGuidelineChangeHandler in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>

Parameters:

handler - removed vertical guideline visibility or position changed action

clearVerticalGuidelineChangeHandlers

public void clearVerticalGuidelineChangeHandlers()

Description copied from interface: IVerticalGuidelineOwner

Clear all the vertical guideline visibility or position changed actions.

Specified by:

clearVerticalGuidelineChangeHandlers in interface IVerticalGuidelineOwner<IBarChartVisualSet,BarVisualSetContainer>