Package com.amalgamasimulation.visualsets

Class VerticalGridLineVisualSet<T>

java.lang.Object

com.amalgamasimulation.visualsets.VisualSet<T>

com.amalgamasimulation.visualsets.AbstractGridLineVisualSet<T>

com.amalgamasimulation.visualsets.VerticalGridLineVisualSet<T>

Type Parameters:

T - visual set data elements type

All Implemented Interfaces:

IClipboardTextPropertyOwner<String>, IUpdatePolicyPropertyOwner, IAbstractChartVisualSet, IGanttChartVisualSet, ILineChartVisualSet

public class VerticalGridLineVisualSet<T>
extends AbstractGridLineVisualSet<T>
implements ILineChartVisualSet, IGanttChartVisualSet, IClipboardTextPropertyOwner<String>

Visual set for drawing triangle markers.

Usually used to indicate some events on the time-relative X-axis.

Author:

Aleksey

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	VerticalGridLineVisualSet.VerticalGridLineVisualElement	Internal class that represents visual element for vertical grid data element.

Nested classes/interfaces inherited from class com.amalgamasimulation.visualsets.AbstractGridLineVisualSet

AbstractGridLineVisualSet.AbstractGridLineVisualElement, AbstractGridLineVisualSet.GridLineLabelPosition, AbstractGridLineVisualSet.GridLineLabelSide

Nested classes/interfaces inherited from class com.amalgamasimulation.visualsets.VisualSet

VisualSet.ContextMenuHandler<T>, VisualSet.UpdatePolicy, VisualSet.VisualElement

Field Summary

Fields

Modifier and Type	Field	Description
protected Function<String,String>	clipboardTextExtractor
protected Supplier<Boolean>	includeWhenCopyingToClipboard

Fields inherited from class com.amalgamasimulation.visualsets.AbstractGridLineVisualSet

labelColorExtractor, labelFontSizeExtractor, labelTextExtractor, labelTextPositionExtractor, labelTextSideExtractor, lineColorExtractor, lineWidthExtractor

Fields inherited from class com.amalgamasimulation.visualsets.VisualSet

argumentExtractor, contentsToBeginArguments, contentsToEndArguments, contentsToVisualElements, contextMenuHandlers, dataElementsProvider, listeners, maxArgument, maxValueCache, minArgument, minValueCache, mouseEnterHandlers, mouseExitHandlers, mousePressedHandlers, mouseTransparent, name, needsUpdate, oldContentsList, tooltipTextExtractor, updatePolicy, visibilityChangeHandlers, visualElementsList

Constructor Summary

Constructors

Constructor	Description
VerticalGridLineVisualSet(String name, Supplier<List<T>> dataElementsProvider, Function<T,Double> argumentExtractor)	Constructs a VerticalGridLineVisualSet with given name, data elements and arguments extractor, i.e.

Method Summary

