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:

javax.accessibility.Accessible, java.awt.event.ActionListener, java.util.EventListener, java.io.Externalizable, IChart, quadbase.chartviewer.swing.IChartHolder, IChartTypeConstants, IExportConstants, java.awt.image.ImageObserver, IMapConstants, IMiscConstants, java.awt.MenuContainer, java.io.Serializable

Direct Known Subclasses:

DrillDownChart

public class QbChart

extends QbChartBasic

implements IChartTypeConstants, IExportConstants, 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 and VRML). 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:

Serialized Form

Inner classes inherited from class quadbase.ChartAPI.swing.QbChartBasic

QbChartBasic.CAxisRuler, QbChartBasic.CDataTopLabel, QbChartBasic.CDataTopLabel2, QbChartBasic.CMainTitle, QbChartBasic.CNoDataToPlotMessage, QbChartBasic.ControlPanel

Inner classes inherited from class javax.swing.JPanel

javax.swing.JPanel.AccessibleJPanel

Inner classes inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Inner classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Inner classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent

Field Summary

static int	OLAPDATA_CONCATENATELABEL
static int	OLAPDATA_DIRECT
static int	OLAPDATA_TRANSPOSECOLBREAK
static int	VIEW2D 2D chart
static int	VIEW3D 3D chart

Fields inherited from class quadbase.ChartAPI.swing.QbChartBasic

chart, forExportOnly, root

Fields inherited from class quadbase.ChartAPI.swing.QbChartPanel

listener

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface quadbase.util.IChartTypeConstants

AREA, BAR, BOX, BUBBLE, CHARTTYPENAME, COL, COMBO_COL, COMBO_LINE, COMBO_OVERLAY, COMBO_STACKAREA, COMBOTYPENAME, DIAL, GANTT, HILOW, HLCO, HTMLCENTER, HTMLHORIZONTAL, HTMLLEFT, HTMLRIGHT, HTMLVERTICAL, LINE, OVERLAY, PERCENTCOL, PIE, POLAR, RADAR, SCATTER, STACKAREA, STACKBAR, STACKCOL, SURFACE, TOTALTYPE, TOTALTYPE_2D, TOTALTYPE_3D, XYCHART

Fields inherited from interface quadbase.ChartAPI.swing.IExportConstants

BMP, CHT, CHT_DATA, COMMA, FLASH, GIF, GIF_C, GIF_N, GIF_R, JPEG, JPEG_C, PDF, PNG, PNG_COMPRESSION_DEFAULT, PNG_COMPRESSION_FAST, PNG_COMPRESSION_MAX, PNG_COMPRESSION_NONE, SEMICOLON, SPACE, SVG, TPL, TXTFORMAT, VRML, WMF, XMLFORMAT

Fields inherited from interface quadbase.ChartAPI.swing.IMiscConstants

ASCENDING, BOTTOM_ALIGNMENT, BOTTOM_ALIGNMENT_INSIDE, CENTER, CENTER_ALIGNMENT, CENTERALIGNMENT, CIRCLE, CLASSFILE, CROSS, DASH, DATAFILE, DESCENDING, DOWN, FIT, FLAT, FLAT_BORDER, GOURAUD, GOURAUD_BORDER, HORIZONTAL, INVERSE_TRIANGLE, LEFT_DOUBLECLICK, LEFT_SINGLECLICK, LEFTALIGNMENT, LOWER, NONE, NOSYMBOL, PATTERN_BACKWARD_DIAGONAL, PATTERN_BIG_CIRCLE, PATTERN_BIG_REV_TRIANGLE, PATTERN_BIG_TRIANGLE, PATTERN_BLANK, PATTERN_CHESSBOX, PATTERN_CLUB, PATTERN_CROSS_ECLIPSE, PATTERN_DIAGONAL_CROSS, PATTERN_DIAMOND, PATTERN_FORWARD_DIAGONAL, PATTERN_HEART, PATTERN_HOLLOW_CIRCLE, PATTERN_HOLLOW_DIAMOND, PATTERN_HOLLOW_SQUARE, PATTERN_HOLLOW_TRIANGLE, PATTERN_HORIZONTAL_LINE, PATTERN_LOWER_TRIANGLE, PATTERN_MID_CROSS, PATTERN_SMALL_BLOCK, PATTERN_SMALL_CIRCLE, PATTERN_SMALL_REV_TRIANGLE, PATTERN_SMALL_TRIANGLE, PATTERN_STAR, PATTERN_THICK_BACKWARD_DIAGONAL, PATTERN_THICK_FORWARD_DIAGONAL, PATTERN_THICK_HORIZONTAL, PATTERN_THICK_VERTICAL, PATTERN_UPPER_TRIANGLE, PATTERN_VERTICAL_LINE, PLAIN, PLUS, QUERYFILE, RAISE, RIGHT, RIGHT_DOUBLECLICK, RIGHT_SINGLECLICK, RIGHTALIGNMENT, SHADOW, SQUARE, STAR, TILE, TOP_ALIGNMENT, TOP_ALIGNMENT_INSIDE, TRIANGLE, VERTICAL, WIREFRAME, XMLFILE

Fields inherited from interface quadbase.util.IMapConstants

