Class BaseAxis

java.lang.Object
com.inet.report.chart.axis.BaseAxis
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
ContinuousDateAxis, DiscreteNumberAxis, GroupAxis

public class BaseAxis extends Object implements Serializable
Basic class for a chart axis. This class contains the basic properties and methods for chart axes.
To resolve which axis type is used by each chart style please see the set function of the chart plot according to your style. E.g. BarStyle belongs to the plot BarPlot. This uses a GroupAxis as category axis (see BarPlot.setCategoryAxis(GroupAxis)) and a ContinuousNumberAxis as data axis (see BarPlot.setDataAxis(ContinuousNumberAxis)).
Since:
8.0
See Also:
  • Field Details

    • DEFAULT_TICK_LABEL_COLOR

      public static final int DEFAULT_TICK_LABEL_COLOR
      The default axis label color (the ABGR value representation).
      See Also:
    • DEFAULT_TICK_LABEL_FONT

      public static final Font DEFAULT_TICK_LABEL_FONT
      The default axis tick labels font.
    • DEFAULT_GRIDLINE_COLOR

      public static final int DEFAULT_GRIDLINE_COLOR
      The default grid lines color (the ABGR value representation).
    • DEFAULT_AXIS_LINE_COLOR

      public static final int DEFAULT_AXIS_LINE_COLOR
      The default axis color (the ABGR value representation).
    • DEFAULT_TITLE

      public static final ChartTitle DEFAULT_TITLE
      Default title of this axis.
    • TOKEN_CATEGORY_AXIS

      public static final String TOKEN_CATEGORY_AXIS
      XML token for a category axis element.
      See Also:
    • TOKEN_SERIES_AXIS

      public static final String TOKEN_SERIES_AXIS
      XML token for a series axis element.
      See Also:
    • TOKEN_DATA_AXIS

      public static final String TOKEN_DATA_AXIS
      XML token for a data axis element.
      See Also:
  • Constructor Details

    • BaseAxis

      public BaseAxis()
      Creates a instance of BaseAxis, sets the default properties. To disable the axis from being shown use AxisPosition.NONE.
      Since:
      8.0
  • Method Details

    • isGridlinesVisible

      public boolean isGridlinesVisible()
      Returns whether or not the axis grid lines are visible.
      Returns:
      whether or not the axis grid lines are visible
      Since:
      8.0
      See Also:
    • setGridlinesVisible

      public void setGridlinesVisible(boolean gridlinesVisible)
      Sets whether or not the axis grid lines are visible.
      Parameters:
      gridlinesVisible - whether or not the axis grid lines are visible
      Since:
      8.0
      See Also:
    • getGridlineColor

      public int getGridlineColor()
      Returns the ABGR value representing the grid lines color.
      Returns:
      the grid lines color.
      Since:
      8.0
      See Also:
    • setGridlineColor

      public void setGridlineColor(int gridlineColor)
      Sets the ABGR components of the grid lines color.
      Parameters:
      gridlineColor - the color
      Throws:
      IllegalArgumentException - by RDC.COLOR_NO_COLOR.
      Since:
      8.0
      See Also:
    • getAxisLineColor

      public int getAxisLineColor()
      Returns the ABGR value representing the axis line color.
      Returns:
      the axis line color.
      Since:
      8.0
      See Also:
    • isInverseOrder

      public boolean isInverseOrder()
      Returns the orientation of the values on the axis.
      Returns:
      true if inverse order, false otherwise
      Since:
      8.0
      See Also:
    • setInverseOrder

      public void setInverseOrder(boolean inverseOrder)
      Sets the orientation of the values on the axis -true if inverse, false otherwise
      Parameters:
      inverseOrder - the orientation of the values on the axis
      Since:
      8.0
      See Also:
    • setAxisLineColor

      public void setAxisLineColor(int axisLineColor)
      Sets the ABGR components of the axis line color.
      Parameters:
      axisLineColor - the color
      Throws:
      IllegalArgumentException - by RDC.COLOR_NO_COLOR.
      Since:
      8.0
      See Also:
    • getTitle

      public ChartTitle getTitle()
      Gets the title of this axis
      Returns:
      the axis title
      Since:
      8.0
      See Also:
    • setTitle

      public void setTitle(ChartTitle title)
      Sets the title of this axis. To disable the title use setAxisPosition(AxisPosition.NONE)
      Parameters:
      title - the axis title (null not permitted)
      Since:
      8.0
      See Also:
    • getTickLabelFont

      public Font getTickLabelFont()
      Returns the font of tick labels on this axis.
      Returns:
      the tick label font.
      Since:
      8.0
      See Also:
    • setTickLabelFont

      public void setTickLabelFont(Font tickLabelFont)
      Sets the font of tick labels on this axis.
      Parameters:
      tickLabelFont - the axis tick labels font (null not permitted)
      Since:
      8.0
      See Also:
    • getTickLabelColor

      public int getTickLabelColor()
      Returns the color as ABGR value of tick labels on this axis.
      Returns:
      the ABGR value representing the label color.
      Since:
      8.0
      See Also:
    • setTickLabelColor

      public void setTickLabelColor(int tickLabelColor)
      Sets the color as ABGR value of tick labels on this axis.
      Parameters:
      tickLabelColor - ABGR components of the axis labels color
      Throws:
      IllegalArgumentException - by RDC.COLOR_NO_COLOR.
      Since:
      8.0
      See Also:
    • getTickLabelFormat

      public ChartFormat getTickLabelFormat()
      Returns a tick label format of this axis. The default value of this property is null, that means the chart formats the axis values automatically.
      Returns:
      the format or null to auto format
      Since:
      8.0
      See Also:
    • setTickLabelFormat

      public void setTickLabelFormat(ChartFormat tickLabelFormat)
      Sets the tick label format. The default value of this property is null, that means the chart formats the axis values automatically. Note: for charts with number values on the axis, only formats extended from NumberFormat are allowed, and date charts, only formats extended from DateFormat are allowed.
      Parameters:
      tickLabelFormat - the format (null permitted)
      Throws:
      IllegalArgumentException - by date format for number values
      Since:
      8.0
      See Also:
    • getAxisPosition

      public AxisPosition getAxisPosition()
      Returns the relative position of this axis on the chart. A y-axis with position AxisPosition.ON_MIN will be placed on the left side of chart.
      Returns:
      the axis position
      Since:
      8.0
      See Also:
    • setAxisPosition

      public void setAxisPosition(AxisPosition position)
      Sets the position of this axis on the chart or disables the axis from being shown, if AxisPosition.NONE is passed. A y-axis with position AxisPosition.ON_MIN will be placed on the left side of chart.
      Parameters:
      position - the axis position (null not permitted)
      Throws:
      IllegalArgumentException - if position is null.
      Since:
      8.0
      See Also:
    • copyTo

      public void copyTo(BaseAxis that)
      Copies the properties of this axis to the new axis.
      Parameters:
      that - the new axis to copy the properties to
      Since:
      8.0
    • saveProperties

      public void saveProperties(PrintWriter out, int depth, String axisType)
      Writes the axis properties to the output stream as XML
      Parameters:
      out - the output stream to write to
      depth - the depth of whitespace indent to prefix each line with
      axisType - type of this axis: "category", "series" or "data"
      Since:
      8.0
    • getSubProperties

      protected StringBuilder getSubProperties(int depth)
      Returns the serialized properties of subclasses.
      Parameters:
      depth - the depth of XML indent
      Returns:
      the properties.
      Since:
      8.0
    • saveSubProperties

      protected void saveSubProperties(PrintWriter out, int depth)
      Writes the intern axis properties to output. Overwrites this to save intern properties direct to PrintWriter without building a StringBuilder.
      Parameters:
      out - the output
      depth - the depth of XML indent
      Since:
      8.0
    • readProperties

      public void readProperties(Element element, Chart2 chart)
      Loads the XML properties of a chart axis.
      Parameters:
      element - DOM element to read the properties from
      chart - the chart this axis belongs to
      Since:
      8.0
      See Also:
    • getReferencedObjects

      public List<Object> getReferencedObjects()
      Get FormulaFields referenced by this Axis.
      Can be from marker (if this is MarkerAxis) or from title.
      Returns:
      a list with referenced fields, can be empty.
      Since:
      11.2