Modifier and Type	Method	Description
VerticalGridLineVisualSet<T>	addContextMenuHandler(VisualSet.ContextMenuHandler<T> contextMenuHandler)	Adds the action to be executed every time a context menu for given data element is called.
VerticalGridLineVisualSet<T>	addMouseEnterHandler(BiConsumer<T,MouseEvent> handler)	Adds the action to be executed every time mouse enters to any visual element borders.
VerticalGridLineVisualSet<T>	addMouseExitHandler(BiConsumer<T,MouseEvent> handler)	Adds the action to be executed every time the mouse exits the previously entered element's bounds.
VerticalGridLineVisualSet<T>	addMousePressedHandler(BiConsumer<T,MouseEvent> handler)	Adds the action to be executed every time a mouse button is pressed.
VerticalGridLineVisualSet<T>	addVisibilityChangeHandler(Consumer<VisibilityChangeDescriptor<? extends IAbstractChartVisualSet>> visibilityChangeHandler)	Adds the action to be executed every time the visibility of this VisualSet is changed.
VerticalGridLineVisualSet<T>.VerticalGridLineVisualElement	createVisualElement(T contents)	Creates a new instance of VisualSet<T>.VisualElement corresponding to the current VisualSet type.
String	getClipboardText(String object)	Returns the text that will be copied to clipboard for the given object.
List<VerticalGridLineVisualSet<T>.VerticalGridLineVisualElement>	getVisualElements(boolean recalculationRequired)	Returns the list of visual elements corresponding to current data elements.
boolean	isIncludeWhenCopyingToClipboard()	Returns the value of the property includeWhenCopyingToClipboard.
VerticalGridLineVisualSet<T>	setClipboardText(Function<String,String> clipboardTextExtractor)	Sets the conversion method from values of each plot data element into text that will be copied to clipboard.
VerticalGridLineVisualSet<T>	setIncludeWhenCopyingToClipboard(Supplier<Boolean> includeWhenCopyingToClipboard)	Sets the supplier of the property includeWhenCopyingToClipboard.
VerticalGridLineVisualSet<T>	setLabelText(Function<T,String> labelTextExtractor, Function<T,Double> labelTextSizeExtractor, Function<T,Color> labelTextColorExtractor, Function<T,AbstractGridLineVisualSet.GridLineLabelPosition> labelTextPositionExtractor, Function<T,AbstractGridLineVisualSet.GridLineLabelSide> labelTextSideExtractor)	Sets the labels of the grid lines representing plot data elements.
VerticalGridLineVisualSet<T>	setLineColor(Function<T,Color> lineColorExtractor)	Sets the line color of the lines representing plot data elements.
VerticalGridLineVisualSet<T>	setLineWidth(Function<T,Double> lineWidthExtractor)	Sets the width of the grid lines representing plot data elements, in pixels.
VerticalGridLineVisualSet<T>	setMouseTransparent(boolean mouseTransparent)	Sets the value of the property mouseTransparent.
VerticalGridLineVisualSet<T>	setTooltipText(Function<T,String> tooltipTextExtractor)	Adds tooltip text to display when the mouse is hovered over a visual element representing given data element.
VerticalGridLineVisualSet<T>	setUpdatePolicy(VisualSet.UpdatePolicy updatePolicy)	Sets the new VisualSet.UpdatePolicy i.e.

Methods inherited from class com.amalgamasimulation.visualsets.AbstractGridLineVisualSet

getLabelColor, getLabelFontSize, getLabelText, getLabelTextPosition, getLabelTextSide, getLineColor, getLineWidth, getValue

Methods inherited from class com.amalgamasimulation.visualsets.VisualSet

addVisualElement, addVisualElement, addVisualSetChangeHandler, clearDependencies, getArgument, getContents, getContextMenuHandlers, getDataElements, getInjectionIndex, getMaxArgument, getMinArgument, getMouseEnterHandlers, getMouseExitHandlers, getMousePressedHandlers, getName, getTooltipText, getUpdatePolicy, getVisibilityChangeHandlers, getVisibleVisualElementIndex, getVisibleVisualElementsCount, isMouseTransparent, isNeedsUpdate, recalculateVisualElements, removeContextMenuHandler, removeMouseEnterHandler, removeMouseExitHandler, removeMousePressedHandler, removeVisibilityChangeHandler, removeVisualElement, removeVisualSetChangeHandler, sortVisualElements, toString, update, updateMinMaxArguments, updateMinMaxArgumentsValues

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.amalgamasimulation.visualsets.types.IAbstractChartVisualSet

addVisualSetChangeHandler, getContents, getMaxArgument, getMinArgument, getName, getUpdatePolicy, getVisibilityChangeHandlers, getVisibleVisualElementsCount, isMouseTransparent, removeVisibilityChangeHandler, removeVisualSetChangeHandler

Field Details

clipboardTextExtractor

protected Function<String,String> clipboardTextExtractor

includeWhenCopyingToClipboard

protected Supplier<Boolean> includeWhenCopyingToClipboard

Constructor Details

VerticalGridLineVisualSet

public VerticalGridLineVisualSet(String name,
 Supplier<List<T>> dataElementsProvider,
 Function<T,Double> argumentExtractor)

Constructs a VerticalGridLineVisualSet with given name, data elements and arguments extractor, i.e. a function that specifies the rule for extracting an argument from a data element.

Parameters:

name - visual set name is used to sort and name the visual sets on the chart

dataElementsProvider - data elements list provider. The provider is invalidated every time the chart is beging redrawn

argumentExtractor - a function that specifies the rule for extracting an argument from a data element

Method Details

setLineColor

public VerticalGridLineVisualSet<T> setLineColor(Function<T,Color> lineColorExtractor)

Description copied from class: AbstractGridLineVisualSet

