Class LineAnnotation


  • public final class LineAnnotation
    extends AbstractAnnotation
    Implements a LINE annotation which draws a line in the a chart.
    Vertical or horizontal lines are supported.
    Author:
    Andrea "Stock" Stocchero
    • Field Detail

      • DEFAULT_BORDER_WIDTH

        public static final int DEFAULT_BORDER_WIDTH
        Default line annotation border width, 2.
        See Also:
        Constant Field Values
    • Constructor Detail

      • LineAnnotation

        public LineAnnotation​(String id)
        Creates a line annotation to be added to an AnnotationOptions instance, using the ID passed as argument.
        Parameters:
        id - annotation id to apply to the object, as string
      • LineAnnotation

        public LineAnnotation​(AnnotationId id)
        Creates a line annotation to be added to an AnnotationOptions instance, using the ID passed as argument.
        Parameters:
        id - annotation id to apply to the object
      • LineAnnotation

        public LineAnnotation​(String id,
                              IsChart chart)
        Creates a line annotation to be added to an AnnotationOptions instance, using the ID passed as argument.
        The chart instance, passed as argument, must be the chart where the annotations will be applied and is used to get the whole default options in order to get the default for this object.
        Parameters:
        id - annotation id to apply to the object, as string
        chart - chart instance related to the plugin options
      • LineAnnotation

        public LineAnnotation​(AnnotationId id,
                              IsChart chart)
        Creates a line annotation to be added to an AnnotationOptions instance, using the ID passed as argument.
        The chart instance, passed as argument, must be the chart where the annotations will be applied and is used to get the whole default options in order to get the default for this object.
        Parameters:
        id - annotation id to apply to the object
        chart - chart instance related to the plugin options
    • Method Detail

      • getLabel

        public LineLabel getLabel()
        Returns the label on the line.
        Returns:
        the label on the line
      • setScaleID

        public void setScaleID​(String scaleId)
        Sets the ID of the scale to bind onto.
        Parameters:
        scaleId - the ID of the scale to bind onto
      • setScaleID

        public void setScaleID​(ScaleId scaleId)
        Sets the ID of the scale to bind onto.
        Parameters:
        scaleId - the ID of the scale to bind onto
      • getScaleID

        public ScaleId getScaleID()
        Returns the ID of the scale to bind onto.
        Returns:
        the ID of the scale to bind onto
      • setValue

        public void setValue​(String value)
        Sets the data value to draw the line at.
        Parameters:
        value - the data value to draw the line at
      • setValue

        public void setValue​(double value)
        Sets the data value to draw the line at.
        Parameters:
        value - the data value to draw the line at
      • setValue

        public void setValue​(Date value)
        Sets the data value to draw the line at.
        Parameters:
        value - the data value to draw the line at
      • getValueAsString

        public String getValueAsString()
        Returns the data value to draw the line at.
        Returns:
        the data value to draw the line at
      • getValueAsDouble

        public double getValueAsDouble()
        Returns the data value to draw the line at.
        Returns:
        the data value to draw the line at
      • getValueAsDate

        public Date getValueAsDate()
        Returns the data value to draw the line at.
        Returns:
        the data value to draw the line at
      • setEndValue

        public void setEndValue​(String endValue)
        Sets the data value at which the line draw should end.
        Parameters:
        endValue - the data value at which the line draw should end
      • setEndValue

        public void setEndValue​(double endValue)
        Sets the data value at which the line draw should end.
        Parameters:
        endValue - the data value at which the line draw should end
      • setEndValue

        public void setEndValue​(Date endValue)
        Sets the data value at which the line draw should end.
        Parameters:
        endValue - the data value at which the line draw should end
      • getEndValueAsString

        public String getEndValueAsString()
        Returns the data value at which the line draw should end.
        Returns:
        the data value at which the line draw should end
      • getEndValueAsDouble

        public double getEndValueAsDouble()
        Returns the data value at which the line draw should end.
        Returns:
        the data value at which the line draw should end
      • getEndValueAsDate

        public Date getEndValueAsDate()
        Returns the data value at which the line draw should end.
        Returns:
        the data value at which the line draw should end
      • getValueCallback

        public ValueCallback getValueCallback()
        Returns the callback called to set the left edge of the box, in units along the x axis.
        Returns:
        the callback called to set the left edge of the box, in units along the x axis
      • setValue

        public void setValue​(ValueCallback valueCallback)
        Sets the callback to set the left edge of the box, in units along the x axis.
        Parameters:
        valueCallback - to set the left edge of the box, in units along the x axis
      • setValue

        public void setValue​(NativeCallback valueCallback)
        Sets the callback to set the left edge of the box, in units along the x axis.
        Parameters:
        valueCallback - to set the left edge of the box, in units along the x axis
      • getEndValueCallback

        public ValueCallback getEndValueCallback()
        Returns the callback called to set the data value at which the line draw should end.
        Returns:
        the callback called to set the data value at which the line draw should end
      • setEndValue

        public void setEndValue​(ValueCallback valueCallback)
        Sets the callback to set the data value at which the line draw should end.
        Parameters:
        valueCallback - to set the data value at which the line draw should end
      • setEndValue

        public void setEndValue​(NativeCallback valueCallback)
        Sets the callback to set the data value at which the line draw should end.
        Parameters:
        valueCallback - to set the data value at which the line draw should end
      • getXScaleID

        public default ScaleId getXScaleID()
      • getYScaleID

        public default ScaleId getYScaleID()
      • getBorderWidth

        public default int getBorderWidth()
      • getXMaxAsString

        public default String getXMaxAsString()
        Returns the right edge of the box.
        Returns:
        the right edge of the box
      • getXMaxAsDouble

        public default double getXMaxAsDouble()
        Returns the right edge of the box.
        Returns:
        the right edge of the box
      • getXMaxAsDate

        public default Date getXMaxAsDate()
        Returns the right edge of the box.
        Returns:
        the right edge of the box
      • getXMinAsString

        public default String getXMinAsString()
        Returns the left edge of the box, in units along the x axis.
        Returns:
        the left edge of the box
      • getXMinAsDouble

        public default double getXMinAsDouble()
        Returns the left edge of the box, in units along the x axis.
        Returns:
        the left edge of the box
      • getXMinAsDate

        public default Date getXMinAsDate()
        Returns the left edge of the box, in units along the x axis.
        Returns:
        the left edge of the box
      • getYMaxAsString

        public default String getYMaxAsString()
        Returns the top edge of the box in units along the y axis.
        Returns:
        the top edge of the box in units along the y axis
      • getYMaxAsDouble

        public default double getYMaxAsDouble()
        Returns the top edge of the box in units along the y axis.
        Returns:
        the top edge of the box in units along the y axis
      • getYMaxAsDate

        public default Date getYMaxAsDate()
        Returns the top edge of the box in units along the y axis.
        Returns:
        the top edge of the box in units along the y axis
      • getYMinAsString

        public default String getYMinAsString()
        Returns the bottom edge of the box.
        Returns:
        the bottom edge of the box
      • getYMinAsDouble

        public default double getYMinAsDouble()
        Returns the bottom edge of the box.
        Returns:
        the bottom edge of the box
      • getYMinAsDate

        public default Date getYMinAsDate()
        Returns the bottom edge of the box.
        Returns:
        the bottom edge of the box
      • getXMinCallback

        public default ValueCallback getXMinCallback()
        Returns the callback called to set the left edge of the box, in units along the x axis.
        Returns:
        the callback called to set the left edge of the box, in units along the x axis
      • getXMaxCallback

        public default ValueCallback getXMaxCallback()
        Returns the callback called to set the right edge of the box.
        Returns:
        the callback called to set the right edge of the box
      • getYMinCallback

        public default ValueCallback getYMinCallback()
        Returns the callback called to set the left edge of the box, in units along the x axis.
        Returns:
        the callback called to set the left edge of the box, in units along the x axis
      • getYMaxCallback

        public default ValueCallback getYMaxCallback()
        Returns the callback called to set the right edge of the box.
        Returns:
        the callback called to set the right edge of the box
      • isDisplay

        public default boolean isDisplay()
        Returns true whether the annotation should be displayed.
        Returns:
        true whether the annotation should be displayed
      • isAdjustScaleRange

        public default boolean isAdjustScaleRange()
        Returns true whether the scale range should be adjusted if this annotation is out of range.
        Returns:
        true whether the scale range should be adjusted if this annotation is out of range
      • getDrawTime

        public default DrawTime getDrawTime()
        Returns the draw time which defines when the annotations are drawn.
        Returns:
        the draw time which defines when the annotations are drawn
      • getBorderColorAsString

        public default String getBorderColorAsString()
        Returns the color of the border of annotation.
        Returns:
        the color of the border of annotation
      • getBorderDash

        public default List<Integer> getBorderDash()
        Returns the line dash pattern used when stroking lines, using an array of values which specify alternating lengths of lines and gaps which describe the pattern.
        Returns:
        the line dash pattern used when stroking lines, using an array of values which specify alternating lengths of lines and gaps which describe the pattern
      • getBorderDashOffset

        public default double getBorderDashOffset()
        Returns the line dash pattern offset.
        Returns:
        the line dash pattern offset
      • getEnterCallback

        public default EnterCallback getEnterCallback()
        Returns the callback called when a "enter" event is occurring.
        Returns:
        the callback called when a "enter" event is occurring
      • getLeaveCallback

        public default LeaveCallback getLeaveCallback()
        Returns the callback called when a "leave" event is occurring.
        Returns:
        the callback called when a "leave" event is occurring
      • getClickCallback

        public default ClickCallback getClickCallback()
        Returns the callback called when a "click" event is occurring.
        Returns:
        the callback called when a "click" event is occurring
      • getDoubleClickCallback

        public default DoubleClickCallback getDoubleClickCallback()
        Returns the callback called when a "dblclick" event is occurring.
        Returns:
        the callback called when a "dblclick" event is occurring
      • getDrawTimeCallback

        public default DrawTimeCallback getDrawTimeCallback()
        Returns the callback called to set the draw time which defines when the annotations are drawn.
        Returns:
        the callback called to set the draw time which defines when the annotations are drawn
      • getDisplayCallback

        public default DisplayCallback<AnnotationContext> getDisplayCallback()
        Returns the callback called to set the display options.
        Returns:
        the callback called to set the display options
      • getBorderColorCallback

        public default ColorCallback<AnnotationContext> getBorderColorCallback()
        Returns the callback called to set the color of the border of annotation.
        Returns:
        the callback called to set the color of the border of annotation
      • getBorderWidthCallback

        public default WidthCallback<AnnotationContext> getBorderWidthCallback()
        Returns the callback called to set the width of the border in pixels.
        Returns:
        the callback called to set the width of the border in pixels
      • getBorderDashCallback

        public default BorderDashCallback<AnnotationContext> getBorderDashCallback()
        Returns the callback called to set the line dash pattern used when stroking lines, using an array of values which specify alternating lengths of lines and gaps which describe the pattern.
        Returns:
        the callback called to set the line dash pattern used when stroking lines, using an array of values which specify alternating lengths of lines and gaps which describe the pattern
      • getBorderDashOffsetCallback

        public default BorderDashOffsetCallback<AnnotationContext> getBorderDashOffsetCallback()
        Returns the callback called to set the line dash pattern offset.
        Returns:
        the callback called to set the line dash pattern offset
      • getAdjustScaleRangeCallback

        public default AdjustScaleRangeCallback getAdjustScaleRangeCallback()
        Returns the callback called to set whether the scale range should be adjusted if this annotation is out of range.
        Returns:
        the callback called to set whether the scale range should be adjusted if this annotation is out of range
      • setXScaleID

        public final void setXScaleID​(String scaleId)
        Sets the ID of the X scale to bind onto.
        Parameters:
        scaleId - the ID of the X scale to bind onto
      • setXScaleID

        public final void setXScaleID​(ScaleId scaleId)
        Sets the ID of the X scale to bind onto.
        Parameters:
        scaleId - the ID of the X scale to bind onto
      • getXScaleID

        public final ScaleId getXScaleID()
        Returns the ID of the X scale to bind onto.
        Returns:
        the ID of the X scale to bind onto
      • setXMax

        public final void setXMax​(String max)
        Sets the right edge of the box.
        Parameters:
        max - the right edge of the box
      • setXMax

        public final void setXMax​(double max)
        Sets the right edge of the box.
        Parameters:
        max - the right edge of the box
      • setXMax

        public final void setXMax​(Date max)
        Sets the right edge of the box.
        Parameters:
        max - the right edge of the box
      • getXMaxAsString

        public final String getXMaxAsString()
        Returns the right edge of the box.
        Returns:
        the right edge of the box
      • getXMaxAsDouble

        public final double getXMaxAsDouble()
        Returns the right edge of the box.
        Returns:
        the right edge of the box
      • getXMaxAsDate

        public final Date getXMaxAsDate()
        Returns the right edge of the box.
        Returns:
        the right edge of the box
      • setXMin

        public final void setXMin​(String min)
        Sets the left edge of the box, in units along the x axis.
        Parameters:
        min - the left edge of the box
      • setXMin

        public final void setXMin​(double min)
        Sets the left edge of the box, in units along the x axis.
        Parameters:
        min - the left edge of the box
      • setXMin

        public final void setXMin​(Date min)
        Sets the left edge of the box, in units along the x axis.
        Parameters:
        min - the left edge of the box
      • getXMinAsString

        public final String getXMinAsString()
        Returns the left edge of the box, in units along the x axis.
        Returns:
        the left edge of the box
      • getXMinAsDouble

        public final double getXMinAsDouble()
        Returns the left edge of the box, in units along the x axis.
        Returns:
        the left edge of the box
      • getXMinAsDate

        public final Date getXMinAsDate()
        Returns the left edge of the box, in units along the x axis.
        Returns:
        the left edge of the box
      • setYScaleID

        public final void setYScaleID​(String scaleId)
        Sets the ID of the Y scale to bind onto.
        Parameters:
        scaleId - the ID of the Y scale to bind onto
      • setYScaleID

        public final void setYScaleID​(ScaleId scaleId)
        Sets the ID of the Y scale to bind onto.
        Parameters:
        scaleId - the ID of the Y scale to bind onto
      • getYScaleID

        public final ScaleId getYScaleID()
        Returns the ID of the Y scale to bind onto.
        Returns:
        the ID of the Y scale to bind onto
      • setYMax

        public final void setYMax​(String max)
        Sets the top edge of the box in units along the y axis.
        Parameters:
        max - the top edge of the box in units along the y axis
      • setYMax

        public final void setYMax​(double max)
        Sets the top edge of the box in units along the y axis.
        Parameters:
        max - the top edge of the box in units along the y axis
      • setYMax

        public final void setYMax​(Date max)
        Sets the top edge of the box in units along the y axis.
        Parameters:
        max - the top edge of the box in units along the y axis
      • getYMaxAsString

        public final String getYMaxAsString()
        Returns the top edge of the box in units along the y axis.
        Returns:
        the top edge of the box in units along the y axis
      • getYMaxAsDouble

        public final double getYMaxAsDouble()
        Returns the top edge of the box in units along the y axis.
        Returns:
        the top edge of the box in units along the y axis
      • getYMaxAsDate

        public final Date getYMaxAsDate()
        Returns the top edge of the box in units along the y axis.
        Returns:
        the top edge of the box in units along the y axis
      • setYMin

        public final void setYMin​(String min)
        Sets the bottom edge of the box.
        Parameters:
        min - the bottom edge of the box
      • setYMin

        public final void setYMin​(double min)
        Sets the bottom edge of the box.
        Parameters:
        min - the bottom edge of the box
      • setYMin

        public final void setYMin​(Date min)
        Sets the bottom edge of the box.
        Parameters:
        min - the bottom edge of the box
      • getYMinAsString

        public final String getYMinAsString()
        Returns the bottom edge of the box.
        Returns:
        the bottom edge of the box
      • getYMinAsDouble

        public final double getYMinAsDouble()
        Returns the bottom edge of the box.
        Returns:
        the bottom edge of the box
      • getYMinAsDate

        public final Date getYMinAsDate()
        Returns the bottom edge of the box.
        Returns:
        the bottom edge of the box
      • getXMinCallback

        public final ValueCallback getXMinCallback()
        Returns the callback called to set the left edge of the box, in units along the x axis.
        Returns:
        the callback called to set the left edge of the box, in units along the x axis
      • setXMin

        public final void setXMin​(ValueCallback valueCallback)
        Sets the callback to set the left edge of the box, in units along the x axis.
        Parameters:
        valueCallback - to set the left edge of the box, in units along the x axis
      • setXMin

        public final void setXMin​(NativeCallback valueCallback)
        Sets the callback to set the left edge of the box, in units along the x axis.
        Parameters:
        valueCallback - to set the left edge of the box, in units along the x axis
      • getXMaxCallback

        public final ValueCallback getXMaxCallback()
        Returns the callback called to set the right edge of the box.
        Returns:
        the callback called to set the right edge of the box
      • setXMax

        public final void setXMax​(ValueCallback valueCallback)
        Sets the callback to set the right edge of the box.
        Parameters:
        valueCallback - to set the right edge of the box
      • setXMax

        public final void setXMax​(NativeCallback valueCallback)
        Sets the callback to set the right edge of the box.
        Parameters:
        valueCallback - to set the right edge of the box
      • getYMinCallback

        public final ValueCallback getYMinCallback()
        Returns the callback called to set the bottom edge of the box.
        Returns:
        the callback called to set the bottom edge of the box
      • setYMin

        public final void setYMin​(ValueCallback valueCallback)
        Sets the callback to set the bottom edge of the box.
        Parameters:
        valueCallback - to set the bottom edge of the box
      • setYMin

        public final void setYMin​(NativeCallback valueCallback)
        Sets the callback to set the bottom edge of the box.
        Parameters:
        valueCallback - to set the bottom edge of the box
      • getYMaxCallback

        public final ValueCallback getYMaxCallback()
        Returns the callback called to set the top edge of the box in units along the y axis.
        Returns:
        the callback called to set the top edge of the box in units along the y axis
      • setYMax

        public final void setYMax​(ValueCallback valueCallback)
        Sets the callback to set the top edge of the box in units along the y axis.
        Parameters:
        valueCallback - to set the top edge of the box in units along the y axis
      • setYMax

        public final void setYMax​(NativeCallback valueCallback)
        Sets the callback to set the top edge of the box in units along the y axis.
        Parameters:
        valueCallback - to set the top edge of the box in units along the y axis