Package quadbase.ChartAPI.swing

Class QbChart

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JPanel
quadbase.ChartAPI.swing.QbChartPanel
quadbase.ChartAPI.swing.QbChartBasic
quadbase.ChartAPI.swing.QbChart
All Implemented Interfaces:
ActionListener, ImageObserver, MenuContainer, Externalizable, Serializable, EventListener, Accessible, IExportConstants, IMiscConstants, quadbase.chartviewer.swing.IChartHolder, quadbase.common.util.internal.IChart, IChartTypeConstants, IMapConstants
Direct Known Subclasses:
DrillDownChart
public class QbChart extends quadbase.ChartAPI.swing.QbChartBasic implements IChartTypeConstants, IExportConstants, quadbase.common.util.internal.IChart
This class creates a chart object which extends java.awt.Component. Associated with this component, is an elobarate Java API that is contained in the quadbase.util and this (quadbase.ChartAPI.swing) package. Several chart types (and their combinations) are available, as enumerated in the interface quadbase.util.IChartTypeConstants. Both two and three dimensional charts are supported.

To create a new chart, a user must specify the chart type, the dimension (2D or 3D), the input data source information, and a mapping of the data columns to the respective axes. If the chart is used in an applet, the applet handle must also be specified. Data may be obtained either from a database, a data file, or directly as arguments. An optional chart template may be provided for specifying attributes. A chart can also be loaded from a CHT or TPL file (see below).

For persistence, a chart may be exported to either a proprietary CHT format, a template (TPL) format, or any of the common image formats (including BMP, GIF, JPEG, PNG, SVG and Flash). The format contants are enumerated in the interface IExportContants. A chart object can be re-created from a CHT or TPL format. A CHT format contains all chart information including the data used therein. A TPL format contains all chart attributes except the data itself, which is reloaded from the original data source at the time of creation. In addition, this class supports serialization by implementing the java.io.Externalizable interface.

In its default mode, a chart component uses the services of a chart server in order to read and write files. The chart server additionally provides access to native libraries for faster image export. This is especially necessary when the chart is being used within an applet, in which case direct read/write access to files may be disabled for security reasons, and ODBC drivers (if any) are unavailable on the client. The chart server is located (by an IP address and socket port) using a file called "server.cfg", which is assumed to exist in the same directory as the code base of the applet, or the current directory of the application.

A chart can also be configured to run without the help of a chart server (using the method setChartServerUsed(boolean)). This mode can be used in an application, where there are no security restrictions for direct file I/O and database access. In such a case, the chart attempts to read and write files, and load database drivers directly.

Hundreds of chart properties can be specified. In order to facilitate use, the most properties have been categorized into groups and exposed in the form of interfaces. An application may first obtain a handle to a group interface using a gethXXX method, and then manipulate the chart's properties directly by calling methods on this interface. (See the quadbase.util package documentation for details on the interfaces.) For example, the following code sets the chart's title, and changes its background color : 


 import java.applet.Applet;
 import java.awt.*;
 import quadbase.ChartAPI.swing.QbChart;
 import quadbase.util.*;

 public class MyChartApplet extends Applet {
        QbChart chart;

        public void init() {

                // Load an existing chart from a CHT file
                chart = new QbChart(this, "help/examples/data/col2d.cht");

                // Get a handle to the title
                ITextString title = chart.gethMainTitle();

                // Call methods on the handle to change title
                title.setValue("New Title");

                // Get a handle to the ICanvas interface and change background color
                chart.gethCanvas().setBackgroundColor(Color.white);

                setLayout(new BorderLayout());
                add("Center", chart);
        }
 }

(Note that the old setProp and getProp methods have been removed.) A chart may be repainted by calling the repaint() method once any of its properties are changed. Also, the chart data may be reloaded from the data source by calling its refresh() method.

The chart component is also available as a JavaBean.

Note : File names may be specified either as URL strings, or using relative/ absolute paths. Path names are interpreted as being relative to the current directory of the chart server (if used), or the current application (if server not used).