Sets the line color of the lines representing plot data elements. The color of each element is set independently of the color of other elements. Transparent and semi-transparent colors are allowed.

Overrides:

setLineColor in class AbstractGridLineVisualSet<T>

Parameters:

lineColorExtractor - new line color of the plot

Returns:

reference to this object

setLineWidth

public VerticalGridLineVisualSet<T> setLineWidth(Function<T,Double> lineWidthExtractor)

Description copied from class: AbstractGridLineVisualSet

Sets the width of the grid lines representing plot data elements, in pixels. The width of each grid line is set independently of the width of other grid lines.

Overrides:

setLineWidth in class AbstractGridLineVisualSet<T>

Parameters:

lineWidthExtractor - new line width of the plot, in pixels

Returns:

reference to this object

setTooltipText

public VerticalGridLineVisualSet<T> setTooltipText(Function<T,String> tooltipTextExtractor)

Description copied from class: VisualSet

Adds tooltip text to display when the mouse is hovered over a visual element representing given data element.

Overrides:

setTooltipText in class AbstractGridLineVisualSet<T>

Parameters:

tooltipTextExtractor - a function that specifies the rule for extracting a tooltip text from a data element

Returns:

reference to this object

setClipboardText

public VerticalGridLineVisualSet<T> setClipboardText(Function<String,String> clipboardTextExtractor)

Description copied from interface: IClipboardTextPropertyOwner

Sets the conversion method from values of each plot data element into text that will be copied to clipboard.

Specified by:

setClipboardText in interface IClipboardTextPropertyOwner<T>

Parameters:

clipboardTextExtractor - an extractor that converts the value of each plot data element into text that will be copied to the clipboard

Returns:

reference to this object

getClipboardText

public String getClipboardText(String object)

Description copied from interface: IClipboardTextPropertyOwner

Returns the text that will be copied to clipboard for the given object.

Specified by:

getClipboardText in interface IClipboardTextPropertyOwner<T>

Parameters:

object - object for which the clipboard text is being checked

Returns:

the text that will be copied to clipboard for the given object

setLabelText

public VerticalGridLineVisualSet<T> setLabelText(Function<T,String> labelTextExtractor,
 Function<T,Double> labelTextSizeExtractor,
 Function<T,Color> labelTextColorExtractor,
 Function<T,AbstractGridLineVisualSet.GridLineLabelPosition> labelTextPositionExtractor,
 Function<T,AbstractGridLineVisualSet.GridLineLabelSide> labelTextSideExtractor)

Description copied from class: AbstractGridLineVisualSet

Sets the labels of the grid lines representing plot data elements. The label of each grid line is set independently of the labels of other grid lines. The label will not be displayed if the specified text is empty.

Overrides:

setLabelText in class AbstractGridLineVisualSet<T>

Parameters:

labelTextExtractor - the text of the label

labelTextSizeExtractor - the font size of the label

labelTextColorExtractor - the color of the label

labelTextPositionExtractor - the AbstractGridLineVisualSet.GridLineLabelPosition of the label

labelTextSideExtractor - the AbstractGridLineVisualSet.GridLineLabelSide of the label

Returns:

reference to this object

addContextMenuHandler

public VerticalGridLineVisualSet<T> addContextMenuHandler(VisualSet.ContextMenuHandler<T> contextMenuHandler)

Description copied from class: VisualSet

Adds the action to be executed every time a context menu for given data element is called.

Overrides:

addContextMenuHandler in class VisualSet<T>

Parameters:

contextMenuHandler - context menu call action

Returns:

reference to this object

addMouseEnterHandler

public VerticalGridLineVisualSet<T> addMouseEnterHandler(BiConsumer<T,MouseEvent> handler)

Description copied from class: VisualSet

Adds the action to be executed every time mouse enters to any visual element borders.

Overrides:

addMouseEnterHandler in class VisualSet<T>

Parameters:

handler - new mouse enter action

Returns:

reference to this object

addMouseExitHandler

public VerticalGridLineVisualSet<T> addMouseExitHandler(BiConsumer<T,MouseEvent> handler)

Description copied from class: VisualSet

Adds the action to be executed every time the mouse exits the previously entered element's bounds.

Overrides:

addMouseExitHandler in class VisualSet<T>

Parameters:

handler - new mouse exit action

Returns:

reference to this object

addMousePressedHandler

public VerticalGridLineVisualSet<T> addMousePressedHandler(BiConsumer<T,MouseEvent> handler)