CATEGORY, CLOSE, END_DATE, HIGH, LOW, OPEN, SCATTER_X, SCATTER_Y, SCATTER_Z, SECONDARY_SERIES, SECONDARY_VALUE, SERIES, START_DATE, SUB_TASK, SUMBY, TASK, VALUE

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

	QbChart() Create a new chart.
	QbChart(java.applet.Applet applet, byte[] chartData) Create a QbChart object from a byte array that is obtained by the exportChartToByteArray method in this class.
	QbChart(java.applet.Applet applet, byte[] chartData, boolean template)
	QbChart(java.applet.Applet applet, int dimension, int chartType, DataSheet[] dataSheet, boolean doTransposeData, IColumnMap cmap, java.lang.String template) Create a new chart, given the chart type, dimension and a template.
	QbChart(java.applet.Applet applet, int dimension, int chartType, DataSheet[] dataSheet, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, java.lang.String template) Create a new chart, given the chart type, dimension and a template.
	QbChart(java.applet.Applet applet, int dimension, int chartType, EJBInfo ejbInfo, IColumnMap cmap, java.lang.String template) Create a QbChart object using the specified EJbInfo object
	QbChart(java.applet.Applet applet, int dimension, int chartType, IDatabaseInfo dbinfo, boolean doTransposeData, IColumnMap cmap, java.lang.String template) Create a new chart, given the chart type, dimension, and a template.
	QbChart(java.applet.Applet applet, int dimension, int chartType, IDatabaseInfo dbinfo, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, java.lang.String template) Create a new chart, given the chart type, dimension, and a template.
	QbChart(java.applet.Applet applet, int dimension, int chartType, IDatabaseInfo dbinfo, IColumnMap cmap) Create a new chart with specific chart type and dimension.
	QbChart(java.applet.Applet applet, int dimension, int chartType, IDatabaseInfo dbinfo, IColumnMap cmap, java.lang.String template) Create a new chart, given the chart type, dimension, and a template.
	QbChart(java.applet.Applet applet, int dimension, int chartType, int fileType, java.lang.String filename, boolean doTransposeData, IColumnMap cmap, java.lang.String template) Create a new chart, given the chart type, dimension, and a template.
	QbChart(java.applet.Applet applet, int dimension, int chartType, int fileType, java.lang.String filename, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, java.lang.String template) Create a new chart, given the chart type, dimension, and a template.
	QbChart(java.applet.Applet applet, int dimension, int chartType, IOLAPResultSet olapRS, int inputMethod, IColumnMap cmap, java.lang.String template, boolean doTransposeData, boolean[] transposeCol)
	QbChart(java.applet.Applet applet, int dimension, int chartType, IResultSet data, boolean doTransposeData, IColumnMap cmap, java.lang.String template) Create a new chart, given the chart type, dimension and a template.
	QbChart(java.applet.Applet applet, int dimension, int chartType, IResultSet data, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, java.lang.String template) Create a new chart, given the chart type, dimension and a template.
	QbChart(java.applet.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.
	QbChart(java.applet.Applet applet, int dimension, int chartType, IResultSet data, IColumnMap cmap, java.lang.String template) Create a new chart, given the chart type, dimension and a template.
	QbChart(java.applet.Applet applet, int dimension, int chartType, ISpreadSheetModel sheet, IColumnMap cmap, java.lang.String template) Create a new chart, given the chart type, dimension and a template.
	QbChart(java.applet.Applet applet, int dimension, int chartType, java.lang.String dataFile, boolean doTransposeData, IColumnMap cmap, java.lang.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.
	QbChart(java.applet.Applet applet, int dimension, int chartType, java.lang.String dataFile, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, java.lang.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.
	QbChart(java.applet.Applet applet, int dimension, int chartType, java.lang.String dataFile, IColumnMap cmap) Deprecated. Please use the constructor having a template as its last argument. Then use null as the last argument.
	QbChart(java.applet.Applet applet, int dimension, int chartType, java.lang.String dataFile, IColumnMap cmap, java.lang.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.
	QbChart(java.applet.Applet applet, int dimension, int chartType, java.lang.String connectionString, java.lang.String MDXQuery, int inputMethod, IColumnMap cmap, java.lang.String template, boolean doTransposeData, boolean[] transposeCol)
	QbChart(java.applet.Applet applet, int dimension, int chartType, java.lang.String uri, java.lang.String datasource, java.lang.String catalog, java.lang.String MDXQuery, int inputMethod, IColumnMap cmap, java.lang.String template, boolean doTransposeData, boolean[] transposeCol)
	QbChart(java.applet.Applet applet, int dimension, int chartType, java.lang.String jndiName, java.lang.String homeName, java.lang.String remoteName, java.lang.String selectedMethodName, java.lang.Object[] selectedMethodParamVal, java.util.Hashtable environment, IColumnMap cmap, java.lang.String template, boolean doTransposeData, boolean[] transposeCol)
	QbChart(java.applet.Applet applet, int dimension, int chartType, java.lang.String jndiName, java.lang.String homeName, java.lang.String remoteName, java.lang.String selectedMethodName, java.lang.Object[] selectedMethodParamVal, IColumnMap cmap, java.lang.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(java.applet.Applet applet, int dimension, int chartType, XMLFileQueryInfo xmlInfo, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, java.lang.String template) Create a new chart, given the xml information.
	QbChart(java.applet.Applet applet, java.lang.String fileName) Create a new chart using a CHT/TPL chart file.
	QbChart(java.applet.Applet applet, java.lang.String fileName, java.lang.Object req) Create a QbChart object from an "tpl" or "rpt" file with parameterized query.
	QbChart(java.applet.Applet applet, java.lang.String fileName, java.lang.Object[] parameter)
	QbChart(java.applet.Applet applet, java.lang.String fileName, java.lang.Object[] parameter, boolean isEnterpriseServer)
protected	QbChart(boolean forReport)
	QbChart(quadbase.chart.Chart chart)
	QbChart(java.awt.Frame frame, int dimension, int chartType, EJBInfo ejbInfo, IColumnMap cmap, java.lang.String template) Create a QbChart object using the specified EJbInfo object
	QbChart(java.awt.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
	QbChart(java.awt.Frame frame, int dimension, int chartType, IDatabaseInfo dbinfo, IColumnMap cmap, java.lang.String template) Deprecated. Please use the constructor having the applet parameter. Use "(Applet) null" as the first argument.
	QbChart(java.awt.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.
	QbChart(java.awt.Frame frame, int dimension, int chartType, IResultSet data, IColumnMap cmap, java.lang.String template) Deprecated. Please use the constructor having the applet parameter. Use "(Applet) null" as the first argument.
	QbChart(java.awt.Frame frame, int dimension, int chartType, java.lang.String dataFile, IColumnMap cmap) Deprecated. Please use the constructor having a template as its last argument. Then use null as the last argument.
	QbChart(java.awt.Frame frame, int dimension, int chartType, java.lang.String dataFile, IColumnMap cmap, java.lang.String template) Deprecated. Please use the constructor having the applet parameter. Use "(Applet) null" as the first argument.
	QbChart(java.awt.Frame frame, int dimension, int chartType, java.lang.String jndiName, java.lang.String homeName, java.lang.String remoteName, java.lang.String selectedMethodName, java.lang.Object[] selectedMethodParamVal, IColumnMap cmap, java.lang.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(java.awt.Frame frame, int dimension, int chartType, XMLFileQueryInfo xmlInfo, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, java.lang.String template) Create a new chart, given the xml information.
	QbChart(java.awt.Frame frame, java.lang.String fileName) Deprecated. Please use the constructor having the applet parameter. Use "(Applet) null" as the first argument.
	QbChart(java.awt.Frame frame, java.lang.String fileName, java.lang.Object req) Create a QbChart object from an "tpl" or "rpt" file with parameterized query.
	QbChart(QbChart qbchart) Create a new chart using an existing chart object.

Method Summary

void	applyAntiAliasToChatAreaOnly(boolean b)
void	applyTemplateFile(java.lang.String fileName) Applies the given template to the current chart.
DrillDownChart	createDrillDownChart(java.lang.String name, int chartDim, int chartType, IDatabaseInfo dbInfo, boolean doTransposeData, int[] transposeCol, IColumnMap mapping, java.lang.String template, int[] columnMapping) Create a drill-down chart that will be an immediate child of the calling chart
void	draw(java.awt.Graphics g, java.awt.Component component, int width, int height) This method draws the chart given a Graphics object.
java.awt.Image	export() Exports the chart to an image Object.
void	export(int format, java.io.OutputStream out) Export the chart
void	export(int format, java.io.OutputStream out, int w, int h) Export the chart
void	export(int format, java.io.OutputStream out, int w, int h, int option) Export the chart
void	export(int format, java.io.OutputStream image, java.io.OutputStream subFile, java.lang.String fileName, int w, int h, boolean generateSubFile, int option) Export the chart
void	export(int format, java.io.OutputStream image, java.io.OutputStream subFile, java.lang.String filename, java.lang.String chartLocation, int w, int h, java.lang.String servletLoc, PickData[] pickData, java.lang.String[] argv, int option) Export the chart with drill down map
void	export(int format, java.lang.String filename) Export the chart with dimensions equal to that of the current chart.
void	export(int format, java.lang.String filename, int w, int h) Export the chart
void	export(int format, java.lang.String filename, int w, int h, int option) Export the chart
void	export(int format, java.lang.String filename, java.lang.String subFilename) Export the chart with dimensions equal to that of the current chart.
void	export(int format, java.lang.String filename, java.lang.String subFilename, int w, int h) Export the chart
void	export(int format, java.lang.String filename, java.lang.String subFilename, int w, int h, boolean generateSubFile) Export the chart
void	export(int format, java.lang.String filename, java.lang.String subFilename, int w, int h, boolean generateSubFile, int option) Export the chart
void	export(int format, java.lang.String filename, java.lang.String drillDownChartName, int w, int h, java.lang.String servletLoc) Export the chart with drill down map (top level only)
void	export(int format, java.lang.String filename, java.lang.String drillDownChartName, int w, int h, java.lang.String servletLoc, PickData[] pickData) Export the chart with drill down map
void	export(int format, java.lang.String filename, java.lang.String drillDownChartName, int w, int h, java.lang.String servletLoc, PickData[] pickData, java.lang.String[] argv) Export the chart with drill down map
void	export(int format, java.lang.String filename, java.lang.String chartLocation, int w, int h, java.lang.String servletLoc, PickData[] pickData, java.lang.String[] argv, int option) Export the chart with drill down map
void	export(int format, java.lang.String filename, java.lang.String drillDownChartName, int w, int h, java.lang.String servletLoc, java.lang.String[] argv) Export the chart with drill down map (top level only)
void	export(int format, java.lang.String filename, java.lang.String drillDownChartName, java.lang.String servletLoc) Export the chart with drill down map (top level only)
void	export(int format, java.lang.String filename, java.lang.String drillDownChartName, java.lang.String servletLoc, PickData[] pickData) Export the chart with drill down map
byte[]	exportChartToByteArray() Exports the chart to byte array.
byte[]	exportChartToByteArray(boolean template)
java.lang.String	exportChartToString() Exports the chart to String object which can use any chart viewer to re-open it again.
void	exportDataFile(java.io.PrintStream out, int separator, int format) Export Data File
void	exportDataFile(java.lang.String fileName, int separator, int format) Export Data File
protected void	finalize()
java.applet.Applet	getApplet() Return applet
java.lang.Object	getArgument() Get the argument of the event, PickData if data is selected or String which describes the object otherwise
int	getBufferedImageType() Returns java.awt.image.BufferedImage image type Note this method only works with JDK 1.2 or above
IChartGraphics	getChartGraphics() return chart graphics object
int	getDimension() Returns the dimension (2D or 3D) of the chart.
DrillDownChart	getDrillDownChart(java.lang.String name) Return the drill-down chart with the matching name
DrillDownChart	getDrillDownChartAt(int index) Return the drill-down chart at the specific index
int	getDrillDownChartCount() The number of drill-down charts immediately accessible
java.lang.String	getErrorMessage() Return error message from the constructor of QbChart
java.lang.String	getFile() Returns the name of the (CHT or TPL) file from which the chart is loaded.
static int	getFileRecordBufferSize() get the number of record to store on disk at a time when using record file data to generate the report
I3DControlPanel	geth3DControlPanel() Returns a handle to properties of the 3D control panel.
I3DPropertySet	geth3DProperties() Returns a handle to properties specific to a 3D chart.
IAnnotationSet	gethAnnotations() Returns a handle to the set of annotations.
IAxis	gethAxis(int idx) Returns a handle to the set of Axis properties for radar or overlay.
IBoxPropertySet	gethBoxProperties() Returns a handle to the 2D box chart property interface.
IBubblePropertySet	gethBubbleProperties() Returns a handle to the bubble chart property interface.
ICanvas	gethCanvas() Returns a handle to the chart canvas properties.
IPlot	gethChartPlot() Returns a handle to the chart plot area.
IControlRangeSet	gethControlRanges() Returns a handle to the set of control ranges.
IDataLineSet	gethDataLines() Returns a handle to the set of data lines.
IDataPointSet	gethDataPoints() Returns a handle to the chart data point properties interface.
IDialPropertySet	gethDialProperties() Returns a handle to the 2D dial chart property interface.
IDoughnutPropertySet	gethDoughnutProperties() Returns a handle to the doughnut chart property interface.
IDrillDown	gethDrillDown() Returns a handle to the Drill-Down interface.
IDropBarSet	gethDropBars() Returns a handle to the set of drop bar.
IFloatingLineSet	gethFloatingLines() Returns a handle to the set of free floating line on the chart canvas.
IFloatingTextSet	gethFloatingText() Returns a handle to the set of free floating text on the chart canvas.
IGanttPropertySet	gethGanttProperties() Returns a handle to the 2D Gantt chart property interface.
IHistogramInfo	gethHistogramInfo() Returns a handle to the histogram property interface.
IHyperLinkSet	gethHyperLinks() Returns a handle to the set of hyperlink properties.
IInputData	gethInputData() Returns a handle to the chart's input data properties, including file or database information, and accessing individual records.
ILegend	gethLegend() Returns a handle to the set of legend properties.
ILinePropertySet	gethLineProperties() Returns a handle to the 2D line chart property interface.
ITextString	gethMainTitle() Returns a handle to the chart's main title.
IMouseEventSet	gethMouseEvents() Returns a handle to the mouse event customization interface.
INoDataToPlotMessage	gethNoDataToPlotMessage() Returns a handle to the no data to plot message property interface.
IOverlayPropertySet	gethOverlayProperties() Returns a handle to the 2D overlay chart property interface.
IPiePropertySet	gethPieProperties() Returns a handle to the pie chart property interface.
IPolarPropertySet	gethPolarProperties() Returns a handle to the 2D polar chart property interface.
IPopupMenu	gethPopupMenu() Returns a handle to the popup menu property interface for chartviewer.
IRadarPropertySet	gethRadarProperties() Returns a handle to the 2D radar chart property interface.
ISecondaryChart	gethSecondaryChart() Returns a handle to the secondary chart property interface.
ISurfacePropertySet	gethSurfaceProperties() Returns a handle to the 3D surface chart property interface.
ITable	gethTable() Return a handle to the Table interface Table can be designed by calling methods on this interface
java.lang.String	getHTMLParamPage(java.lang.String servletName) Deprecated. use QbChart.getParameterPage(String, int, String) instead For parameterized chart, generate the html page for user to enter the paramters
java.lang.String	getHTMLParamPage(java.lang.String chartLoc, int format, java.lang.String servletName) Deprecated. use QbChart.getParameterPage(String, int, String) instead For parameterized chart, generate the html page for user to enter the paramters
java.lang.String	getHTMLParamPageBlock() Deprecated. use QbChart.getParameterPage(String, int, String) instead For parameterized chart, generate the html page body for user to enter the paramters
java.lang.String	getHTMLParamPageBody(java.lang.String servletName) Deprecated. use QbChart.getParameterPage(String, int, String) instead For parameterized chart, generate the html page for user to enter the paramters
java.lang.String	getHTMLParamPageBody(java.lang.String chartLoc, int format, java.lang.String servletName) Deprecated. use QbChart.getParameterPage(String, int, String) instead For parameterized chart, generate the html page for user to enter the paramters
ITrendLineSet	gethTrendLines() Deprecated. Please use gethDataLines instead
IAxis	gethXAxis() Returns a handle to the set of X Axis properties.
IAxisRuler	gethXRuler() Returns a handle to the X axis ruler displayed on top of the chart canvas.
IAxis	gethYAxis() Returns a handle to the set of Y Axis properties.
IAxisRuler	gethYRuler() Returns a handle to the Y axis ruler displayed to the left of the chart canvas.
IAxis	gethZAxis() Returns a handle to the set of Z Axis properties.
IZoomInfo	gethZoomInfo() Returns a handle to the zoom property interface.
ICustomizeImageMapDataHintBox	getImageMapDataHintBoxHandle()
java.util.Locale	getLocale() Gets the locale of this component
static int	getMaxCharForRecordFile() get max number of character for record in column when using record file to generate the report
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)
int	getModifier() Return mouse modifier
ChartParameterPage	getParameterPage(java.lang.String chartLoc, int format, java.lang.String servletName) Gets the ParameterPage for this report if and only if this is a Parameterized Report
static int	getPickDataCount(java.lang.String param) get number of PickData in given drill-down link
java.awt.Dimension	getPreferredSize() Overrides component getPreferredSize().
static int	getQueryTimeout() retrieves the number of seconds the driver will wait for a statement object to execute.
static java.lang.String	getServletContext() return servlet context
static java.lang.String	getTempDirectory() get temp directory for using record file to generate the report DEFAULT temp directory is "temp/"
java.lang.String	getTemplateFile() Returns the name of the template applied to the current chart, if any.
java.util.TimeZone	getTimeZone() Gets the time zone
int	getType() Returns the type of the chart.
static java.lang.String	getUpdateVersion()
static java.lang.String	getVersion() Returns EspressChart Version Number
boolean	isAdjustFont() Return whether adjust the font based on the screen resolution.
boolean	isBackgroundTransparent() Returns whether a chart background is transparent when exporting a chart to GIF format
boolean	isBufferedImageUsed() Returns whether the QbChart to use java.awt.image.BufferedImage technology to export image Note this method only works with JDK 1.2 or above
static boolean	isChartServerUsed() Returns whether the chart server is used for input/output, If false, the package performs file and database reads/writes directly.
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
static boolean	isEspressManagerUsed() Returns whether EspressManager is used for input/output.
boolean	isFieldDrillDownChart()
boolean	isFieldDrillDownEnabled()
static boolean	isForExportOnly() Returns whether QbChart is optimized for exporting chart images
boolean	isHiLowAsCandleStick() Returns true if a hi-low chart is to be displayed in the form of a candlestick chart.
boolean	isPrintKeyEnabled() Returns true if accelerator keys are enabled to export a chart as an image in order to facilitate printing.
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
void	loadFile(java.lang.String fileName) Loads the chart from the given CHT or TPL file.
void	readExternal(java.io.ObjectInput in) This method provides support for reading serialized charts
void	refresh() Reload the chart data from input database or data file.
void	repaintPanel() This method repaints the viewpanel that contains a chart
void	setAddOnChart(QbChart[] qbCharts) Customize chart graphics information or draw user specify component onto chart canvas
void	setAdjustFont(boolean state) Specify whether should adjust the font based on the screen resolution.
void	setApplet(java.applet.Applet applet) Set the applet containing this chart component.
void	setBackgroundTransparent(boolean b) Set background color to transparent when exporting a chart to GIF format
void	setBufferedImageType(int imageType) Sets java.awt.image.BufferedImage image type Note this method only works with JDK 1.2 or above
void	setBufferedImageUsed(boolean state) Sets whether the QbChart to use java.awt.image.BufferedImage technology to export image Note this method only works with JDK 1.2 or above
void	setChartGraphics(IChartGraphics chartGraphics) Customize chart graphics information or draw user specify component onto chart canvas
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.
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.
static void	setChartServerUsed(java.lang.String str) Use this to specify whether to use the chart server for input/output, or perform file and database reads/writes directly.
static void	setConnectURLForServer(java.lang.String comm_url) Set direct connect url for reverse proxy server Note: this static method MUST be called before any QbChart constructor
static void	setDebugMode(int mode) set debug mode to display debug statement
static void	setDebugMode(java.lang.String mode) set debug mode to display debug statement
void	setDimension(int d) Sets the dimension (2D or 3D) of the chart.
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
void	setDrillDownPath(java.lang.String path)
static void	setEspressManagerUsed(boolean b) Use this to specify whether to use EspressManager for input/output, or perform file and database reads/writes directly.
static void	setEspressManagerUsed(int num) Use this to specify whether to use EspressManager for input/output, or perform file and database reads/writes directly.
static void	setEspressManagerUsed(java.lang.String str) Use this to specify whether to use EspressManager for input/output, or perform file and database reads/writes directly.
static void	setFileRecordBufferSize(int r) 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)
static void	setForExportOnly(boolean state) Sets whether the QbChart object is only used for exporting charts later.
static void	setGIFEnable(java.lang.String serialNumber, java.lang.String key) Sets whether the Qbchart can generate GIF or not
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.
void	setImageMapDataHintBoxHandle(ICustomizeImageMapDataHintBox val)
void	setLocale(java.util.Locale locale) Sets the locale of this component
static void	setMaxCharForRecordFile(int r) set max number of character for record in column when using record file to generate the report
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)
void	setOpaque(boolean isOpaque) Sets the opaque of this component (for swing version only)
void	setPanelBorder(java.lang.Object border) Sets the border of this component (for swing version only)
void	setParamPageAlignment(int alignment) Deprecated. use QbChart.getParameterPage(String,int,String).setAlignment(int) instead Set the alignment of the form of the parameter HTML page
void	setParamPageBackgroundColor(java.lang.String color) Deprecated. use QbChart.getParameterPage(String,int,String).setTableBackgroundColor(String) instead Set the parameter HTML page background color as hex number
void	setParamPageBorderColor(java.awt.Color color) Deprecated. use QbChart.getParameterPage(String,int,String).setTableBorderColor(Color) instead Set the parameter page border color as Color object
void	setParamPageBorderColor(java.lang.String color) Deprecated. use QbChart.getParameterPage(String,int,String).setTableBorderColor(String) instead Set the parameter page border color as hex value
void	setParamPageBorderThickness(int thickness) Deprecated. use QbChart.getParameterPage(String,int,String).setTableBorderThickness(int) instead Set the border thickness of the parameter HTML page
void	setParamPageFooter(java.lang.String footer) Deprecated. use QbChart.getParameterPage(String,int,String).setFooter(String) instead Set the parameter HTML page footer
void	setParamPageHeader(java.lang.String header) Deprecated. use QbChart.getParameterPage(String,int,String).setHeader(String) instead Set the parameter HTML page header
void	setParamPageLayout(int layout) Deprecated. use QbChart.getParameterPage(String,int,String).setTableLayout(int) instead Set the layout of the form of the parameter HTML page
void	setParamPageOuterBorder(boolean state) Deprecated. use QbChart.getParameterPage(String,int,String).setTableOuterBorderOnly(boolean) instead Whether only show the outer border of the form of the parameter HTML page
void	setParamPageResetEnabled(boolean state) Deprecated. use QbChart.getParameterPage(String,int,String).setResetEnabled(boolean) instead Whether enable the reset button in the form of the parameter HTML page
void	setParamPageTextFontColor(java.awt.Color color) Deprecated. use QbChart.getParameterPage(String,int,String).setTextColor(Color) instead Set the parameter page text font color as Color object
void	setParamPageTextFontColor(java.lang.String color) Deprecated. use QbChart.getParameterPage(String,int,String).setTextColor(String) instead Set the parameter HTML page text font color as hex value
void	setParamPageTextFontName(java.lang.String name) Deprecated. use QbChart.getParameterPage(String,int,String).setTextFont(String) instead Set the parameter HTML page text font name
void	setParamPageTextFontSize(int size) Deprecated. use QbChart.getParameterPage(String,int,String).setTextSize(int) instead Set the parameter HTML page text font size
void	setParamPageTextFontStyle(int style) Deprecated. use QbChart.getParameterPage(String,int,String).setTextStyle(int) instead Set the parameter page text font style
void	setParamPageTitle(java.lang.String title) Deprecated. use QbChart.getParameterPage(String,int,String).setDocumentTitle(String) instead Set the parameter HTML page title
void	setParamPageTitleFontColor(java.awt.Color color) Deprecated. use QbChart.getParameterPage(String,int,String).setTitleTextColor(Color) instead Set the paramter HTML page title font color as Color object
void	setParamPageTitleFontColor(java.lang.String color) Deprecated. use QbChart.getParameterPage(String,int,String).setTitleTextColor(String) instead Set the parameter HTML page title font color as hex number
void	setParamPageTitleFontName(java.lang.String name) Deprecated. use QbChart.getParameterPage(String,int,String).setTitleTextFont(String) instead Set the paramter HTML page title font name
void	setParamPageTitleFontSize(int size) Deprecated. use QbChart.getParameterPage(String,int,String).setTitleTextSize(int) instead set the parameter HTML page title font size
void	setParamPageTitleFontStyle(int style) Deprecated. use QbChart.getParameterPage(String,int,String).setTitleTextStyle(int) instead Set the parameter HTML page title font style
void	setPreferredSize(java.awt.Dimension d) Set the preferred size for this component.
void	setPrintKeyEnabled(boolean b) This function is used to enable accelerator keys to export a chart as an image in order to facilitate printing.
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
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.
void	setRenderingHint(java.lang.Object hintKey, java.lang.Object hintValue) Sets the value of a single preference for the rendering algorithms.
static void	setScrollBarOption(int option) Deprecated. This method is no longer existed. Please see quadbase.util.ICanvas.setScrollBarOption
static void	setServerAddress(java.lang.String address) Set the server address of EspressManager.
static void	setServerHosts(java.util.Vector hostnames) Set the list of host names for EspressManager when tunneling is used.
static void	setServerPortNumber(int port) Set the port number of EspressManager.
static void	setServletContext(java.lang.String context)
static void	setServletRunner(java.lang.String comm_url) Set servlet runner hostname and port number Note: this static method MUST be called before any QbChart constructor
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.
static void	setTempDirectory(java.lang.String str) set temp directory for using record file to generate the report DEFAULT temp directory is "temp/"
void	setTimeZone(java.util.TimeZone zone) Sets the time zone
void	setType(int type) Sets the type of the chart.
static void	setUseSingleTableForDistinctParamValue(boolean state) This is for database query parameter that is mapped to database column only.
static PickData[]	toPickData(java.lang.String param) convert drill-down link "PARAM" to PickData[]
void	updateDrillDownCharts()
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.
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.
static boolean	useSingleTableForDistinctParamValue() This is for database query parameter that is mapped to database column only.
void	writeExternal(java.io.ObjectOutput out) This method provides support for writing serialized charts

Methods inherited from class quadbase.ChartAPI.swing.QbChartBasic

actionPerformed, addKeyListener, addMouseListener, addMouseMotionListener, createChart, getChart, paint, paintAll, print, printAll, removeKeyListener, removeMouseListener, removeMouseMotionListener, setChartHolder, setViewPanel

Methods inherited from class quadbase.ChartAPI.swing.QbChartPanel

addActionListener, fireEvent

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUIClassID, paramString, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVerifyInputWhenFocusTarget, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, hide, isDoubleBuffered, isFocusCycleRoot, isFocusTraversable, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, printBorder, printChildren, printComponent, processComponentKeyEvent, processFocusEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setRequestFocusEnabled, setToolTipText, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getInputContext, getInputMethodRequests, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, imageUpdate, inside, isDisplayable, isEnabled, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, postEvent, prepareImage, prepareImage, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus

Methods inherited from class java.lang.Object

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

Field Detail

VIEW2D

public static final int VIEW2D

2D chart

VIEW3D

public static final int VIEW3D

3D chart

OLAPDATA_TRANSPOSECOLBREAK

public static final int OLAPDATA_TRANSPOSECOLBREAK

OLAPDATA_DIRECT

public static final int OLAPDATA_DIRECT

OLAPDATA_CONCATENATELABEL

public static final int OLAPDATA_CONCATENATELABEL

Constructor Detail

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(java.applet.Applet applet,
               java.lang.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(java.applet.Applet applet,
               java.lang.String fileName,
               java.lang.Object[] parameter)

QbChart

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

QbChart

public QbChart(java.awt.Frame frame,
               java.lang.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(java.applet.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

public QbChart(java.awt.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(java.applet.Applet applet,
               int dimension,
               int chartType,
               IDatabaseInfo dbinfo,
               IColumnMap cmap,
               java.lang.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(java.applet.Applet applet,
               int dimension,
               int chartType,
               IDatabaseInfo dbinfo,
               boolean doTransposeData,
               IColumnMap cmap,
               java.lang.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(java.applet.Applet applet,
               int dimension,
               int chartType,
               IDatabaseInfo dbinfo,
               boolean doTransposeData,
               int[] transposeCol,
               IColumnMap cmap,
               java.lang.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

public QbChart(java.awt.Frame frame,
               int dimension,
               int chartType,
               IDatabaseInfo dbinfo,
               IColumnMap cmap,
               java.lang.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

public QbChart(java.applet.Applet applet,
               int dimension,
               int chartType,
               java.lang.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

public QbChart(java.awt.Frame frame,
               int dimension,
               int chartType,
               java.lang.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(java.applet.Applet applet,
               int dimension,
               int chartType,
               EJBInfo ejbInfo,
               IColumnMap cmap,
               java.lang.String template)

Create a QbChart object using the specified EJbInfo object

QbChart

public QbChart(java.awt.Frame frame,
               int dimension,
               int chartType,
               EJBInfo ejbInfo,
               IColumnMap cmap,
               java.lang.String template)

Create a QbChart object using the specified EJbInfo object

QbChart

public QbChart(java.applet.Applet applet,
               int dimension,
               int chartType,
               java.lang.String jndiName,
               java.lang.String homeName,
               java.lang.String remoteName,
               java.lang.String selectedMethodName,
               java.lang.Object[] selectedMethodParamVal,
               IColumnMap cmap,
               java.lang.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(java.awt.Frame frame,
               int dimension,
               int chartType,
               java.lang.String jndiName,
               java.lang.String homeName,
               java.lang.String remoteName,
               java.lang.String selectedMethodName,
               java.lang.Object[] selectedMethodParamVal,
               IColumnMap cmap,
               java.lang.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(java.applet.Applet applet,
               int dimension,
               int chartType,
               java.lang.String jndiName,
               java.lang.String homeName,
               java.lang.String remoteName,
               java.lang.String selectedMethodName,
               java.lang.Object[] selectedMethodParamVal,
               java.util.Hashtable environment,
               IColumnMap cmap,
               java.lang.String template,
               boolean doTransposeData,
               boolean[] transposeCol)

QbChart

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

QbChart

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

QbChart

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

QbChart

public QbChart(java.applet.Applet applet,
               int dimension,
               int chartType,
               java.lang.String dataFile,
               IColumnMap cmap,
               java.lang.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

public QbChart(java.applet.Applet applet,
               int dimension,
               int chartType,
               java.lang.String dataFile,
               boolean doTransposeData,
               IColumnMap cmap,
               java.lang.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

public QbChart(java.applet.Applet applet,
               int dimension,
               int chartType,
               java.lang.String dataFile,
               boolean doTransposeData,
               int[] transposeCol,
               IColumnMap cmap,
               java.lang.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(java.applet.Applet applet,
               int dimension,
               int chartType,
               int fileType,
               java.lang.String filename,
               boolean doTransposeData,
               IColumnMap cmap,
               java.lang.String template)
        throws java.lang.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.

See Also:

IQueryFileInfo, ISpreadSheetModel, IColumnMap

QbChart

public QbChart(java.applet.Applet applet,
               int dimension,
               int chartType,
               int fileType,
               java.lang.String filename,
               boolean doTransposeData,
               int[] transposeCol,
               IColumnMap cmap,
               java.lang.String template)
        throws java.lang.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.

See Also:

IQueryFileInfo, ISpreadSheetModel, IColumnMap

QbChart

public QbChart(java.applet.Applet applet,
               int dimension,
               int chartType,
               XMLFileQueryInfo xmlInfo,
               boolean doTransposeData,
               int[] transposeCol,
               IColumnMap cmap,
               java.lang.String template)
        throws java.lang.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.

See Also:

ISpreadSheetModel, IColumnMap

QbChart

public QbChart(java.awt.Frame frame,
               int dimension,
               int chartType,
               XMLFileQueryInfo xmlInfo,
               boolean doTransposeData,
               int[] transposeCol,
               IColumnMap cmap,
               java.lang.String template)
        throws java.lang.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.

See Also:

ISpreadSheetModel, IColumnMap

QbChart

public QbChart(java.awt.Frame frame,
               int dimension,
               int chartType,
               java.lang.String dataFile,
               IColumnMap cmap,
               java.lang.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:

applet - an applet containing the chart. Use 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).

QbChart

public QbChart(java.applet.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

public QbChart(java.awt.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(java.applet.Applet applet,
               int dimension,
               int chartType,
               IResultSet data,
               IColumnMap cmap,
               java.lang.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(java.applet.Applet applet,
               int dimension,
               int chartType,
               IResultSet data,
               boolean doTransposeData,
               IColumnMap cmap,
               java.lang.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(java.applet.Applet applet,
               int dimension,
               int chartType,
               IResultSet data,
               boolean doTransposeData,
               int[] transposeCol,
               IColumnMap cmap,
               java.lang.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

public QbChart(java.awt.Frame frame,
               int dimension,
               int chartType,
               IResultSet data,
               IColumnMap cmap,
               java.lang.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(java.applet.Applet applet,
               int dimension,
               int chartType,
               ISpreadSheetModel sheet,
               IColumnMap cmap,
               java.lang.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(java.applet.Applet applet,
               int dimension,
               int chartType,
               DataSheet[] dataSheet,
               boolean doTransposeData,
               IColumnMap cmap,
               java.lang.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(java.applet.Applet applet,
               int dimension,
               int chartType,
               DataSheet[] dataSheet,
               boolean doTransposeData,
               int[] transposeCol,
               IColumnMap cmap,
               java.lang.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(java.applet.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(java.applet.Applet applet,
               byte[] chartData,
               boolean template)

QbChart

protected QbChart(boolean forReport)

QbChart

public QbChart(java.awt.Frame frame,
               java.lang.String fileName,
               java.lang.Object req)

Create a QbChart object from an "tpl" or "rpt" file with parameterized query.

Parameters:

frame - a frame *

fileName - location & name of the chart file to use

req - If the chart has a parameterized query, use this HTTPRequestObject to get parameters

QbChart

public QbChart(java.applet.Applet applet,
               java.lang.String fileName,
               java.lang.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 & name of the chart file to use

req - If the chart has a parameterized query, use this HTTPRequestObject to get parameters

Method Detail

setDebugMode

public static final void setDebugMode(int mode)

set debug mode to display debug statement

setDebugMode

public static final void setDebugMode(java.lang.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

See Also:

quadbase.chartAPI.QbChart.setBackgroundTransparent()

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

See Also:

quadbase.chartAPI.QbChart.isBackgroundTransparent()

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

See Also:

quadbase.chartAPI.QbChart.setDrawBorderForWMF()

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

See Also:

quadbase.chartAPI.QbChart.isDrawBorderForWMF()

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:

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:

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:

interface

setRenderingHint

public void setRenderingHint(java.lang.Object hintKey,
                             java.lang.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:

RenderingHints

applyAntiAliasToChatAreaOnly

public void applyAntiAliasToChatAreaOnly(boolean b)

Parameters:

b - apply anti-alias option to chart area only (not on label)

setImageMapDataHintBoxHandle

public final void setImageMapDataHintBoxHandle(ICustomizeImageMapDataHintBox val)

Parameters:

val - customer image map data hint box object

See Also:

interface

getImageMapDataHintBoxHandle

public ICustomizeImageMapDataHintBox getImageMapDataHintBoxHandle()

Returns:

val customer image map data hint box object

See Also:

interface

getChartGraphics

public final IChartGraphics getChartGraphics()

return chart graphics object

Returns:

chartGraphics Chart Graphics Object

See Also:

quadbase.chartAPI.QbChart.setChartGraphics(), quadbase.util.IChartCanvas

export

public final java.awt.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:

ICanvas

exportChartToByteArray

public byte[] exportChartToByteArray()
                              throws java.lang.Exception

Exports the chart to byte array.

Returns:

byte array

exportChartToByteArray

public byte[] exportChartToByteArray(boolean template)
                              throws java.lang.Exception

exportChartToString

public java.lang.String exportChartToString()
                                     throws java.lang.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

See Also:

Parameter: ChartData

export

public void export(int format,
                   java.lang.String filename)
            throws java.io.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
VRML - VRML version 2.0
CHT - chart format
TPL - chart template

filename - export file name, without extension Use the same filename for the map file (*.map)

export

public void export(int format,
                   java.lang.String filename,
                   int w,
                   int h)
            throws java.io.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
VRML - VRML version 2.0
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 VRML, CHT, TPL format. Use the same filename for the map file (*.map)

export

public void export(int format,
                   java.lang.String filename,
                   java.lang.String subFilename)
            throws java.io.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
VRML - VRML version 2.0
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

export

public void export(int format,
                   java.lang.String filename,
                   java.lang.String subFilename,
                   int w,
                   int h)
            throws java.io.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
VRML - VRML version 2.0
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 VRML, CHT, TPL format.

export

public void export(int format,
                   java.lang.String filename,
                   java.lang.String subFilename,
                   int w,
                   int h,
                   boolean generateSubFile)
            throws java.io.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
VRML - VRML version 2.0
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 VRML, CHT, TPL format.

export

public void export(int format,
                   java.lang.String filename,
                   int w,
                   int h,
                   int option)
            throws java.io.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
VRML - VRML version 2.0
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 VRML, CHT, TPL format.

export

public void export(int format,
                   java.lang.String filename,
                   java.lang.String subFilename,
                   int w,
                   int h,
                   boolean generateSubFile,
                   int option)
            throws java.io.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
VRML - VRML version 2.0
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 VRML, CHT, TPL format.

export

public void export(int format,
                   java.lang.String filename,
                   java.lang.String drillDownChartName,
                   java.lang.String servletLoc)
            throws java.lang.Exception

Export the chart with drill down map (top level only)

Parameters:

format - Available format are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics

filename - export file name, without extension

drillDownChartName - drill-down Chart file absolute location

servletLoc - servlet location ("http://machineName:port#/...servlet");

export

public void export(int format,
                   java.lang.String filename,
                   java.lang.String drillDownChartName,
                   int w,
                   int h,
                   java.lang.String servletLoc)
            throws java.lang.Exception

Export the chart with drill down map (top level only)

Parameters:

format - Available format are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics

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");

export

public void export(int format,
                   java.lang.String filename,
                   java.lang.String drillDownChartName,
                   int w,
                   int h,
                   java.lang.String servletLoc,
                   java.lang.String[] argv)
            throws java.lang.Exception

Export the chart with drill down map (top level only)

Parameters:

format - Available format are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics

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

export

public void export(int format,
                   java.lang.String filename,
                   java.lang.String drillDownChartName,
                   java.lang.String servletLoc,
                   PickData[] pickData)
            throws java.lang.Exception

Export the chart with drill down map

Parameters:

format - Available format are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics

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

export

public void export(int format,
                   java.lang.String filename,
                   java.lang.String drillDownChartName,
                   int w,
                   int h,
                   java.lang.String servletLoc,
                   PickData[] pickData)
            throws java.lang.Exception

Export the chart with drill down map

Parameters:

format - Available format are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics
WMF - Window metafiles
BMP - OS/2 or Window bitmap
VRML - VRML version 2.0
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 VRML, CHT, TPL format.

export

public void export(int format,
                   java.lang.String filename,
                   java.lang.String drillDownChartName,
                   int w,
                   int h,
                   java.lang.String servletLoc,
                   PickData[] pickData,
                   java.lang.String[] argv)
            throws java.lang.Exception

Export the chart with drill down map

Parameters:

format - Available format are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics

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

export

public void export(int format,
                   java.lang.String filename,
                   java.lang.String chartLocation,
                   int w,
                   int h,
                   java.lang.String servletLoc,
                   PickData[] pickData,
                   java.lang.String[] argv,
                   int option)
            throws java.lang.Exception

Export the chart with drill down map

Parameters:

format - Available format are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics

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

export

public void export(int format,
                   java.io.OutputStream image,
                   java.io.OutputStream subFile,
                   java.lang.String filename,
                   java.lang.String chartLocation,
                   int w,
                   int h,
                   java.lang.String servletLoc,
                   PickData[] pickData,
                   java.lang.String[] argv,
                   int option)
            throws java.lang.Exception

Export the chart with drill down map

Parameters:

format - Available format are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics

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

setDrillDownPath

public void setDrillDownPath(java.lang.String path)

isFieldDrillDownEnabled

public boolean isFieldDrillDownEnabled()

isFieldDrillDownChart

public boolean isFieldDrillDownChart()

getPickDataCount

public static int getPickDataCount(java.lang.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(java.lang.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,
                   java.io.OutputStream out)
            throws java.io.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
VRML - VRML version 2.0
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.

export

public void export(int format,
                   java.io.OutputStream out,
                   int w,
                   int h)
            throws java.io.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
VRML - VRML version 2.0
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.

export

public void export(int format,
                   java.io.OutputStream out,
                   int w,
                   int h,
                   int option)
            throws java.io.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
VRML - VRML version 2.0
CHT - chart format
TPL - chart template The w and h arguments are not used in case of VRML, CHT, 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

export

public void export(int format,
                   java.io.OutputStream image,
                   java.io.OutputStream subFile,
                   java.lang.String fileName,
                   int w,
                   int h,
                   boolean generateSubFile,
                   int option)
            throws java.io.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
VRML - VRML version 2.0
CHT - chart format
TPL - chart template The w and h arguments are not used in case of VRML, CHT, 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

exportDataFile

public void exportDataFile(java.lang.String fileName,
                           int separator,
                           int format)
                    throws java.lang.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

exportDataFile

public void exportDataFile(java.io.PrintStream out,
                           int separator,
                           int format)
                    throws java.lang.Exception

Export 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 format are :
QbChart.TXTFORMAT
QbChart.XMLFORMAT

refresh

public final void refresh()
                   throws java.io.IOException,
                          java.sql.SQLException,
                          java.lang.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.

Overrides:

refresh in class QbChartBasic

repaintPanel

public void repaintPanel()

This method repaints the viewpanel that contains a chart

draw

public void draw(java.awt.Graphics g,
                 java.awt.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(java.applet.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 java.applet.Applet getApplet()

Return applet

Returns:

the applet containing this component

getErrorMessage

public final java.lang.String getErrorMessage()

Return error message from the constructor of QbChart

Returns:

error message or null if chart created successfully

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

getDrillDownChartCount

public int getDrillDownChartCount()

The number of drill-down charts immediately accessible

getDrillDownChartAt

public DrillDownChart getDrillDownChartAt(int index)
                                   throws java.lang.Exception

Return the drill-down chart at the specific index

getDrillDownChart

public DrillDownChart getDrillDownChart(java.lang.String name)
                                 throws java.lang.Exception

Return the drill-down chart with the matching name

createDrillDownChart

public DrillDownChart createDrillDownChart(java.lang.String name,
                                           int chartDim,
                                           int chartType,
                                           IDatabaseInfo dbInfo,
                                           boolean doTransposeData,
                                           int[] transposeCol,
                                           IColumnMap mapping,
                                           java.lang.String template,
                                           int[] columnMapping)
                                    throws java.lang.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.

updateDrillDownCharts

public void updateDrillDownCharts()
                           throws java.lang.Exception

getPreferredSize

public final java.awt.Dimension getPreferredSize()

Overrides component getPreferredSize().

Overrides:

getPreferredSize in class javax.swing.JComponent

Returns:

the preferred size of this component.

See Also:

setPreferredSize

setPreferredSize

public final void setPreferredSize(java.awt.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 javax.swing.JComponent

Parameters:

d - the preferred dimensions of the component.

getModifier

public final int getModifier()

Return mouse modifier

getArgument

public java.lang.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(java.io.ObjectInput in)
                        throws java.io.IOException,
                               java.lang.ClassNotFoundException

This method provides support for reading serialized charts

writeExternal

public final void writeExternal(java.io.ObjectOutput out)
                         throws java.io.IOException

This method provides support for writing serialized charts

getVersion

public static java.lang.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(java.lang.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(java.lang.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(java.lang.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(java.lang.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(java.lang.String context)

getServletContext

public static java.lang.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 java.lang.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)

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 java.lang.Exception

set max number of character for record in column when using record file to generate the report

getTempDirectory

public static java.lang.String getTempDirectory()

get temp directory for using record file to generate the report DEFAULT temp directory is "temp/"

setTempDirectory

public static void setTempDirectory(java.lang.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.

setParamPageHeader

public void setParamPageHeader(java.lang.String header)

Deprecated. use QbChart.getParameterPage(String,int,String).setHeader(String) instead Set the parameter HTML page header

Parameters:

the - header of the parameter HTML page

setParamPageFooter

public void setParamPageFooter(java.lang.String footer)

Deprecated. use QbChart.getParameterPage(String,int,String).setFooter(String) instead Set the parameter HTML page footer

Parameters:

the - footer of the parameter HTML page

setParamPageTitle

public void setParamPageTitle(java.lang.String title)

Deprecated. use QbChart.getParameterPage(String,int,String).setDocumentTitle(String) instead Set the parameter HTML page title

Parameters:

the - title of the parameter HTML page

setParamPageTitleFontName

public void setParamPageTitleFontName(java.lang.String name)

Deprecated. use QbChart.getParameterPage(String,int,String).setTitleTextFont(String) instead Set the paramter HTML page title font name

Parameters:

the - font name of the title of the parameter HTML page

setParamPageTitleFontSize

public void setParamPageTitleFontSize(int size)

Deprecated. use QbChart.getParameterPage(String,int,String).setTitleTextSize(int) instead set the parameter HTML page title font size

Parameters:

the - font size of the title of the parameter HTML page

setParamPageTitleFontStyle

public void setParamPageTitleFontStyle(int style)

Deprecated. use QbChart.getParameterPage(String,int,String).setTitleTextStyle(int) instead Set the parameter HTML page title font style

Parameters:

the - font style of the title of the parameter HTML page. They are Font.PLAIN, Font.BOLD, Font.ITALIC, Font.BOLD + Font.ITALIC

setParamPageTitleFontColor

public void setParamPageTitleFontColor(java.lang.String color)

Deprecated. use QbChart.getParameterPage(String,int,String).setTitleTextColor(String) instead Set the parameter HTML page title font color as hex number

Parameters:

the - hex value of the font color of the title of the parameter HTML page

setParamPageTitleFontColor

public void setParamPageTitleFontColor(java.awt.Color color)

Deprecated. use QbChart.getParameterPage(String,int,String).setTitleTextColor(Color) instead Set the paramter HTML page title font color as Color object

Parameters:

the - font color of the title of the parameter HTML page

setParamPageBackgroundColor

public void setParamPageBackgroundColor(java.lang.String color)

Deprecated. use QbChart.getParameterPage(String,int,String).setTableBackgroundColor(String) instead Set the parameter HTML page background color as hex number

Parameters:

the - hex value of the background color of the parameter HTML page

setParamPageTextFontName

public void setParamPageTextFontName(java.lang.String name)

Deprecated. use QbChart.getParameterPage(String,int,String).setTextFont(String) instead Set the parameter HTML page text font name

Parameters:

the - font name of the text of the parameter HTML page

setParamPageTextFontSize

public void setParamPageTextFontSize(int size)

Deprecated. use QbChart.getParameterPage(String,int,String).setTextSize(int) instead Set the parameter HTML page text font size

Parameters:

the - font size of the text of the parameter HTML page

setParamPageTextFontStyle

public void setParamPageTextFontStyle(int style)

Deprecated. use QbChart.getParameterPage(String,int,String).setTextStyle(int) instead Set the parameter page text font style

Parameters:

the - font style of the text of the parameter HTML page They are Font.PLAIN, Font.BOLD, Font.ITALIC, Font.BOLD + Font.ITALIC

setParamPageTextFontColor

public void setParamPageTextFontColor(java.lang.String color)

Deprecated. use QbChart.getParameterPage(String,int,String).setTextColor(String) instead Set the parameter HTML page text font color as hex value

Parameters:

the - hex value of the font color of the text of the parameter HTML page

setParamPageTextFontColor

public void setParamPageTextFontColor(java.awt.Color color)

Deprecated. use QbChart.getParameterPage(String,int,String).setTextColor(Color) instead Set the parameter page text font color as Color object

Parameters:

the - font color of the text of the parameter HTML page

setParamPageBorderColor

public void setParamPageBorderColor(java.lang.String color)

Deprecated. use QbChart.getParameterPage(String,int,String).setTableBorderColor(String) instead Set the parameter page border color as hex value

Parameters:

the - hex value of the border color of the paramter HTML page

setParamPageBorderColor

public void setParamPageBorderColor(java.awt.Color color)

Deprecated. use QbChart.getParameterPage(String,int,String).setTableBorderColor(Color) instead Set the parameter page border color as Color object

Parameters:

the - border color of the parameter HTML page

setParamPageBorderThickness

public void setParamPageBorderThickness(int thickness)

Deprecated. use QbChart.getParameterPage(String,int,String).setTableBorderThickness(int) instead Set the border thickness of the parameter HTML page

Parameters:

the - border thickness of the parameter HTML page

setParamPageAlignment

public void setParamPageAlignment(int alignment)

Deprecated. use QbChart.getParameterPage(String,int,String).setAlignment(int) instead Set the alignment of the form of the parameter HTML page

Parameters:

the - alignment of the border of the parameter HTML page

setParamPageLayout

public void setParamPageLayout(int layout)

Deprecated. use QbChart.getParameterPage(String,int,String).setTableLayout(int) instead Set the layout of the form of the parameter HTML page

Parameters:

the - layout of the form of the parameter HTML page

setParamPageResetEnabled

public void setParamPageResetEnabled(boolean state)

Deprecated. use QbChart.getParameterPage(String,int,String).setResetEnabled(boolean) instead Whether enable the reset button in the form of the parameter HTML page

Parameters:

the - state whether to enable the reset button of the form of the parameter HTML page

setParamPageOuterBorder

public void setParamPageOuterBorder(boolean state)

Deprecated. use QbChart.getParameterPage(String,int,String).setTableOuterBorderOnly(boolean) instead Whether only show the outer border of the form of the parameter HTML page

Parameters:

the - state whether to show only the outer border of the form of the parameter HTML page

getHTMLParamPage

public java.lang.String getHTMLParamPage(java.lang.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

public java.lang.String getHTMLParamPage(java.lang.String chartLoc,
                                         int format,
                                         java.lang.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

public java.lang.String getHTMLParamPageBody(java.lang.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

public java.lang.String getHTMLParamPageBody(java.lang.String chartLoc,
                                             int format,
                                             java.lang.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

public java.lang.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

public static void setGIFEnable(java.lang.String serialNumber,
                                java.lang.String key)
                         throws java.lang.Exception

Sets whether the Qbchart can generate GIF or not

setBufferedImageUsed

public void setBufferedImageUsed(boolean state)

Sets whether the QbChart to use java.awt.image.BufferedImage technology to export image Note this method only works with JDK 1.2 or above

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 Note this method only works with JDK 1.2 or above

Returns:

the state

setBufferedImageType

public void setBufferedImageType(int imageType)

Sets java.awt.image.BufferedImage image type Note this method only works with JDK 1.2 or above

Parameters:

imageType - The new image type. The default value is java.awt.image.TYPE_INT_RGB

See Also:

BufferedImage

getBufferedImageType

public int getBufferedImageType()

Returns java.awt.image.BufferedImage image type Note this method only works with JDK 1.2 or above

Returns:

image type

getTemplateFile

public final java.lang.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:

applyTemplate

applyTemplateFile

public final void applyTemplateFile(java.lang.String fileName)
                             throws java.io.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.

setLocale

public void setLocale(java.util.Locale locale)

Sets the locale of this component

Overrides:

setLocale in class java.awt.Component

Parameters:

locale - The locale to become this component's locale.

setPanelBorder

public void setPanelBorder(java.lang.Object border)

Sets the border of this component (for swing version only)

Overrides:

setPanelBorder in class 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 javax.swing.JComponent

Parameters:

isOpaque - Opaque value of this component

getLocale

public java.util.Locale getLocale()
                           throws java.awt.IllegalComponentStateException

Gets the locale of this component

Overrides:

getLocale in class java.awt.Component

Returns:

This component's locale. If this component does not have a locale, the locale of its parent is returned.

getTimeZone

public java.util.TimeZone getTimeZone()

Gets the time zone

Returns:

the time zone associated with this component

setTimeZone

public void setTimeZone(java.util.TimeZone zone)

Sets the time zone

Parameters:

zone - the given new time zone

getFile

public final java.lang.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(java.lang.String fileName)
                    throws java.io.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".

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

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:

I3DControlPanel

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:

I3DPropertySet

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:

ITextString

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:

ILegend

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:

IAxis

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:

IAxis

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:

IAxis

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:

IAxis

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:

ICanvas

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:

IHyperLinkSet

gethTrendLines

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:

ITrendLineSet

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:

IDataLineSet, IDataLine, ITrendLine, IHorzVertLine, IControlLine

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:

IControlRangeSet

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:

IDropBarSet

gethAnnotations

public final IAnnotationSet gethAnnotations()

Returns a handle to the set of annotations.

Returns:

a handle to quadbase.ChartAPI.swing.IAnnotationSet.

See Also:

IAnnotationSet, IAnnotation

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:

IFloatingLineSet

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:

IFloatingTextSet

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:

IPlot

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:

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:

IDataPointSet

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:

IBubblePropertySet

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:

IPiePropertySet

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:

ISurfacePropertySet

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:

IDoughnutPropertySet

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:

IOverlayPropertySet

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:

IRadarPropertySet

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:

IPolarPropertySet

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:

ILinePropertySet

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:

IGanttPropertySet

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:

IDialPropertySet

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:

IBoxPropertySet

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:

ISecondaryChart

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:

IAxisRuler

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:

IAxisRuler

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:

IZoomInfo

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:

IDrillDown

gethTable

public final ITable gethTable()

Return a handle to the Table interface Table can be designed by calling methods on this interface

See Also:

ITable

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:

IHistogramInfo

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:

IMouseEventSet

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(java.lang.String address)
                             throws java.net.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.

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(java.util.Vector 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 ChartParameterPage getParameterPage(java.lang.String chartLoc,
                                           int format,
                                           java.lang.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 java.lang.String getUpdateVersion()