See Also:

  • Field Details

  • Constructor Details

    • QbChart

      public QbChart()
      Create a new chart. The properties of the chart (including the applet, chart type, and data column mapping may be specified later using the appropriate methods.

    • QbChart

      public QbChart(quadbase.chart.Chart chart)

    • QbChart

      public QbChart(Applet applet, String fileName)
      Create a new chart using a CHT/TPL chart file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - the applet containing the chart. Use "(Applet) null" if used within an application.
      fileName - name of the chart file (with a .cht or .tpl extension). This can either be a URL, or a path name accessible by chart server (if the server is used). In the latter case, the path name can be either absolute, or relative to the current directory of the chart server.

    • QbChart

      public QbChart(Applet applet, String fileName, Object[] parameter)

    • QbChart

      public QbChart(Applet applet, String fileName, Object[] parameter, boolean isEnterpriseServer)

    • QbChart

      public QbChart(Applet applet, String fileName, Object[] parameter, Properties props)

    • QbChart

      public QbChart(Applet applet, String fileName, boolean isEnterpriseServer)
      For internal use only.

    • QbChart

      @Deprecated public QbChart(Frame frame, String fileName)
      Deprecated.
      Please use the constructor having the applet parameter. Use "(Applet) null" as the first argument.
      Create a new chart using a CHT/TPL chart file.
      Use this constructor if the chart is used in an application, If the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      frame - a Frame
      fileName - name of the chart file (with a .cht or .tpl extension). This can either be a URL, or a path name accessible by chart server (if the server is used). In the latter case, the path name be either be absolute, or relative to the current directory of the chart server. output by chart designer

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, IDatabaseInfo dbinfo, IColumnMap cmap)
      Create a new chart with specific chart type and dimension. Input data is read from a database.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - the applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use constant VIEW2D or VIEW3D to specify 2D or 3D chart
      dbinfo - database information, see interface IDatabaseInfo
      cmap - column information use to specify which column is use to plot data, see interface IColumnMap for details

    • QbChart

      @Deprecated public QbChart(Frame frame, int dimension, int chartType, IDatabaseInfo dbinfo, IColumnMap cmap)
      Deprecated.
      Please use the constructor having the applet parameter. Use "(Applet) null" as the first argument
      Create a new chart with specific chart type and dimension. Source data is read from a database.
      Use this constructor if the chart is used in an application, If the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      frame - a Frame
      dimension - use constant VIEW2D or VIEW3D to specify 2D or 3D chart
      dbinfo - database information, see interface IDatabaseInfo
      cmap - column information use to specify which column is use to plot data, see interface IColumnMap for details

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, IDatabaseInfo dbinfo, IColumnMap cmap, String template)
      Create a new chart, given the chart type, dimension, and a template. Input data is read from a database. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      dbinfo - database information, see interface IDatabaseInfo
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, IDatabaseInfo dbinfo, boolean doTransposeData, IColumnMap cmap, String template)
      Create a new chart, given the chart type, dimension, and a template. Input data is read from a database. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      dbinfo - database information, see interface IDatabaseInfo
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set having three columns : RowLabel, ColumnLabel, and Value.
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, IDatabaseInfo dbinfo, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, String template)
      Create a new chart, given the chart type, dimension, and a template. Input data is read from a database. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      dbinfo - database information, see interface IDatabaseInfo
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set
      transposeCol - transposing selected column
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      @Deprecated public QbChart(Frame frame, int dimension, int chartType, IDatabaseInfo dbinfo, IColumnMap cmap, String template)
      Deprecated.
      Please use the constructor having the applet parameter. Use "(Applet) null" as the first argument.
      Create a new chart giving a chart type, dimension, and a template. Input data is read from a database. Other attributes of the chart are read from the template file.
      Use this constructor if the chart is used in an application, If the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      frame - a Frame
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      dbinfo - database information, see interface IDatabaseInfo
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl)

    • QbChart

      @Deprecated public QbChart(Applet applet, int dimension, int chartType, String dataFile, IColumnMap cmap)
      Deprecated.
      Please use the constructor having a template as its last argument. Then use null as the last argument.
      Create a new chart, given the chart type and dimension. Input data is read from a data file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      dataFile - source data file, see database file format for details
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details

    • QbChart

      @Deprecated public QbChart(Frame frame, int dimension, int chartType, String dataFile, IColumnMap cmap)
      Deprecated.
      Please use the constructor having a template as its last argument. Then use null as the last argument.
      Create a new chart, given the chart type and dimension. Input data is read from a data file.
      Use this constructor if the chart is used in an application, If the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      frame - a Frame
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      dataFile - source data file, see database file format for details
      cmap - column information use to specify which column is use to plot data, see interface IColumnMap for details

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, EJBInfo ejbInfo, IColumnMap cmap, String template)
      Create a QbChart object using the specified EJbInfo object

    • QbChart

      public QbChart(Frame frame, int dimension, int chartType, EJBInfo ejbInfo, IColumnMap cmap, String template)
      Create a QbChart object using the specified EJbInfo object

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, String jndiName, String homeName, String remoteName, String selectedMethodName, Object[] selectedMethodParamVal, IColumnMap cmap, String template)
      Create a QbChart object by providing the following information of the EJb component: JNDI lookup name, home interface name, remote interface name selected home method, and input parameters for the selected method

    • QbChart

      public QbChart(Frame frame, int dimension, int chartType, String jndiName, String homeName, String remoteName, String selectedMethodName, Object[] selectedMethodParamVal, IColumnMap cmap, String template)
      Create a QbChart object by providing the following information of the EJb component: JNDI lookup name, home interface name, remote interface name selected home method, and input parameters for the selected method

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, String jndiName, String homeName, String remoteName, String selectedMethodName, Object[] selectedMethodParamVal, Hashtable<String,String> environment, IColumnMap cmap, String template, boolean doTransposeData, boolean[] transposeCol)

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, String connectionString, String MDXQuery, int inputMethod, IColumnMap cmap, String template, boolean doTransposeData, boolean[] transposeCol)

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, quadbase.common.util.internal.ExcelFileInfo excelInfo, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, String template)
      Creates a new chart, given the chart type, dimension and a template. Input data are read from Excel. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      excelInfo - Excel data source info. See ExcelFileInfo.
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set having three columns: RowLabel, ColumnLabel, and Value.
      transposeCol - transposing selected column from the original data
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, String uri, String datasource, String catalog, String MDXQuery, int inputMethod, IColumnMap cmap, String template, boolean doTransposeData, boolean[] transposeCol)

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, IOLAPResultSet olapRS, int inputMethod, IColumnMap cmap, String template, boolean doTransposeData, boolean[] transposeCol)

    • QbChart

      @Deprecated public QbChart(Applet applet, int dimension, int chartType, String dataFile, IColumnMap cmap, String template)
      Deprecated.
      Please use the constructor having a file type argument before dataFile argument. Use either QbChart.DATAFILE or QbChart.QUERYFILE as the file type.
      Create a new chart, given the chart type, dimension, and a template. Input data is read from a data file. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      dataFile - source data file, see database file format for details
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      @Deprecated public QbChart(Applet applet, int dimension, int chartType, String dataFile, boolean doTransposeData, IColumnMap cmap, String template)
      Deprecated.
      Please use the constructor having a file type argument before dataFile argument. Use either QbChart.DATAFILE or QbChart.QUERYFILE as the file type.
      Create a new chart, given the chart type, dimension, and a template. Input data is read from a data file. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      dataFile - source data file, see database file format for details
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set having three columns : RowLabel, ColumnLabel, and Value.
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      @Deprecated public QbChart(Applet applet, int dimension, int chartType, String dataFile, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, String template)
      Deprecated.
      Please use the constructor having a file type argument before dataFile argument. Use either QbChart.DATAFILE or QbChart.QUERYFILE as the file type.
      Create a new chart, given the chart type, dimension, and a template. Input data is read from a data file. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      dataFile - source data file, see database file format for details
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set
      transposeCol - transpose selected columns from the original data
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, int fileType, String filename, boolean doTransposeData, IColumnMap cmap, String template) throws Exception
      Create a new chart, given the chart type, dimension, and a template. Input data is read from eiter a data file or a query file (*.qry), which is specify by fileType argument. The value of fileType can be either QbChart.DATAFILE or QbChart.QUERYFILE. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      fileType - use QbChart.DATAFILE or QbChart.QUERYFILE
      filename - If fileType is QbChart.DATAFILE, the file is a source data file, see database file format for details If fileType is QbChart.QUERYFILE, the file is a query file (with extension .qry)
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set having three columns : RowLabel, ColumnLabel, and Value.
      cmap - column information used to specify the column mappings used to plot data
      template - a template file (with extension .tpl). Use null if no template is to be applied.
      Throws:
      Exception
      See Also:

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, int fileType, String filename, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, String template) throws Exception
      Create a new chart, given the chart type, dimension, and a template. Input data is read from eiter a data file or a query file (*.qry), which is specify by fileType argument. The value of fileType can be either QbChart.DATAFILE or QbChart.QUERYFILE. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      fileType - use QbChart.DATAFILE or QbChart.QUERYFILE
      filename - If fileType is QbChart.DATAFILE, the file is a source data file, see database file format for details If fileType is QbChart.QUERYFILE, the file is a query file (with extension .qry)
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set
      transposeCol - transposing selected columns from the original data source
      cmap - column information used to specify the column mappings used to plot data
      template - a template file (with extension .tpl). Use null if no template is to be applied.
      Throws:
      Exception
      See Also:

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, XMLFileQueryInfo xmlInfo, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, String template) throws Exception
      Create a new chart, given the xml information. Input data is read from a xml file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      xmlInfo - the XML information for plot the chart
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set
      transposeCol - transposing selected columns from the original data source
      cmap - column information used to specify the column mappings used to plot data
      template - a template file (with extension .tpl). Use null if no template is to be applied.
      Throws:
      Exception
      See Also:

    • QbChart

      public QbChart(Frame frame, int dimension, int chartType, XMLFileQueryInfo xmlInfo, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, String template) throws Exception
      Create a new chart, given the xml information. Input data is read from a xml file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      frame - a Frame
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      xmlInfo - the XML information for plot the chart
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set
      transposeCol - transposing selected columns from the original data source
      cmap - column information used to specify the column mappings used to plot data
      template - a template file (with extension .tpl). Use null if no template is to be applied.
      Throws:
      Exception
      See Also:

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, String className, quadbase.common.paramquery.QueryInParamSet queryInParamSet, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, String template) throws Exception
      Create a new chart using Class file as data source. If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      chartType - a flag denoting whether the input data has to be transposed into a result set
      className - the class name of the class data source
      queryInParamSet - paramter set if the the class data source is parameterized it can be null for non-parameterized. If it is null for a parameterized class data source, a swing dialog will be prompted on the server side.
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set
      transposeCol - transposing selected columns from the original data source
      cmap - column information used to specify the column mappings used to plot data
      template - a template file (with extension .tpl). Use null if no
      Throws:
      Exception
      See Also:

    • QbChart

      @Deprecated public QbChart(Frame frame, int dimension, int chartType, String dataFile, IColumnMap cmap, String template)
      Deprecated.
      Please use the constructor having the applet parameter. Use "(Applet) null" as the first argument.
      Create a new chart, given the chart type, dimension, and a template. Input data is read from a data file. Other attributes of the chart are read from the template file.
      Use this constructor if the chart is used in an application, If the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      dataFile - source data file, see database file format for details
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl).
      applet - an applet containing the chart. Use null if used within an application.

    • QbChart

      @Deprecated public QbChart(Applet applet, int dimension, int chartType, IResultSet data, IColumnMap cmap)
      Deprecated.
      Please use the constructor having a template as its last argument. Then use null as the last argument.
      Create a new chart, given the chart type and dimension. Input data is passed directly as an argument.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      data - source data to plot chart, see IResultSet for details.
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details

    • QbChart

      @Deprecated public QbChart(Frame frame, int dimension, int chartType, IResultSet data, IColumnMap cmap)
      Deprecated.
      Please use the constructor having the applet parameter. Use "(Applet) null" as the first argument.
      Create a new chart, given the chart type and dimension. Input data is passed directly as an argument.
      Use this constructor if the chart is used in an application, If the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      frame - A Frame
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      data - source data to plot chart, see IResultSet for details.
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, IResultSet data, IColumnMap cmap, String template)
      Create a new chart, given the chart type, dimension and a template. Input data is passed directly as an argument. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      data - source data to plot chart, see IResultSet for details.
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, IResultSet data, boolean doTransposeData, IColumnMap cmap, String template)
      Create a new chart, given the chart type, dimension and a template. Input data is passed directly as an argument. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      data - source data to plot chart, see IResultSet for details.
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set having three columns: RowLabel, ColumnLabel, and Value.
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, IResultSet data, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, String template)
      Create a new chart, given the chart type, dimension and a template. Input data is passed directly as an argument. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      data - source data to plot chart, see IResultSet for details.
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set having three columns: RowLabel, ColumnLabel, and Value.
      transposeCol - transposing selected column from the original data
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      @Deprecated public QbChart(Frame frame, int dimension, int chartType, IResultSet data, IColumnMap cmap, String template)
      Deprecated.
      Please use the constructor having the applet parameter. Use "(Applet) null" as the first argument.
      Create a new chart, given the chart type, dimension, and a template. Input data is passed directly as an argument. Other attributes of the chart are read from the template file.
      Use this constructor if the chart is used in an application, If the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      frame - A Frame
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      data - source data to plot chart, see IResultSet for details.
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, ISpreadSheetModel sheet, IColumnMap cmap, String template)
      Create a new chart, given the chart type, dimension and a template. Input data is passed directly as an argument, in the form of a spreadsheet model. The chart functions as a view of the model, and updates itself based on notification of changes in the model using events. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      sheet - source data model for the chart, see ISpreadSheetModel for details.
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, DataSheet[] dataSheet, boolean doTransposeData, IColumnMap cmap, String template)
      Create a new chart, given the chart type, dimension and a template. Input data is passed directly as an argument. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      dataSheet - source data to plot chart, see DataSheet for details.
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set having three columns: RowLabel, ColumnLabel, and Value.
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      public QbChart(Applet applet, int dimension, int chartType, DataSheet[] dataSheet, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, String template)
      Create a new chart, given the chart type, dimension and a template. Input data is passed directly as an argument. Other attributes of the chart are read from the template file.
      If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart
      dataSheet - source data to plot chart, see DataSheet for details.
      doTransposeData - a flag denoting whether the input data has to be transposed into a result set having three columns: RowLabel, ColumnLabel, and Value.
      transposeCol - transpose selected object from the original data
      cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details
      template - a template file (with extension .tpl). Use null if no template is to be applied.

    • QbChart

      public QbChart(QbChart qbchart)
      Create a new chart using an existing chart object.
      Parameters:
      qbchart - an existing chart

    • QbChart

      public QbChart(Applet applet, byte[] chartData)
      Create a QbChart object from a byte array that is obtained by the exportChartToByteArray method in this class.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      chartData - a byte array containing a QbChart object.

    • QbChart

      public QbChart(Applet applet, byte[] chartData, boolean template)

    • QbChart

      public QbChart(Applet applet, byte[] chartData, boolean template, Properties props)

    • QbChart

      protected QbChart(boolean forReport)

    • QbChart

      public QbChart(Frame frame, String fileName, Object req)
      Create a QbChart object from an "tpl" or "rpt" file with parameterized query.
      Parameters:
      frame - a frame *
      fileName - location invalid input: '&' name of the chart file to use
      req - If the chart has a parameterized query, use this HTTPRequestObject to get parameters

    • QbChart

      public QbChart(Applet applet, String fileName, Object req)
      Create a QbChart object from an "tpl" or "rpt" file with parameterized query.
      Parameters:
      applet - an applet containing the chart. Use "(Applet) null" if used within an application.
      fileName - location invalid input: '&' name of the chart file to use
      req - If the chart has a parameterized query, use this HTTPRequestObject to get parameters

  • Method Details

    • setDebugMode

      public static final void setDebugMode(int mode)
      set debug mode to display debug statement

    • setDebugMode

      public static final void setDebugMode(String mode)
      set debug mode to display debug statement

    • isBackgroundTransparent

      public final boolean isBackgroundTransparent()
      Returns whether a chart background is transparent when exporting a chart to GIF format
      Returns:
      whether background is tansparent or not

    • setBackgroundTransparent

      public final void setBackgroundTransparent(boolean b)
      Set background color to transparent when exporting a chart to GIF format
      Parameters:
      b - set background to transparent, true or false

    • isDrawBorderForWMF

      public final boolean isDrawBorderForWMF()
      Returns whether a chart border is visible when exporting a chart to WMF format This method is only for 2D column/bar chart
      Returns:
      whether border is visible or not

    • setDrawBorderForWMF

      public final void setDrawBorderForWMF(boolean b)
      Set chart border to visible when exporting a chart to WMF format This method is only for 2D column/bar chart
      Parameters:
      b - set chart border to visible, true or false

    • setChartGraphics

      public final void setChartGraphics(IChartGraphics chartGraphics)
      Customize chart graphics information or draw user specify component onto chart canvas
      Parameters:
      chartGraphics - Chart Graphics Object
      See Also:
      • invalid reference 
        quadbase.util.IChartCanvas

    • setAddOnChart

      public final void setAddOnChart(QbChart[] qbCharts)
      Customize chart graphics information or draw user specify component onto chart canvas
      Parameters:
      chartGraphics - Chart Graphics Object
      See Also:
      • invalid reference 
        quadbase.util.IChartCanvas

    • setStringCustomizer

      public final void setStringCustomizer(IStringCustomizer stringCustomizer)
      This is the API call for the user to pass into user implemented IStringCustomizer for displaying specific characters, for example, Japanese characters.
      Parameters:
      stringCustomizer - chart IStringCustomizer object
      See Also:

    • setRenderingHint

      public void setRenderingHint(Object hintKey, Object hintValue)
      Sets the value of a single preference for the rendering algorithms. Hint categories include controls for rendering quality and overall time/quality trade-off in the rendering process. 
       Here is a list of the available keys and values from the java.awt.RenderingHints class:

 Keys                                                Values

 KEY_ANTIALIASING                                       VALUE_ANTIALIASING_ON
                                                                        VALUE_ANTIALIASING_OFF
                                                                        VALUE_ANTIALIASING_DEFAULT

 KEY_ALPHA_INTERPOLATION                        VALUE_ALPHA_INTERPOLATION_DEFAULT
                                                                        VALUE_ALPHA_INTERPOLATION_QUALITY
                                                                        VALUE_ALPHA_INTERPOLATION_SPEED

 KEY_COLOR_RENDERING                            VALUE_COLOR_RENDER_DEFAULT
                                                                        VALUE_COLOR_RENDER_QUALITY
                                                                        VALUE_COLOR_RENDER_SPEED

 KEY_DITHERING                                  VALUE_DITHER_DEFAULT
                                                                        VALUE_DITHER_DISABLE
                                                                        VALUE_DITHER_ENABLE

 KEY_FRACTIONALMETRICS                  VALUE_FRACTIONALMETRICS_DEFAULT
                                                                        VALUE_FRACTIONALMETRICS_OFF
                                                                        VALUE_FRACTIONALMETRICS_ON

 KEY_INTERPOLATION                              VALUE_INTERPOLATION_BICUBIC
                                                                        VALUE_INTERPOLATION_BILINEAR
                                                                        VALUE_INTERPOLATION_NEAREST_NEIGHBOR

 KEY_RENDERING                                  VALUE_RENDER_DEFAULT
                                                                        VALUE_RENDER_QUALITY
                                                                        VALUE_RENDER_SPEED

 KEY_STROKE_CONTROL                             VALUE_STROKE_DEFAULT
                                                                        VALUE_STROKE_NORMALIZE
                                                                        VALUE_STROKE_PURE

 KEY_TEXT_ANTIALIASING                  VALUE_TEXT_ANTIALIAS_DEFAULT
                                                                        VALUE_TEXT_ANTIALIAS_OFF
                                                                        VALUE_TEXT_ANTIALIAS_ON
      Refer to the java.awt.RenderingHints class for details about the above keys and values.
      Parameters:
      hintKey - java.awt.RenderingHint.Key Object, the key of the hint to be set.
      hintValue - the value indicating preferences for the specified hint category.
      See Also:

    • applyAntiAliasToChartAreaOnly

      public void applyAntiAliasToChartAreaOnly(boolean b)
      apply anti-alias to chart plot area only. Ignore in all the other area
      Parameters:
      b - apply anti-alias option to chart area only (not on label)

    • forceApplyAntiAliasToHorizontalText

      public void forceApplyAntiAliasToHorizontalText(boolean b)
      turn on anti-alias for horizontal text even anti-alias is not on for the chart
      Parameters:
      b - force apply anti-alias option to text area which can even override applyAntiAliasToChartAreaOnly() (horizontal label only)

    • setGradientEnabled

      public void setGradientEnabled(boolean b)

    • isGradientEnabled

      public boolean isGradientEnabled()

    • set3DShadingEnabled

      public void set3DShadingEnabled(boolean b)

    • is3DShadingEnabled

      public boolean is3DShadingEnabled()

    • setApplyGradientToChartDataOnly

      public void setApplyGradientToChartDataOnly(boolean b)

    • isApplyGradientToChartDataOnly

      public boolean isApplyGradientToChartDataOnly()

    • getGradientStartX

      public double getGradientStartX()

    • getGradientStartY

      public double getGradientStartY()

    • getGradientEndX

      public double getGradientEndX()

    • getGradientEndY

      public double getGradientEndY()

    • getGradientDesColor

      public Color getGradientDesColor()

    • getGradientShade

      public int getGradientShade()

    • isGradientCyclic

      public boolean isGradientCyclic()

    • setGradientStartX

      public void setGradientStartX(double x)

    • setGradientStartY

      public void setGradientStartY(double y)

    • setGradientEndX

      public void setGradientEndX(double x)

    • setGradientEndY

      public void setGradientEndY(double y)

    • setGradientDesColor

      public void setGradientDesColor(Color c)

    • setGradientShade

      public void setGradientShade(int s)

    • setGradientCyclic

      public void setGradientCyclic(boolean c)

    • setImageMapDataHintBoxHandle

      public final void setImageMapDataHintBoxHandle(ICustomizeImageMapDataHintBox val)
      Parameters:
      val - customer image map data hint box object
      See Also:

    • getImageMapDataHintBoxHandle

      public ICustomizeImageMapDataHintBox getImageMapDataHintBoxHandle()
      Returns:
      val customer image map data hint box object
      See Also:

    • getChartGraphics

      public final IChartGraphics getChartGraphics()
      return chart graphics object
      Returns:
      chartGraphics Chart Graphics Object
      See Also:
      • invalid reference 
        quadbase.util.IChartCanvas

    • export

      public final Image export()
      Exports the chart to an image Object. To set the canvas size, call chart.gethCanvas().setSize(new Dimension(yourWidth, yourHeight));
      Returns:
      The image object
      See Also:

    • exportChartToByteArray

      public byte[] exportChartToByteArray() throws Exception
      Exports the chart to byte array.
      Returns:
      byte array
      Throws:
      Exception

    • exportChartToByteArray

      public byte[] exportChartToByteArray(boolean template) throws Exception
      Throws:
      Exception

    • exportChartToString

      public String exportChartToString() throws Exception
      Exports the chart to String object which can use any chart viewer to re-open it again.
      Returns:
      The chart data in String format
      Throws:
      Exception
      See Also:
      • Parameter: ChartData

    • export

      public void export(int format, String filename) throws IOException
      Export the chart with dimensions equal to that of the current chart.
      Parameters:
      format - Available format are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension Use the same filename for the map file (*.map)
      Throws:
      IOException

    • export

      public void export(int format, String filename, int w, int h) throws IOException
      Export the chart
      Parameters:
      format - Available format are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height. The w and h arguments are not used in case of CHT and TPL format. Use the same filename for the map file (*.map)
      Throws:
      IOException

    • export

      public void export(int format, String filename, String subFilename) throws IOException
      Export the chart with dimensions equal to that of the current chart.
      Parameters:
      format - Available format are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      subFilename - map file name, without extension, useful if hyperlink exists / xml file name, without extension, use for CHT or TPL format
      Throws:
      IOException

    • export

      public void export(int format, String filename, String subFilename, int w, int h) throws IOException
      Export the chart
      Parameters:
      format - Available format are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      WMF - Window metafiles
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      subFilename - map file name, without extension, useful if hyperlink exists / xml file name, without extension, use for CHT or TPL format
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height. The w and h arguments are not used in case of CHT and TPL format.
      Throws:
      IOException

    • export

      public void export(int format, String filename, String subFilename, int w, int h, boolean generateSubFile) throws IOException
      Export the chart
      Parameters:
      format - Available format are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      subFilename - map file name, without extension, useful if hyperlink exists / xml file name, without extension, use for CHT or TPL format
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      generateSubFile - show data point information in map file / xml chart property file for CHT or TPL format The w and h arguments are not used in case of CHT and TPL format.
      Throws:
      IOException

    • export

      public void export(int format, String filename, int w, int h, int option) throws IOException
      Export the chart
      Parameters:
      format - Available format are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      option - JPEG file quality (0 - 100) / PNG file compression Available PNG Compression format are :
      PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE The w and h arguments are not used in case of CHT and TPL format.
      Throws:
      IOException

    • export

      public void export(int format, String filename, String subFilename, int w, int h, boolean generateSubFile, int option) throws IOException
      Export the chart
      Parameters:
      format - Available format are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      subFilename - map file name, without extension, useful if hyperlink exists / xml file name, without extension, use for CHT or TPL format
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      generateSubFile - show data point information in map file / xml chart property file for CHT or TPL format
      option - JPEG file quality (0 - 100) / PNG file compression Available PNG Compression format are :
      PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE The w and h arguments are not used in case of CHT and TPL format.
      Throws:
      IOException

    • export

      public void export(int format, String filename, String drillDownChartName, String servletLoc) throws Exception
      Export the chart with drill down map (top level only)
      Parameters:
      format - Available formats are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      drillDownChartName - drill-down Chart file absolute location
      servletLoc - servlet location ("http://machineName:port#/...servlet");
      Throws:
      Exception

    • export

      public void export(int format, String filename, String drillDownChartName, int w, int h, String servletLoc) throws Exception
      Export the chart with drill down map (top level only)
      Parameters:
      format - Available formats are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      drillDownChartName - drill-down Chart file absolute location
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      servletLoc - servlet location ("http://machineName:port#/...servlet");
      Throws:
      Exception

    • export

      public void export(int format, String filename, String drillDownChartName, int w, int h, String servletLoc, String[] argv) throws Exception
      Export the chart with drill down map (top level only)
      Parameters:
      format - Available formats are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      drillDownChartName - drill-down Chart file absolute location
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      servletLoc - servlet location ("http://machineName:port#/...servlet");
      argv - optional parameter
      Throws:
      Exception

    • export

      public void export(int format, String filename, String drillDownChartName, String servletLoc, PickData[] pickData) throws Exception
      Export the chart with drill down map
      Parameters:
      format - Available formats are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      drillDownChartName - drill-down Chart file absolute location
      servletLoc - servlet location ("http://machineName:port#/...servlet");
      pickData - array of pickData from 1st drill-down level to current level
      Throws:
      Exception

    • export

      public void export(int format, String filename, String drillDownChartName, int w, int h, String servletLoc, PickData[] pickData) throws Exception
      Export the chart with drill down map
      Parameters:
      format - Available formats are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      drillDownChartName - drill-down Chart file absolute location
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      servletLoc - servlet location ("http://machineName:port#/...servlet");
      pickData - array of PickData from 1st drill-down level to current level The w and h arguments are not used in case of CHT and TPL format.
      Throws:
      Exception

    • export

      public void export(int format, String filename, String drillDownChartName, int w, int h, String servletLoc, PickData[] pickData, String[] argv) throws Exception
      Export the chart with drill down map
      Parameters:
      format - Available formats are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      drillDownChartName - drill-down Chart file absolute location
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      servletLoc - servlet location ("http://machineName:port#/...servlet");
      pickData - array of PickData from 1st drill-down level to current level
      argv - optional parameters
      Throws:
      Exception

    • export

      public void export(int format, String filename, String chartLocation, int w, int h, String servletLoc, PickData[] pickData, String[] argv, int option) throws Exception
      Export the chart with drill down map
      Parameters:
      format - Available formats are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      chartLocation - drill-down Chart file absolute location
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      servletLoc - servlet location ("http://machineName:port#/...servlet");
      pickData - array of PickData from 1st drill-down level to current level
      argv - optional parameters
      option - JPEG file quality (0 - 100) / PNG file compression / FLASH frame count (1-50) Available PNG Compression format are :
      PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE
      Throws:
      Exception

    • export

      public void export(int format, String filename, String chartLocation, int w, int h, String servletLoc, PickData[] pickData, String[] argv, int option, float option2, boolean enableAnimationForFlash) throws Exception
      Exports the chart with drill down map
      Parameters:
      format - Available formats are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      filename - export file name, without extension
      chartLocation - drill-down Chart file absolute location
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      servletLoc - servlet location ("http://machineName:port#/...servlet");
      pickData - array of PickData from 1st drill-down level to current level
      argv - optional parameters
      option - JPEG file quality (0 - 100) / PNG file compression / FLASH frame count (1-50) Available PNG Compression format are :
      PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE
      option2 - FLASH frame rate (0-99)
      enableAnimationForFlash - FLASH enable animation (DEFAULT VALUE: TRUE)
      Throws:
      Exception

    • export

      public void export(int format, OutputStream image, OutputStream subFile, String filename, String chartLocation, int w, int h, String servletLoc, PickData[] pickData, String[] argv, int option) throws Exception
      Export the chart with drill down map
      Parameters:
      format - Available formats are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      image - The outputStream. The caller is responsible for closing it.
      subFile - The outputStream. The caller is responsible for closing it.
      filename - export file name, without extension
      chartLocation - drill-down Chart file absolute location
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      servletLoc - servlet location ("http://machineName:port#/...servlet");
      pickData - array of PickData from 1st drill-down level to current level
      argv - optional parameters
      option - JPEG file quality (0 - 100) / PNG file compression Available PNG Compression format are :
      PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE
      Throws:
      Exception

    • export

      public void export(int format, OutputStream image, OutputStream subFile, String filename, String chartLocation, int w, int h, String servletLoc, PickData[] pickData, String[] argv, int option, float option2, boolean enableAnimationForFlash) throws Exception
      Exports the chart with drill down map
      Parameters:
      format - Available formats are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      FLASH - Flash (.swf)
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template
      image - The outputStream. The caller is responsible for closing it.
      subFile - The outputStream. The caller is responsible for closing it.
      filename - export file name, without extension
      chartLocation - drill-down Chart file absolute location
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      servletLoc - servlet location ("http://machineName:port#/...servlet");
      pickData - array of PickData from 1st drill-down level to current level
      argv - optional parameters
      option - JPEG file quality (0 - 100) / PNG file compression Available PNG Compression format are :
      PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE
      option2 - FLASH frame rate (0-99)
      enableAnimationForFlash - FLASH enable animation (DEFAULT VALUE: TRUE)
      Throws:
      Exception

    • setDrillDownPath

      public void setDrillDownPath(String path)

    • isFieldDrillDownEnabled

      public boolean isFieldDrillDownEnabled()

    • isFieldDrillDownChart

      public boolean isFieldDrillDownChart()

    • getPickDataCount

      public static int getPickDataCount(String param)
      get number of PickData in given drill-down link
      Parameters:
      param - drill-down link data information
      Returns:
      number of PickData

    • toPickData

      public static PickData[] toPickData(String param)
      convert drill-down link "PARAM" to PickData[]
      Parameters:
      param - drill-down link data information
      Returns:
      PickData[] for corresponding drill-down link

    • export

      public void export(int format, OutputStream out) throws IOException
      Export the chart
      Parameters:
      format - Available format are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template Note that this method does not generate any map file if hyperlink exists
      out - The outputStream. The caller is responsible for closing it.
      Throws:
      IOException

    • export

      public void export(int format, OutputStream out, int w, int h) throws IOException
      Export the chart
      Parameters:
      format - Available format are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template Note that this method does not generate any map file if hyperlink exists
      out - The outputStream. The caller is responsible for closing it.
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      Throws:
      IOException

    • export

      public void export(int format, OutputStream out, int w, int h, int option) throws IOException
      Export the chart
      Parameters:
      format - Available format are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template The w and h arguments are not used in case of CHT and TPL format. Note that this method does not generate any map file if hyperlink exists
      out - The outputStream. The caller is responsible for closing it.
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      option - JPEG file quality (0 - 100) / PNG file compression Available PNG Compression format are :
      PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE
      Throws:
      IOException

    • export

      public void export(int format, OutputStream image, OutputStream subFile, String fileName, int w, int h, boolean generateSubFile, int option) throws IOException
      Export the chart
      Parameters:
      format - Available format are :
      GIF - CompuServe gif
      GIF_N - CompuServe gif using new gif encoder
      JPEG - JPEG
      PNG - Portable Network Graphics
      SVG - Scalable Vector Graphics
      WMF - Window metafiles
      BMP - OS/2 or Window bitmap
      CHT - chart format
      TPL - chart template The w and h arguments are not used in case of CHT and TPL format.
      image - The outputStream. The caller is responsible for closing it.
      subFile - The outputStream. The caller is responsible for closing it.
      fileName - The name of the CHT/TPL Chart for XML or the name of the MAP file
      w - output chart width (in pixels), 0 represents current width
      h - output chart height (in pixels), 0 represent current height.
      generateSubFile - show data point information (MAP file) in subFile outputStream/ xml chart file for CHT or TPL format in subFile outputStream
      option - JPEG file quality (0 - 100) / PNG file compression Available PNG Compression format are :
      PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE
      Throws:
      IOException

    • exportDataFile

      public void exportDataFile(String fileName, int separator, int format) throws Exception
      Export Data File
      Parameters:
      fileName - Output data file name
      separator - Available separators for TXT format are :
      QbChart.COMMA
      QbChart.SEMICOLON
      QbChart.SPACE
      format - Available format are :
      QbChart.TXTFORMAT
      QbChart.XMLFORMAT
      Throws:
      Exception

    • exportDataFile

      public void exportDataFile(PrintStream out, int separator, int format) throws Exception
      Exports Data File
      Parameters:
      out - The outputStream. The caller is responsible for closing it.
      separator - Available separators for TXT format are :
      QbChart.COMMA
      QbChart.SEMICOLON
      QbChart.SPACE
      format - Available formats are :
      QbChart.TXTFORMAT
      QbChart.XMLFORMAT
      Throws:
      Exception

    • refresh

      public final void refresh() throws IOException, SQLException, ClassNotFoundException
      Reload the chart data from input database or data file. This method is useful when the input data has changed and the chart needs to be updated. Note that the method does nothing if the data source is not a database or file. After refreshing, call the repaint() to redraw the chart.
      Specified by:
      refresh in class quadbase.ChartAPI.swing.QbChartBasic
      Throws:
      IOException
      SQLException
      ClassNotFoundException

    • setNewData

      public quadbase.chart.Chart setNewData(quadbase.chart.ColData[] colData) throws Exception
      internal use only
      Specified by:
      setNewData in interface quadbase.common.util.internal.IChart
      Throws:
      Exception

    • repaintPanel

      public void repaintPanel()
      This method repaints the viewpanel that contains a chart

    • draw

      public void draw(Graphics g, Component component, int width, int height)
      This method draws the chart given a Graphics object. It should ONLY be called when trying to draw a chart onto a background image. In general, it is used when a programmer wants to know information such as min and max scale values of the chart prior to displaying it on the screen.

    • setApplet

      public final void setApplet(Applet applet)
      Set the applet containing this chart component.
      If the chart is contained in an applet, the applet code base is used to find the server locator file (server.cfg). The applet context is also used to invoke browser windows for displaying URLs.
      Parameters:
      applet - the applet containing the chart. Use null if used within an application.

    • getApplet

      public final Applet getApplet()
      Return applet
      Returns:
      the applet containing this component

    • getErrorMessage

      public final String getErrorMessage()
      Return error message from the constructor of QbChart
      Returns:
      error message or null if chart created successfully

    • finalize

      protected void finalize() throws Throwable
      Overrides:
      finalize in class Object
      Throws:
      Throwable

    • getDrillDownChartCount

      public int getDrillDownChartCount()
      The number of drill-down charts immediately accessible

    • getDrillDownChartAt

      public DrillDownChart getDrillDownChartAt(int index) throws Exception
      Return the drill-down chart at the specific index
      Throws:
      Exception

    • getDrillDownChart

      public DrillDownChart getDrillDownChart(String name) throws Exception
      Return the drill-down chart with the matching name
      Throws:
      Exception

    • createDrillDownChart

      public DrillDownChart createDrillDownChart(String name, int chartDim, int chartType, IDatabaseInfo dbInfo, boolean doTransposeData, int[] transposeCol, IColumnMap mapping, String template, int[] columnMapping) throws Exception
      Create a drill-down chart that will be an immediate child of the calling chart
      Parameters:
      name - The name of the drill-down chart. If a drill-down chart already exists with the same name, an IllegalArgumentException is thrown
      chartType - The type of the chart. See IChartConstants.
      dbInfo - The database information that will be used to retrieve data. It must implement the IQueryFileInfo interface because drill-down charts require a parameterized query.
      mapping - Database results to chart table mapping.
      template - Template RPT file to be applied to the drill-down chart.
      columnMapping - Specifies which column of the calling chart should be mapped to each parameter. Therefore, the length of this array should equal the number of parameters in the query.
      Throws:
      Exception

    • createDrillDownChart

      public DrillDownChart createDrillDownChart(String name, int chartDim, int chartType, IDatabaseInfo dbInfo, boolean doTransposeData, int[] transposeCol, IColumnMap mapping, String template, int[] columnMapping, boolean prevParamPrompt) throws Exception
      Throws:
      Exception

    • updateDrillDownCharts

      public void updateDrillDownCharts() throws Exception
      Throws:
      Exception

    • getPreferredSize

      public final Dimension getPreferredSize()
      Overrides component getPreferredSize().
      Overrides:
      getPreferredSize in class JComponent
      Returns:
      the preferred size of this component.
      See Also:

    • setPreferredSize

      public final void setPreferredSize(Dimension d)
      Set the preferred size for this component. (Note that this is different from the size of the chart canvas, which is contained in a scroll pane.
      Overrides:
      setPreferredSize in class JComponent
      Parameters:
      d - the preferred dimensions of the component.

    • getModifier

      public final int getModifier()
      Return mouse modifier

    • getArgument

      public Object getArgument()
      Get the argument of the event, PickData if data is selected or String which describes the object otherwise
      Returns:
      an Object

    • readExternal

      public final void readExternal(ObjectInput in) throws IOException, ClassNotFoundException
      This method provides support for reading serialized charts
      Specified by:
      readExternal in interface Externalizable
      Throws:
      IOException
      ClassNotFoundException

    • writeExternal

      public final void writeExternal(ObjectOutput out) throws IOException
      This method provides support for writing serialized charts
      Specified by:
      writeExternal in interface Externalizable
      Throws:
      IOException

    • getVersion

      public static String getVersion()
      Returns EspressChart Version Number
      Returns:
      EspressChart Version Number

    • isChartServerUsed

      public static boolean isChartServerUsed()
      Returns whether the chart server is used for input/output, If false, the package performs file and database reads/writes directly. The default is true (i.e. chart server is used).
      Returns:
      true if the chart server is used, false otherwise.

    • setChartServerUsed

      public static void setChartServerUsed(boolean b)
      Use this to specify whether to use the chart server for input/output, or perform file and database reads/writes directly. Note that this static method MUST be called before any QbChart constructors.
      Parameters:
      b - If true the chart server is used, otherwise direct i/o is attempted. The default value is true.

    • setChartServerUsed

      public static void setChartServerUsed(int num)
      Use this to specify whether to use the chart server for input/output, or perform file and database reads/writes directly. Note that this static method MUST be called before any QbChart constructors
      Parameters:
      num - Use 0 for false, otherwise true. If true the chart server is used, otherwise direct i/o is attempted. The default value is true.

    • setChartServerUsed

      public static void setChartServerUsed(String str)
      Use this to specify whether to use the chart server for input/output, or perform file and database reads/writes directly. Note that this static method MUST be called before any QbChart constructors.
      Parameters:
      str - Use "true" for true, otherwise false. If true the chart server is used, otherwise direct i/o is attempted. The default value is true.

    • isEspressManagerUsed

      public static boolean isEspressManagerUsed()
      Returns whether EspressManager is used for input/output. If false, the package performs file and database reads/writes directly. The default is true (i.e. EspressManager is used).
      Returns:
      true if EspressManger is used, false otherwise.

    • setEspressManagerUsed

      public static void setEspressManagerUsed(boolean b)
      Use this to specify whether to use EspressManager for input/output, or perform file and database reads/writes directly. Note that this static method MUST be called before any QbChart constructors.
      Parameters:
      b - If true, EspressManager is used; otherwise, direct i/o is attempted. The default value is true.

    • setEspressManagerUsed

      public static void setEspressManagerUsed(int num)
      Use this to specify whether to use EspressManager for input/output, or perform file and database reads/writes directly. Note that this static method MUST be called before any QbChart constructors
      Parameters:
      num - Use 0 for false, otherwise true. If true, EspressManager is used; otherwise, direct i/o is attempted. The default value is true.

    • setQueryTimeout

      public static void setQueryTimeout(int seconds)
      Sets the number of seconds the driver will wait for a statement object to execute to the given number of seconds

    • getQueryTimeout

      public static int getQueryTimeout()
      retrieves the number of seconds the driver will wait for a statement object to execute.

    • setEspressManagerUsed

      public static void setEspressManagerUsed(String str)
      Use this to specify whether to use EspressManager for input/output, or perform file and database reads/writes directly. Note that this static method MUST be called before any QbChart constructors
      Parameters:
      str - Use "true" for true, otherwise false. If true, EspressManager is used; otherwise, direct i/o is attempted. The default value is true.

    • setConnectURLForServer

      public static void setConnectURLForServer(String comm_url)
      Set direct connect url for reverse proxy server Note: this static method MUST be called before any QbChart constructor
      Parameters:
      comm_url - connect url

    • useHttp

      public static void useHttp(boolean b)
      Determines whether to use SOCKET or HTTP for chart server connection Note that this static method MUST be called before any QbChart constructor.
      Parameters:
      b - If true use HTTP connection, otherwise use SOCKET connection The default value is false.

    • setServletRunner

      public static void setServletRunner(String comm_url)
      Set servlet runner hostname and port number Note: this static method MUST be called before any QbChart constructor
      Parameters:
      comm_url - servlet runner hostname and port number

    • useServlet

      public static void useServlet(boolean b)
      Determines whether to use SOCKET or HTTP or SERVLET for chart server connection Note that this static method MUST be called before any QbChart constructor.
      Parameters:
      b - If true use SERVLET connection, otherwise use other connection The default value is false.

    • setServletContext

      public static void setServletContext(String context)

    • getServletContext

      public static String getServletContext()
      return servlet context

    • isForExportOnly

      public static boolean isForExportOnly()
      Returns whether QbChart is optimized for exporting chart images
      Returns:
      The state

    • setForExportOnly

      public static void setForExportOnly(boolean state)
      Sets whether the QbChart object is only used for exporting charts later. QbChart can skip UI initialization if the new state is true, and hence requires less time and memory, especially useful for 3D charts. Note that this static method MUST be called before any QbChart constructor.
      Parameters:
      state - The new state. The default value is false.

    • getMaxRecordInMemory

      public static int getMaxRecordInMemory()
      get max number of record in memory when using record file to generate the report if value = -1, load everything in memory (default)

    • setMaxRecordInMemory

      public static void setMaxRecordInMemory(int r)
      set max number of record in memory when using record file to generate the report if value = -1, load everything in memory (default)

    • getFileRecordBufferSize

      public static int getFileRecordBufferSize()
      get the number of record to store on disk at a time when using record file data to generate the report

    • setFileRecordBufferSize

      public static void setFileRecordBufferSize(int r) throws Exception
      set the number of record to store on disk at a time when using record file data to generate the report (larger buffer results faster generating time)
      Throws:
      Exception

    • getMaxCharForRecordFile

      public static int getMaxCharForRecordFile()
      get max number of character for record in column when using record file to generate the report

    • setMaxCharForRecordFile

      public static void setMaxCharForRecordFile(int r) throws Exception
      set max number of character for record in column when using record file to generate the report
      Throws:
      Exception

    • getPagingThreshold

      public static int getPagingThreshold()
      Gets threshold value (in MB) for enable paging feature if value = -1, load everything in memory (default)

    • setPagingThreshold

      public static void setPagingThreshold(int r)
      set threshold value (in MB) for enable paging feature if value = -1, load everything in memory (default)

    • getPageBufferSize

      public static int getPageBufferSize()
      Gets the page buffer size in memory (in MB) when using paging feature to generate the report/ chart

    • setPageBufferSize

      public static void setPageBufferSize(int r) throws Exception
      set the page buffer size in memory (in MB) when using paging feature to generate the report/ chart (larger buffer results faster generating time)
      Throws:
      Exception

    • getMaxFieldSize

      public static int getMaxFieldSize()
      Gets max number of character for record in column when using paging feature to generate the report/ chart

    • setMaxFieldSize

      public static void setMaxFieldSize(int r) throws Exception
      set max number of character for record in column when using paging feature to generate the report/ chart
      Throws:
      Exception

    • getTotalPageBufferSize

      public static int getTotalPageBufferSize()
      Gets the total page buffer size in memory (in MB) for server when using paging feature to generate the report/ chart

    • setTotalPageBufferSize

      public static void setTotalPageBufferSize(int r) throws Exception
      set the total page buffer size in memory (in MB) for server when using paging feature to generate the report/ chart (larger buffer results faster generating time)
      Throws:
      Exception

    • getTempDirectory

      public static String getTempDirectory()
      get temp directory for using record file to generate the report DEFAULT temp directory is "temp/"

    • setTempDirectory

      public static void setTempDirectory(String str)
      set temp directory for using record file to generate the report DEFAULT temp directory is "temp/"

    • setAdjustFont

      public void setAdjustFont(boolean state)
      Specify whether should adjust the font based on the screen resolution.

    • isAdjustFont

      public boolean isAdjustFont()
      Return whether adjust the font based on the screen resolution.

    • getHTMLParamPage

      @Deprecated public String getHTMLParamPage(String servletName)
      Deprecated.
      use QbChart.getParameterPage(String, int, String) instead For parameterized chart, generate the html page for user to enter the paramters
      Parameters:
      servletName - the name of the servlet
      Returns:
      the HTML page as a String

    • getHTMLParamPage

      @Deprecated public String getHTMLParamPage(String chartLoc, int format, String servletName)
      Deprecated.
      use QbChart.getParameterPage(String, int, String) instead For parameterized chart, generate the html page for user to enter the paramters
      Parameters:
      chartLoc - the .rpt file location
      format - the export format
      servletName - the name of the servlet
      Returns:
      the HTML page as a String

    • getHTMLParamPageBody

      @Deprecated public String getHTMLParamPageBody(String servletName)
      Deprecated.
      use QbChart.getParameterPage(String, int, String) instead For parameterized chart, generate the html page for user to enter the paramters
      Parameters:
      servletName - the name of the servlet
      chartLoc - the .rpt file location
      format - the export format
      Returns:
      the HTML page as a String

    • getHTMLParamPageBody

      @Deprecated public String getHTMLParamPageBody(String chartLoc, int format, String servletName)
      Deprecated.
      use QbChart.getParameterPage(String, int, String) instead For parameterized chart, generate the html page for user to enter the paramters
      Parameters:
      chartLoc - the .rpt file location
      format - the export format
      servletName - the name of the servlet
      Returns:
      the HTML page as a String

    • getHTMLParamPageBlock

      @Deprecated public String getHTMLParamPageBlock()
      Deprecated.
      use QbChart.getParameterPage(String, int, String) instead For parameterized chart, generate the html page body for user to enter the paramters
      Returns:
      the HTML page body as a String

    • setGIFEnable

      @Deprecated public static void setGIFEnable(String serialNumber, String key) throws Exception
      Deprecated.
      this method has no effect - GIF export is always enabled
      Sets whether the Qbchart can generate GIF or not
      Throws:
      Exception

    • setBufferedImageUsed

      public void setBufferedImageUsed(boolean state)
      Sets whether the QbChart to use java.awt.image.BufferedImage technology to export image
      Parameters:
      state - The new state. The default value is false.

    • isBufferedImageUsed

      public boolean isBufferedImageUsed()
      Returns whether the QbChart to use java.awt.image.BufferedImage technology to export image
      Returns:
      the state

    • setBufferedImageType

      public void setBufferedImageType(int imageType)
      Sets java.awt.image.BufferedImage image type
      Parameters:
      imageType - The new image type. The default value is java.awt.image.TYPE_INT_RGB
      See Also:

    • getBufferedImageType

      public int getBufferedImageType()
      Returns java.awt.image.BufferedImage image type
      Returns:
      image type

    • setGrayscaleForExport

      public void setGrayscaleForExport(boolean isGrayscale)
      Sets using grayscale for export
      Parameters:
      isGrayscale - value for grayscale export. The default value is false

    • isGrayscaleForExport

      public boolean isGrayscaleForExport()
      Returns using grayscale for export
      Returns:
      isGrayscale value for grayscale export. The default value is false

    • getTemplateFile

      public final String getTemplateFile()
      Returns the name of the template applied to the current chart, if any.

      Associated QbChart property: TEMPLATE

      Returns:
      the name of the TPL file applied to the current chart.
      See Also:
      • invalid reference 
        applyTemplate

    • applyTemplateFile

      public final void applyTemplateFile(String fileName) throws IOException
      Applies the given template to the current chart. All chart properties except the chart type and dimension are extracted from the template, and applied to the current chart. (The chart data remains unchanged.)

      Associated QbChart property: TEMPLATE

      Parameters:
      fileName - - the name of the TPL file from which the chart properties are to be extracted.
      Throws:
      IOException

    • setLocale

      public void setLocale(Locale locale)
      Sets the locale of this component
      Overrides:
      setLocale in class Component
      Parameters:
      locale - The locale to become this component's locale.

    • setPanelBorder

      public void setPanelBorder(Object border)
      Sets the border of this component (for swing version only)
      Overrides:
      setPanelBorder in class quadbase.ChartAPI.swing.QbChartPanel
      Parameters:
      border - The border to be rendered for the component (border must be instance of javax.swing.border.Border object)

    • setOpaque

      public void setOpaque(boolean isOpaque)
      Sets the opaque of this component (for swing version only)
      Overrides:
      setOpaque in class JComponent
      Parameters:
      isOpaque - Opaque value of this component

    • getLocale

      public Locale getLocale() throws IllegalComponentStateException
      Gets the locale of this component
      Overrides:
      getLocale in class Component
      Returns:
      This component's locale. If this component does not have a locale, the locale of its parent is returned.
      Throws:
      IllegalComponentStateException

    • getTimeZone

      public TimeZone getTimeZone()
      Gets the time zone
      Returns:
      the time zone associated with this component

    • setTimeZone

      public void setTimeZone(TimeZone zone)
      Sets the time zone
      Parameters:
      zone - the given new time zone

    • getFile

      public final String getFile()
      Returns the name of the (CHT or TPL) file from which the chart is loaded.

      Associated QbChart property: OPENFILE

      Returns:
      the name of the current CHT or TPL file from which the chart is loaded.

    • loadFile

      public final void loadFile(String fileName) throws IOException
      Loads the chart from the given CHT or TPL file. Note that this replaces any existing chart being displayed on the canvas.

      Associated QbChart property: OPENFILE

      Parameters:
      fileName - - the name of the CHT or TPL file from which the chart is to be loaded. This must have extension ".cht" or ".tpl".
      Throws:
      IOException

    • getDimension

      public final int getDimension()
      Returns the dimension (2D or 3D) of the chart.

      Associated QbChart property: DIMENSION

      Returns:
      a constant (VIEW2D or VIEW3D) denoting the chart dimension.

    • setDimension

      public final void setDimension(int d)
      Sets the dimension (2D or 3D) of the chart.

      Associated QbChart property: DIMENSION

      Parameters:
      d - - integer constant (VIEW2D or VIEW3D) denoting the dimension.

    • getType

      public final int getType()
      Returns the type of the chart.

      Associated QbChart property: CHART_TYPE

      Returns:
      an integer constant denoting the chart type.

    • setType

      public final void setType(int type)
      Sets the type of the chart.

      Associated QbChart property: CHART_TYPE

      Parameters:
      type - : an integer constant denoting a chart type.

    • isPrintKeyEnabled

      public boolean isPrintKeyEnabled()
      Returns true if accelerator keys are enabled to export a chart as an image in order to facilitate printing. Printing is facilitated by exporting the chart to a PNG or a JPEG image using the chart server, and then opening it within a browser window. If this option is enabled, hitting Ctrl-P brings up a PNG image, and Ctrl-J brings up a JPEG image in a new browser window.

      Associated QbChart property: PRINTING

      Returns:
      True if print keys are enabled, false otherwise.

    • setPrintKeyEnabled

      public void setPrintKeyEnabled(boolean b)
      This function is used to enable accelerator keys to export a chart as an image in order to facilitate printing. Printing is facilitated by exporting the chart to a GIF or a JPEG image using the chart server, and then opening it within a browser window. If this option is enabled, hitting Ctrl-P brings up a GIF image, and Ctrl-J brings up a JPEG image in a new browser window.

      Associated QbChart property: PRINTING

      Parameters:
      b - - if true, print keys are enabled, otherwise disabled.

    • isRefreshEnabled

      public boolean isRefreshEnabled()
      Returns true if accelerator keys are enabled to refresh chart data If this option is enabled, hitting Ctrl-R (or use popup-menu) to refresh data

      Returns:
      True if refresh key is enabled, false otherwise.

    • setRefreshEnabled

      public void setRefreshEnabled(boolean b)
      This function is used to enable accelerator keys to refresh chart data If this option is enabled, hitting Ctrl-R (or use popup-menu) to refresh data.

      Parameters:
      b - - if true, refresh key is enabled, otherwise disabled.

    • isHiLowAsCandleStick

      public final boolean isHiLowAsCandleStick()
      Returns true if a hi-low chart is to be displayed in the form of a candlestick chart. The default is false.

      Associated QbChart property: CANDLE_STICK

      Returns:
      true if the chart is displayed as a candlestick, false otherwise.

    • setHiLowAsCandleStick

      public final void setHiLowAsCandleStick(boolean b)
      This function is used to display a HLCO chart in the form of a candlestick chart, depending on the value of parameter b. The default is false.

      Associated QbChart property: CANDLE_STICK

      Parameters:
      b - - if true, the chart is displayed in candlestick form, otherwise displayed in its usual form.

    • setScrollBarOption

      @Deprecated public static void setScrollBarOption(int option)
      Deprecated.
      This method is no longer existed. Please see quadbase.util.ICanvas.setScrollBarOption
      Sets the scrollbar option for the main chart panel.
      Parameters:
      option - Possible scrollbar option. Choices are: 
                  ScrollPane.SCROLLBARS_ALWAYS
            ScrollPane.SCROLLBARA_AS_NEEDED
            ScrollPane.SCROLLBARS_NEVER

    • geth3DControlPanel

      public final I3DControlPanel geth3DControlPanel()
      Returns a handle to properties of the 3D control panel. Properties of the panel can be directly changed by calling methods on this interface.
      Returns:
      a handle to the interface quadbase.util.I3DControlPanel.
      See Also:

    • geth3DProperties

      public final I3DPropertySet geth3DProperties()
      Returns a handle to properties specific to a 3D chart. Properties of a 3D chart can be directly changed by calling methods on this interface.
      Returns:
      a handle to the interface quadbase.util.I3DPropertySet.
      See Also:

    • gethMainTitle

      public final ITextString gethMainTitle()
      Returns a handle to the chart's main title. Properties of title can be directly changed by calling methods on this interface.
      Returns:
      a handle to the interface quadbase.util.ITextString.
      See Also:

    • gethLegend

      public final ILegend gethLegend()
      Returns a handle to the set of legend properties. Properties of the legend can be directly changed by calling methods on this interface.
      Returns:
      a handle to the interface quadbase.util.ILegend.
      See Also:

    • gethXAxis

      public final IAxis gethXAxis()
      Returns a handle to the set of X Axis properties. Properties of the axis can be directly changed by calling methods on this interface.
      Returns:
      a handle to the interface quadbase.util.IAxis of the X axis.
      See Also:

    • gethYAxis

      public final IAxis gethYAxis()
      Returns a handle to the set of Y Axis properties. Properties of the axis can be directly changed by calling methods on this interface.
      Returns:
      a handle to the interface quadbase.util.IAxis of the Y axis.
      See Also:

    • gethZAxis

      public final IAxis gethZAxis()
      Returns a handle to the set of Z Axis properties. Properties of the axis can be directly changed by calling methods on this interface.
      Returns:
      a handle to the interface quadbase.util.IAxis of the Z axis.
      See Also:

    • gethAxis

      public final IAxis gethAxis(int idx)
      Returns a handle to the set of Axis properties for radar or overlay. Properties of the axis can be directly changed by calling methods on this interface.
      Returns:
      a handle to the interface quadbase.util.IAxis.
      See Also:

    • gethCanvas

      public final ICanvas gethCanvas()
      Returns a handle to the chart canvas properties. Properties of the canvas can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.ICanvas.
      See Also:

    • gethHyperLinks

      public final IHyperLinkSet gethHyperLinks()
      Returns a handle to the set of hyperlink properties. Properties of hyperlinks can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.ChartAPI.swing.IHyperLink.
      See Also:

    • gethTrendLines

      @Deprecated public final ITrendLineSet gethTrendLines()
      Deprecated.
      Please use gethDataLines instead
      Returns a handle to the set of trend lines. Properties of trend lines can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.ChartAPI.swing.ITrendLineSet.
      See Also:

    • gethDataLines

      public final IDataLineSet gethDataLines()
      Returns a handle to the set of data lines. Properties of data lines can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.ChartAPI.swing.IDataLineSet.
      See Also:

    • gethControlRanges

      public final IControlRangeSet gethControlRanges()
      Returns a handle to the set of control ranges. Properties of control ranges can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IControlRangeSet.
      See Also:

    • gethDropBars

      public final IDropBarSet gethDropBars()
      Returns a handle to the set of drop bar. Properties of control ranges can be directly changed by calling methods on this interface. Only 2D LINE Chart with more than 1 series can support this method.
      Returns:
      a handle to quadbase.util.IDropBarSet.
      See Also:

    • gethAnnotations

      public final IAnnotationSet gethAnnotations()
      Returns a handle to the set of annotations.
      Returns:
      a handle to quadbase.ChartAPI.swing.IAnnotationSet.
      See Also:

    • gethFloatingLines

      public final IFloatingLineSet gethFloatingLines()
      Returns a handle to the set of free floating line on the chart canvas. Properties of lines can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IFloatingLineSet.
      See Also:

    • gethFloatingText

      public final IFloatingTextSet gethFloatingText()
      Returns a handle to the set of free floating text on the chart canvas. Properties of the text can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IFloatingTextSet.
      See Also:

    • gethChartPlot

      public final IPlot gethChartPlot()
      Returns a handle to the chart plot area. Properties of the chart's plot area can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IPlot.
      See Also:

    • gethInputData

      public final IInputData gethInputData()
      Returns a handle to the chart's input data properties, including file or database information, and accessing individual records. Properties of input data can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.ChartAPI.swing.IInputData.
      See Also:
      • invalid reference 
        quadbase.ChartAPI.swing.IInputData

    • gethDataPoints

      public final IDataPointSet gethDataPoints()
      Returns a handle to the chart data point properties interface. Properties for chart data points can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IDataPointSet.
      See Also:

    • gethBubbleProperties

      public final IBubblePropertySet gethBubbleProperties()
      Returns a handle to the bubble chart property interface. Bubble chart properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IBubblePropertySet.
      See Also:

    • gethPieProperties

      public final IPiePropertySet gethPieProperties()
      Returns a handle to the pie chart property interface. Pie chart properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IPiePropertySet.
      See Also:

    • gethSurfaceProperties

      public final ISurfacePropertySet gethSurfaceProperties()
      Returns a handle to the 3D surface chart property interface. Surface chart properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.ISurfacePropertySet.
      See Also:

    • gethDoughnutProperties

      public final IDoughnutPropertySet gethDoughnutProperties()
      Returns a handle to the doughnut chart property interface. Doughnut chart properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IDoughnutPropertySet.
      See Also:

    • gethOverlayProperties

      public final IOverlayPropertySet gethOverlayProperties()
      Returns a handle to the 2D overlay chart property interface. Overlay chart properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IOverlayPropertySet.
      See Also:

    • gethRadarProperties

      public final IRadarPropertySet gethRadarProperties()
      Returns a handle to the 2D radar chart property interface. Radar chart properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IRadarPropertySet.
      See Also:

    • gethPolarProperties

      public final IPolarPropertySet gethPolarProperties()
      Returns a handle to the 2D polar chart property interface. Polar chart properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IPolarPropertySet.
      See Also:

    • gethLineProperties

      public final ILinePropertySet gethLineProperties()
      Returns a handle to the 2D line chart property interface. Line chart properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.ILinePropertySet.
      See Also:

    • gethGanttProperties

      public final IGanttPropertySet gethGanttProperties()
      Returns a handle to the 2D Gantt chart property interface. Gantt chart properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IGanttPropertySet.
      See Also:

    • gethDialProperties

      public final IDialPropertySet gethDialProperties()
      Returns a handle to the 2D dial chart property interface. Dial chart properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IDialPropertySet.
      See Also:

    • gethBoxProperties

      public final IBoxPropertySet gethBoxProperties()
      Returns a handle to the 2D box chart property interface. Box chart properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IBoxPropertySet.
      See Also:

    • gethSecondaryChart

      public final ISecondaryChart gethSecondaryChart()
      Returns a handle to the secondary chart property interface. Sceondary chart properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.ISecondaryChart.
      See Also:

    • gethXRuler

      public final IAxisRuler gethXRuler()
      Returns a handle to the X axis ruler displayed on top of the chart canvas. Properties of the ruler can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IAxisRuler.
      See Also:

    • gethYRuler

      public final IAxisRuler gethYRuler()
      Returns a handle to the Y axis ruler displayed to the left of the chart canvas. Properties of the ruler can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IAxisRuler.
      See Also:

    • gethZoomInfo

      public final IZoomInfo gethZoomInfo()
      Returns a handle to the zoom property interface. Date/time based zoom properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IZoomInfo.
      See Also:

    • gethDrillDown

      public final IDrillDown gethDrillDown()
      Returns a handle to the Drill-Down interface. Drill-down charts can be designed by calling methods on this interface.
      See Also:

    • gethTable

      public final ITable gethTable()
      Return a handle to the Table interface Table can be designed by calling methods on this interface
      See Also:

    • gethHistogramInfo

      public final IHistogramInfo gethHistogramInfo()
      Returns a handle to the histogram property interface. Histogram properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IHistogramInfo.
      See Also:

    • gethAggregationInfo

      public final IAggregationInfo gethAggregationInfo()
      Returns a handle to the aggregation property interface. Aggregation properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.AggregationInfo.
      See Also:

    • gethMouseEvents

      public final IMouseEventSet gethMouseEvents()
      Returns a handle to the mouse event customization interface. Mouse modifiers and click counts for common events like dragging, resizing, zooming, and hyperlinks can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IMouseEventSet.
      See Also:

    • gethPopupMenu

      public final IPopupMenu gethPopupMenu()
      Returns a handle to the popup menu property interface for chartviewer. Popup menu proerties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.IPopupMenu.

    • gethNoDataToPlotMessage

      public final INoDataToPlotMessage gethNoDataToPlotMessage()
      Returns a handle to the no data to plot message property interface. No data to plot message properties can be directly changed by calling methods on this interface.
      Returns:
      a handle to quadbase.util.INoDataToPlotMessage.

    • setServerAddress

      public static void setServerAddress(String address) throws UnknownHostException
      Set the server address of EspressManager. Use this address instead of the one provided in the espressmanager.cfg file. It also eliminates the need of the espressmanager.cfg file in the working directory.
      Throws:
      UnknownHostException

    • setServerPortNumber

      public static void setServerPortNumber(int port)
      Set the port number of EspressManager. Use this port number instead of the one provided in the espressmanager.cfg file. It also eliminates the need of the espressmanager.cfg file in the working directory.

    • setServerHosts

      public static void setServerHosts(Vector<String> hostnames)
      Set the list of host names for EspressManager when tunneling is used. Use these hosts along with the ones provided in the espressmanager.cfg file. If the espressmanager.cfg file is not present, then only these hosts will be used.

    • getParameterPage

      public quadbase.common.param.ChartParameterPage getParameterPage(String chartLoc, int format, String servletName)
      Gets the ParameterPage for this report if and only if this is a Parameterized Report
      Parameters:
      chartLoc - the chart file location
      format - the export format
      servletName - the name of the servlet
      Returns:
      the parameter page as a ParameterPage object

    • useSingleTableForDistinctParamValue

      public static boolean useSingleTableForDistinctParamValue()
      This is for database query parameter that is mapped to database column only. Whether to use only a single table when retrieving distinct value for database query parameter, instead of applying the original query's filter and joining multiple tables.

    • setUseSingleTableForDistinctParamValue

      public static void setUseSingleTableForDistinctParamValue(boolean state)
      This is for database query parameter that is mapped to database column only. Sets whether to use only a single table when retrieving distinct value for database query parameter, instead of applying the original query's filter and joining multiple tables.

    • getUpdateVersion

      public static String getUpdateVersion()