Package quadbase.util

Interface ILegend

All Superinterfaces:
IGradientPropertySet, IGradientSupport, IPlot
public interface ILegend extends IPlot
This interface contains methods to modify properties associated with the primary and secondary chart legends. A handle to a legend object for the primary axis can be obtained by calling the gethLegend method defined in QbChart.

A handle to a legend object for the secondary axis can be obtained by calling the gethLegend method defined in the ISecondaryChart interface.

See Also:

  • Method Details

    • gethText

      IText gethText()
      This function is used to get a handle to the IText object for modifying the font-related properties of the legend.

      Associated QbChart properties: 

       
   LEGEND_FONT             SLEGEND_FONT
   LEGEND_FONTCOLOR        SLEGEND_FONTCOLOR
   LEGEND_FONTANGLE        SLEGEND_FONTANGLE
      Returns:
      A handle to IText for modifying font properties associated with the legend text.

    • setTitle

      void setTitle(String t)
      Sets the title of the legend in the chart without secondary axis.
      Parameters:
      t - The title string for the legend.

    • setLineSpacing

      void setLineSpacing(int gap)
      Adds a set amount of white space between legend lines Default value is 0
      Parameters:
      gap - the amount of space added between legend lines

    • getLineSpacing

      int getLineSpacing()
      Returns the line space set by the setLineSpacing method

    • isVisible

      boolean isVisible()
      Returns the display status of the primary or secondary legend in the chart.

      Associated QbChart property: 

       
   DRAW_LEGEND
   DRAW_SLEGEND
      Returns:
      True if the legend is visible, false otherwise.

    • setVisible

      void setVisible(boolean b)
      Sets the display status of the primary or secondary legend in the chart.
      Parameters:
      b - The display status for the legend.

    • getLayout

      int getLayout()
      Returns the layout of the primary or secondary legend.

      Associated QbChart property: 

       
   LEGEND_LAYOUT
   SLEGEND_LAYOUT
      Returns:
      The layout as: QbChart.HORIZONTAL, QbChart.VERTICAL, QbChart.SQUARE_LEGEND or QbChart.FIXED_COLUMN

    • setLayout

      void setLayout(int x)
      Sets the layout of the primary/secondary legend to horizontal, vertical, square or fixed column.
      Parameters:
      x - QbChart.VERTICAL, QbChart.HORIZONTAL, QbChart.SQUARE_LEGEND or QbChart.FIXED_COLUMN

    • getNumberOfFixedColumn

      int getNumberOfFixedColumn()
      Returns the number of columns are displayed in legend when fixed-column layout is in used
      Returns:
      number of column

    • setNumberOfFixedColumn

      void setNumberOfFixedColumn(int val)
      Sets the number of columns are displayed in legend when fixed-column layout is in used
      Parameters:
      val - number of column

    • areLabelsReversed

      boolean areLabelsReversed()
      Returns whether or not the labels in the legend are displayed in reverse order.

      Associated QbChart property: 

       
   LEGEND_REVERSELABEL
   SLEGEND_REVERSELABEL
      Returns:
      True if legend labels are displayed in reverse order, false otherwise.

    • setLabelsReversed

      void setLabelsReversed(boolean b)
      Enables/Disables the display of legend labels in reverse order.
      Parameters:
      b - Set to true to display labels in reverse order, false otherwise.

    • areItemsHidden

      boolean[] areItemsHidden(int colIndex)
      Returns the boolean state of the items in the legend.

      Associated QbChart property: HIDE_LEGENDITEMS

      Parameters:
      colIndex - The column number of the category or secondary value column used in the chart.
      Returns:
      An array of booleans, where each element in the array contains the display status of the corresponding legend item. The size of the array is equal to the number of points in the category column.

    • setItemsHidden

      void setItemsHidden(int colIndex, boolean[] b)
      Sets the boolean state of the items in the legend.
      Parameters:
      colIndex - The column number of the category or secondary value column used in the chart.
      b - The array of booleans containing the display status of each element in the legend.
      See Also:
      • invalid reference 
        ILegend#areItemsHidded

    • setDrawSymbols

      void setDrawSymbols(boolean drawSym)
      Sets the state of the data point symbols in the legend. If set to true, the symbols are drawn in the legend.
      Parameters:
      drawSym - Set to true if symbols should be drawn in the legend.

    • areSymbolsDrawn

      boolean areSymbolsDrawn()
      Returns whether or not data point symbols are drawn in the legend.
      Returns:
      True if symbols are drawn, false otherwise.

    • setDrawSymbolWithLine

      void setDrawSymbolWithLine(boolean drawSymWithLine)
      Sets the state of drawing a line behind the data point symbols in the legend. If set to true, a line is drawn behind the symbol in the legend.
      Parameters:
      drawSymWithLine - Set to true if line should be drawn behind the symbols in the legend.

    • isDrawSymbolWithLine

      boolean isDrawSymbolWithLine()
      Returns whether or not a line is drawn behind the symbol in the legend.
      Returns:
      True if line is drawn behind the symbol, false otherwise.

    • setSymbolSizeRatio

      void setSymbolSizeRatio(int ratio)
      set the symbol size ratio default value is 100%
      Parameters:
      ratio -

    • getSymbolSizeRatio

      int getSymbolSizeRatio()
      return the symbol size ratio default value is 100%
      Returns:
      the symbol size ratio