Description copied from class: VisualSet

Adds the action to be executed every time a mouse button is pressed.

Overrides:

addMousePressedHandler in class VisualSet<T>

Parameters:

handler - new mouse button pressed action

Returns:

reference to this object

addVisibilityChangeHandler

public VerticalGridLineVisualSet<T> addVisibilityChangeHandler(Consumer<VisibilityChangeDescriptor<? extends IAbstractChartVisualSet>> visibilityChangeHandler)

Description copied from interface: IAbstractChartVisualSet

Adds the action to be executed every time the visibility of this VisualSet is changed.

Specified by:

addVisibilityChangeHandler in interface IAbstractChartVisualSet

Overrides:

addVisibilityChangeHandler in class VisualSet<T>

Parameters:

visibilityChangeHandler - visibility change action

Returns:

reference to this object

setMouseTransparent

public VerticalGridLineVisualSet<T> setMouseTransparent(boolean mouseTransparent)

Description copied from interface: IAbstractChartVisualSet

Sets the value of the property mouseTransparent. If true, this VisualSet is completely transparent to mouse events. When choosing target for mouse event, VisualSets with mouseTransparent set to true won't be taken into account.

Specified by:

setMouseTransparent in interface IAbstractChartVisualSet

Overrides:

setMouseTransparent in class VisualSet<T>

Parameters:

mouseTransparent - new value of property mouseTransparent

Returns:

reference to this object

getVisualElements

public List<VerticalGridLineVisualSet<T>.VerticalGridLineVisualElement> getVisualElements(boolean recalculationRequired)

Description copied from interface: IAbstractChartVisualSet

Returns the list of visual elements corresponding to current data elements. Cannot be changed by the user.

Specified by:

getVisualElements in interface IAbstractChartVisualSet

Specified by:

getVisualElements in interface IGanttChartVisualSet

Specified by:

getVisualElements in interface ILineChartVisualSet

Overrides:

getVisualElements in class VisualSet<T>

Parameters:

recalculationRequired - flag of the need to recalculate the visual elements

Returns:

the list of visual elements corresponding to current data elements

createVisualElement

public VerticalGridLineVisualSet<T>.VerticalGridLineVisualElement createVisualElement(T contents)

Description copied from class: VisualSet

Creates a new instance of VisualSet<T>.VisualElement corresponding to the current VisualSet type.

Specified by:

createVisualElement in class VisualSet<T>

Parameters:

contents - data element for which the VisualSet<T>.VisualElement is being checked

Returns:

a new instance of VisualSet<T>.VisualElement corresponding to the current VisualSet type

setUpdatePolicy

public VerticalGridLineVisualSet<T> setUpdatePolicy(VisualSet.UpdatePolicy updatePolicy)

Description copied from interface: IAbstractChartVisualSet

Sets the new VisualSet.UpdatePolicy i.e. the VisualSet update control rule.

Specified by:

setUpdatePolicy in interface IAbstractChartVisualSet

Specified by:

setUpdatePolicy in interface IUpdatePolicyPropertyOwner

Overrides:

setUpdatePolicy in class VisualSet<T>

Parameters:

updatePolicy - new VisualSet.UpdatePolicy i.e. the VisualSet update control rule

Returns:

reference to this object

setIncludeWhenCopyingToClipboard

public VerticalGridLineVisualSet<T> setIncludeWhenCopyingToClipboard(Supplier<Boolean> includeWhenCopyingToClipboard)

Description copied from interface: IClipboardTextPropertyOwner

Sets the supplier of the property includeWhenCopyingToClipboard. If true, this VisualSet is included when chart's data is copying to clipboard.

Specified by:

setIncludeWhenCopyingToClipboard in interface IClipboardTextPropertyOwner<T>

Parameters:

includeWhenCopyingToClipboard - new supplier of property includeWhenCopyingToClipboard

Returns:

reference to this object

isIncludeWhenCopyingToClipboard

public boolean isIncludeWhenCopyingToClipboard()

Description copied from interface: IClipboardTextPropertyOwner

Returns the value of the property includeWhenCopyingToClipboard. this VisualSet is included when chart's data is copying to clipboard.

Specified by:

isIncludeWhenCopyingToClipboard in interface IClipboardTextPropertyOwner<T>

Returns:

the value of the property includeWhenCopyingToClipboard