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:

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

Direct Known Subclasses:

DrillDownChart

public class QbChart
extends quadbase.ChartAPI.swing.QbChartBasic
implements IChartTypeConstants, IExportConstants, quadbase.common.util.internal.IChart

This class creates a chart object which extends java.awt.Component. Associated with this component, is an elobarate Java API that is contained in the quadbase.util and this (quadbase.ChartAPI.swing) package. Several chart types (and their combinations) are available, as enumerated in the interface quadbase.util.IChartTypeConstants. Both two and three dimensional charts are supported.

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

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

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

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

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

 
 import java.applet.Applet;
 import java.awt.*;
 import quadbase.ChartAPI.swing.QbChart;
 import quadbase.util.*;
 
 public class MyChartApplet extends Applet {
        QbChart chart;
 
        public void init() {
 
                // Load an existing chart from a CHT file 
                chart = new QbChart(this, "help/examples/data/col2d.cht");
 
                // Get a handle to the title 
                ITextString title = chart.gethMainTitle();
 
                // Call methods on the handle to change title
                title.setValue("New Title");
 
                // Get a handle to the ICanvas interface and change background color
                chart.gethCanvas().setBackgroundColor(Color.white);
 
                setLayout(new BorderLayout());
                add("Center", chart);
        }
 }
 

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

The chart component is also available as a JavaBean.

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

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class quadbase.ChartAPI.swing.QbChartBasic

quadbase.ChartAPI.swing.QbChartBasic.CAxisRuler, quadbase.ChartAPI.swing.QbChartBasic.CDataTopLabel, quadbase.ChartAPI.swing.QbChartBasic.CDataTopLabel2, quadbase.ChartAPI.swing.QbChartBasic.CMainTitle, quadbase.ChartAPI.swing.QbChartBasic.CNoDataToPlotMessage, quadbase.ChartAPI.swing.QbChartBasic.ControlPanel

Nested classes/interfaces inherited from class javax.swing.JPanel

javax.swing.JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
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

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

accessibleContext, 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, DOUGHNUT, 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, EXCEL, FLASH, GIF, GIF_C, GIF_N, GIF_R, JPEG, JPEG_C, PAC, PDF, PNG, PNG_COMPRESSION_DEFAULT, PNG_COMPRESSION_FAST, PNG_COMPRESSION_MAX, PNG_COMPRESSION_NONE, SEMICOLON, SPACE, SVG, TPL, TXTFORMAT, WMF, XMLFORMAT

Fields inherited from interface quadbase.ChartAPI.swing.IMiscConstants

ASCENDING, BACK_LINE, BOTTOM_ALIGNMENT, BOTTOM_ALIGNMENT_INSIDE, CENTER, CENTER_ALIGNMENT, CENTERALIGNMENT, CIRCLE, CLASSFILE, CROSS, CUSTOMIZE_DATA_ORDER, CUT_CORNER, DASH, DATAFILE, DESCENDING, DOWN, FIT, FIXED_COLUMN, FLAT, FLAT_BORDER, GOURAUD, GOURAUD_BORDER, HORIZONTAL, INVERSE_TRIANGLE, LEFT_DOUBLECLICK, LEFT_SINGLECLICK, LEFTALIGNMENT, LOWER, NONE, NOSYMBOL, ORIGINAL_DATA_ORDER, 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, SQUARE_LEGEND, 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

Constructors

Modifier	Constructor and Description
	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, byte[] chartData, boolean template, java.util.Properties props)
	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, quadbase.common.util.internal.ExcelFileInfo excelInfo, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, java.lang.String template) Creates a new chart, given the chart type, dimension and a template.
	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, quadbase.common.paramquery.SalesForceQueryFileInfo sfQueryInfo, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, java.lang.String template) Creates a new chart, given the chart type, dimension and a template.
	QbChart(java.applet.Applet applet, int dimension, int chartType, quadbase.common.paramquery.SOAPQueryFileInfo soapInfo, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, java.lang.String template) Creates a new chart, given the chart type, dimension and a template.
	QbChart(java.applet.Applet applet, int dimension, int chartType, quadbase.common.paramquery.SOAPQueryFileInfo soapInfo, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, java.lang.String template, boolean disableParamDialog) Creates 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 className, quadbase.common.paramquery.QueryInParamSet queryInParamSet, boolean doTransposeData, int[] transposeCol, IColumnMap cmap, java.lang.String template) Create a new chart using Class file as data source.
	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<java.lang.String,java.lang.String> 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, boolean isEnterpriseServer) For internal use only.
	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)
	QbChart(java.applet.Applet applet, java.lang.String fileName, java.lang.Object[] parameter, java.util.Properties props)
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

Modifier and Type	Method and Description
void	applyAntiAliasToChartAreaOnly(boolean b) apply anti-alias to chart plot area only.
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
DrillDownChart	createDrillDownChart(java.lang.String name, int chartDim, int chartType, IDatabaseInfo dbInfo, boolean doTransposeData, int[] transposeCol, IColumnMap mapping, java.lang.String template, int[] columnMapping, boolean prevParamPrompt)
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.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, float option2, boolean enableAnimationForFlash) Exports 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 chartLocation, int w, int h, java.lang.String servletLoc, PickData[] pickData, java.lang.String[] argv, int option, float option2, boolean enableAnimationForFlash) Exports 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) Exports Data File
void	exportDataFile(java.lang.String fileName, int separator, int format) Export Data File
protected void	finalize()
void	forceApplyAntiAliasToHorizontalText(boolean b) turn on anti-alias for horizontal text even anti-alias is not on for the chart
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
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
java.awt.Color	getGradientDesColor()
double	getGradientEndX()
double	getGradientEndY()
int	getGradientShade()
double	getGradientStartX()
double	getGradientStartY()
I3DControlPanel	geth3DControlPanel() Returns a handle to properties of the 3D control panel.
I3DPropertySet	geth3DProperties() Returns a handle to properties specific to a 3D chart.
IAggregationInfo	gethAggregationInfo() Returns a handle to the aggregation property interface.
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	getMaxFieldSize() Gets max number of character for record in column when using paging feature to generate the report/ chart
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
static int	getPageBufferSize() Gets the page buffer size in memory (in MB) when using paging feature to generate the report/ chart
static int	getPagingThreshold() Gets threshold value (in MB) for enable paging feature if value = -1, load everything in memory (default)
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
static int	getTotalPageBufferSize() Gets the total page buffer size in memory (in MB) for server when using paging feature to generate the report/ chart
int	getType() Returns the type of the chart.
static java.lang.String	getUpdateVersion()
static java.lang.String	getVersion() Returns EspressChart Version Number
boolean	is3DShadingEnabled()
boolean	isAdjustFont() Return whether adjust the font based on the screen resolution.
boolean	isApplyGradientToChartDataOnly()
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
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	isGradientCyclic()
boolean	isGradientEnabled()
boolean	isGrayscaleForExport() Returns using grayscale for export
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	set3DShadingEnabled(boolean b)
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	setApplyGradientToChartDataOnly(boolean b)
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
void	setBufferedImageUsed(boolean state) Sets whether the QbChart to use java.awt.image.BufferedImage technology to export image
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) Deprecated. this method has no effect - GIF export is always enabled
void	setGradientCyclic(boolean c)
void	setGradientDesColor(java.awt.Color c)
void	setGradientEnabled(boolean b)
void	setGradientEndX(double x)
void	setGradientEndY(double y)
void	setGradientShade(int s)
void	setGradientStartX(double x)
void	setGradientStartY(double y)
void	setGrayscaleForExport(boolean isGrayscale) Sets using grayscale for export
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	setMaxFieldSize(int r) set max number of character for record in column when using paging feature to generate the report/ chart
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)
quadbase.chart.Chart	setNewData(quadbase.chart.ColData[] colData) internal use only
void	setOpaque(boolean isOpaque) Sets the opaque of this component (for swing version only)
static void	setPageBufferSize(int r) set the page buffer size in memory (in MB) when using paging feature to generate the report/ chart (larger buffer results faster generating time)
static void	setPagingThreshold(int r) set threshold value (in MB) for enable paging feature if value = -1, load everything in memory (default)
void	setPanelBorder(java.lang.Object border) Sets the border of this component (for swing version only)
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<java.lang.String> 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
static void	setTotalPageBufferSize(int r) set the total page buffer size in memory (in MB) for server when using paging feature to generate the report/ chart (larger buffer results faster generating time)
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, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

See Also:

Constant Field Values

VIEW3D

public static final int VIEW3D

3D chart

See Also:

Constant Field Values

OLAPDATA_TRANSPOSECOLBREAK

public static final int OLAPDATA_TRANSPOSECOLBREAK

See Also:

Constant Field Values

OLAPDATA_DIRECT

public static final int OLAPDATA_DIRECT

See Also:

Constant Field Values

OLAPDATA_CONCATENATELABEL

public static final int OLAPDATA_CONCATENATELABEL

See Also:

Constant Field Values

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

QbChart

public QbChart(java.applet.Applet applet,
               java.lang.String fileName,
               boolean isEnterpriseServer)

For internal use only.

QbChart

@Deprecated
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

@Deprecated
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

@Deprecated
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

@Deprecated
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

@Deprecated
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<java.lang.String,java.lang.String> environment,
               IColumnMap cmap,
               java.lang.String template,
               boolean doTransposeData,
               boolean[] transposeCol)

QbChart

public QbChart(java.applet.Applet applet,
               int dimension,
               int chartType,
               quadbase.common.paramquery.SOAPQueryFileInfo soapInfo,
               boolean doTransposeData,
               int[] transposeCol,
               IColumnMap cmap,
               java.lang.String template)

Creates a new chart, given the chart type, dimension and a template. Input data are read from a SOAP service. 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

soapInfo - SOAP data source info. See SOAPQueryFileInfo

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.applet.Applet applet,
               int dimension,
               int chartType,
               quadbase.common.paramquery.SOAPQueryFileInfo soapInfo,
               boolean doTransposeData,
               int[] transposeCol,
               IColumnMap cmap,
               java.lang.String template,
               boolean disableParamDialog)

Creates a new chart, given the chart type, dimension and a template. Input data are read from a SOAP service. 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

soapInfo - SOAP data source info. See SOAPQueryFileInfo

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.

disableParamDialog - if true parameter prompt is disabled, if false user is prompted for parameters if they are not defined

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,
               quadbase.common.paramquery.SalesForceQueryFileInfo sfQueryInfo,
               boolean doTransposeData,
               int[] transposeCol,
               IColumnMap cmap,
               java.lang.String template)

Creates a new chart, given the chart type, dimension and a template. Input data are read from SalesForce. 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

sfQueryInfo - SalesForce data source info. See SalesForceQueryFileInfo.

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.applet.Applet applet,
               int dimension,
               int chartType,
               quadbase.common.util.internal.ExcelFileInfo excelInfo,
               boolean doTransposeData,
               int[] transposeCol,
               IColumnMap cmap,
               java.lang.String template)

Creates a new chart, given the chart type, dimension and a template. Input data are read from Excel. Other attributes of the chart are read from the template file.
If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.

Parameters:

applet - an applet containing the chart. Use "(Applet) null" if used within an application.

dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart

excelInfo - Excel data source info. See ExcelFileInfo.

doTransposeData - a flag denoting whether the input data has to be transposed into a result set having three columns: RowLabel, ColumnLabel, and Value.

transposeCol - transposing selected column from the original data

cmap - column information used to specify the column mappings used to plot data, see interface IColumnMap for details

template - a template file (with extension .tpl). Use null if no template is to be applied.

QbChart

public QbChart(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

@Deprecated
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

@Deprecated
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

@Deprecated
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.

Throws:

java.lang.Exception

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.

Throws:

java.lang.Exception

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.

Throws:

java.lang.Exception

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.

Throws:

java.lang.Exception

See Also:

ISpreadSheetModel, IColumnMap

QbChart

public QbChart(java.applet.Applet applet,
               int dimension,
               int chartType,
               java.lang.String className,
               quadbase.common.paramquery.QueryInParamSet queryInParamSet,
               boolean doTransposeData,
               int[] transposeCol,
               IColumnMap cmap,
               java.lang.String template)
        throws java.lang.Exception

Create a new chart using Class file as data source. If the chart is used in an application, the applet parameter may be null. In such a case, if the chart server is used, the server locator file (server.cfg) is assumed to be in the current directory of the application.

Parameters:

applet - an applet containing the chart. Use "(Applet) null" if used within an application.

dimension - use QbChart.VIEW2D or QbChart.VIEW3D to specify 2D or 3D chart

chartType - a flag denoting whether the input data has to be transposed into a result set

className - the class name of the class data source

queryInParamSet - paramter set if the the class data source is parameterized it can be null for non-parameterized. If it is null for a parameterized class data source, a swing dialog will be prompted on the server side.

doTransposeData - a flag denoting whether the input data has to be transposed into a result set

transposeCol - transposing selected columns from the original data source

cmap - column information used to specify the column mappings used to plot data

template - a template file (with extension .tpl). Use null if no

Throws:

java.lang.Exception

See Also:

ISpreadSheetModel

QbChart

@Deprecated
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

@Deprecated
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

@Deprecated
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

@Deprecated
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

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

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.swing.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.swing.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.swing.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.swing.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

applyAntiAliasToChartAreaOnly

public void applyAntiAliasToChartAreaOnly(boolean b)

apply anti-alias to chart plot area only. Ignore in all the other area

Parameters:

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

forceApplyAntiAliasToHorizontalText

public void forceApplyAntiAliasToHorizontalText(boolean b)

turn on anti-alias for horizontal text even anti-alias is not on for the chart

Parameters:

b - force apply anti-alias option to text area which can even override applyAntiAliasToChartAreaOnly() (horizontal label only)

setGradientEnabled

public void setGradientEnabled(boolean b)

isGradientEnabled

public boolean isGradientEnabled()

set3DShadingEnabled

public void set3DShadingEnabled(boolean b)

is3DShadingEnabled

public boolean is3DShadingEnabled()

setApplyGradientToChartDataOnly

public void setApplyGradientToChartDataOnly(boolean b)

isApplyGradientToChartDataOnly

public boolean isApplyGradientToChartDataOnly()

getGradientStartX

public double getGradientStartX()

getGradientStartY

public double getGradientStartY()

getGradientEndX

public double getGradientEndX()

getGradientEndY

public double getGradientEndY()

getGradientDesColor

public java.awt.Color getGradientDesColor()

getGradientShade

public int getGradientShade()

isGradientCyclic

public boolean isGradientCyclic()

setGradientStartX

public void setGradientStartX(double x)

setGradientStartY

public void setGradientStartY(double y)

setGradientEndX

public void setGradientEndX(double x)

setGradientEndY

public void setGradientEndY(double y)

setGradientDesColor

public void setGradientDesColor(java.awt.Color c)

setGradientShade

public void setGradientShade(int s)

setGradientCyclic

public void setGradientCyclic(boolean c)

setImageMapDataHintBoxHandle

public final void setImageMapDataHintBoxHandle(ICustomizeImageMapDataHintBox val)

Parameters:

val - customer image map data hint box object

See Also:

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.swing.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

Throws:

java.lang.Exception

exportChartToByteArray

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

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

Throws:

java.lang.Exception

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
CHT - chart format
TPL - chart template

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

Throws:

java.io.IOException

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
CHT - chart format
TPL - chart template

filename - export file name, without extension

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height. The w and h arguments are not used in case of CHT and TPL format. Use the same filename for the map file (*.map)

Throws:

java.io.IOException

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
CHT - chart format
TPL - chart template

filename - export file name, without extension

subFilename - map file name, without extension, useful if hyperlink exists / xml file name, without extension, use for CHT or TPL format

Throws:

java.io.IOException

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
CHT - chart format
TPL - chart template

filename - export file name, without extension

subFilename - map file name, without extension, useful if hyperlink exists / xml file name, without extension, use for CHT or TPL format

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height. The w and h arguments are not used in case of CHT and TPL format.

Throws:

java.io.IOException

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
CHT - chart format
TPL - chart template

filename - export file name, without extension

subFilename - map file name, without extension, useful if hyperlink exists / xml file name, without extension, use for CHT or TPL format

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

generateSubFile - show data point information in map file / xml chart property file for CHT or TPL format The w and h arguments are not used in case of CHT and TPL format.

Throws:

java.io.IOException

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
CHT - chart format
TPL - chart template

filename - export file name, without extension

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

option - JPEG file quality (0 - 100) / PNG file compression Available PNG Compression format are :
PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE The w and h arguments are not used in case of CHT and TPL format.

Throws:

java.io.IOException

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
CHT - chart format
TPL - chart template

filename - export file name, without extension

subFilename - map file name, without extension, useful if hyperlink exists / xml file name, without extension, use for CHT or TPL format

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

generateSubFile - show data point information in map file / xml chart property file for CHT or TPL format

option - JPEG file quality (0 - 100) / PNG file compression Available PNG Compression format are :
PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE The w and h arguments are not used in case of CHT and TPL format.

Throws:

java.io.IOException

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 formats are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics
FLASH - Flash (.swf)
SVG - Scalable Vector Graphics
WMF - Window metafiles
BMP - OS/2 or Window bitmap
CHT - chart format
TPL - chart template

filename - export file name, without extension

drillDownChartName - drill-down Chart file absolute location

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

Throws:

java.lang.Exception

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 formats are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics
FLASH - Flash (.swf)
SVG - Scalable Vector Graphics
WMF - Window metafiles
BMP - OS/2 or Window bitmap
CHT - chart format
TPL - chart template

filename - export file name, without extension

drillDownChartName - drill-down Chart file absolute location

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

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

Throws:

java.lang.Exception

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 formats are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics
FLASH - Flash (.swf)
SVG - Scalable Vector Graphics
WMF - Window metafiles
BMP - OS/2 or Window bitmap
CHT - chart format
TPL - chart template

filename - export file name, without extension

drillDownChartName - drill-down Chart file absolute location

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

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

argv - optional parameter

Throws:

java.lang.Exception

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 formats are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics
FLASH - Flash (.swf)
SVG - Scalable Vector Graphics
WMF - Window metafiles
BMP - OS/2 or Window bitmap
CHT - chart format
TPL - chart template

filename - export file name, without extension

drillDownChartName - drill-down Chart file absolute location

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

pickData - array of pickData from 1st drill-down level to current level

Throws:

java.lang.Exception

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 formats are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics
FLASH - Flash (.swf)
SVG - Scalable Vector Graphics
WMF - Window metafiles
BMP - OS/2 or Window bitmap
CHT - chart format
TPL - chart template

filename - export file name, without extension

drillDownChartName - drill-down Chart file absolute location

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

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

pickData - array of PickData from 1st drill-down level to current level The w and h arguments are not used in case of CHT and TPL format.

Throws:

java.lang.Exception

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 formats are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics
FLASH - Flash (.swf)
SVG - Scalable Vector Graphics
WMF - Window metafiles
BMP - OS/2 or Window bitmap
CHT - chart format
TPL - chart template

filename - export file name, without extension

drillDownChartName - drill-down Chart file absolute location

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

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

pickData - array of PickData from 1st drill-down level to current level

argv - optional parameters

Throws:

java.lang.Exception

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 formats are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics
FLASH - Flash (.swf)
SVG - Scalable Vector Graphics
WMF - Window metafiles
BMP - OS/2 or Window bitmap
CHT - chart format
TPL - chart template

filename - export file name, without extension

chartLocation - drill-down Chart file absolute location

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

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

pickData - array of PickData from 1st drill-down level to current level

argv - optional parameters

option - JPEG file quality (0 - 100) / PNG file compression / FLASH frame count (1-50) Available PNG Compression format are :
PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE

Throws:

java.lang.Exception

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,
                   float option2,
                   boolean enableAnimationForFlash)
            throws java.lang.Exception

Exports the chart with drill down map

Parameters:

format - Available formats are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics
FLASH - Flash (.swf)
SVG - Scalable Vector Graphics
WMF - Window metafiles
BMP - OS/2 or Window bitmap
CHT - chart format
TPL - chart template

filename - export file name, without extension

chartLocation - drill-down Chart file absolute location

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

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

pickData - array of PickData from 1st drill-down level to current level

argv - optional parameters

option - JPEG file quality (0 - 100) / PNG file compression / FLASH frame count (1-50) Available PNG Compression format are :
PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE

option2 - FLASH frame rate (0-99)

enableAnimationForFlash - FLASH enable animation (DEFAULT VALUE: TRUE)

Throws:

java.lang.Exception

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 formats are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics
FLASH - Flash (.swf)
SVG - Scalable Vector Graphics
WMF - Window metafiles
BMP - OS/2 or Window bitmap
CHT - chart format
TPL - chart template

image - The outputStream. The caller is responsible for closing it.

subFile - The outputStream. The caller is responsible for closing it.

filename - export file name, without extension

chartLocation - drill-down Chart file absolute location

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

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

pickData - array of PickData from 1st drill-down level to current level

argv - optional parameters

option - JPEG file quality (0 - 100) / PNG file compression Available PNG Compression format are :
PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE

Throws:

java.lang.Exception

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,
                   float option2,
                   boolean enableAnimationForFlash)
            throws java.lang.Exception

Exports the chart with drill down map

Parameters:

format - Available formats are :
GIF - CompuServe gif
GIF_N - CompuServe gif using new gif encoder
JPEG - JPEG
PNG - Portable Network Graphics
FLASH - Flash (.swf)
SVG - Scalable Vector Graphics
WMF - Window metafiles
BMP - OS/2 or Window bitmap
CHT - chart format
TPL - chart template

image - The outputStream. The caller is responsible for closing it.

subFile - The outputStream. The caller is responsible for closing it.

filename - export file name, without extension

chartLocation - drill-down Chart file absolute location

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

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

pickData - array of PickData from 1st drill-down level to current level

argv - optional parameters

option - JPEG file quality (0 - 100) / PNG file compression Available PNG Compression format are :
PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE

option2 - FLASH frame rate (0-99)

enableAnimationForFlash - FLASH enable animation (DEFAULT VALUE: TRUE)

Throws:

java.lang.Exception

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
CHT - chart format
TPL - chart template Note that this method does not generate any map file if hyperlink exists

out - The outputStream. The caller is responsible for closing it.

Throws:

java.io.IOException

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
CHT - chart format
TPL - chart template Note that this method does not generate any map file if hyperlink exists

out - The outputStream. The caller is responsible for closing it.

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

Throws:

java.io.IOException

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
CHT - chart format
TPL - chart template The w and h arguments are not used in case of CHT and TPL format. Note that this method does not generate any map file if hyperlink exists

out - The outputStream. The caller is responsible for closing it.

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

option - JPEG file quality (0 - 100) / PNG file compression Available PNG Compression format are :
PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE

Throws:

java.io.IOException

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
CHT - chart format
TPL - chart template The w and h arguments are not used in case of CHT and TPL format.

image - The outputStream. The caller is responsible for closing it.

subFile - The outputStream. The caller is responsible for closing it.

fileName - The name of the CHT/TPL Chart for XML or the name of the MAP file

w - output chart width (in pixels), 0 represents current width

h - output chart height (in pixels), 0 represent current height.

generateSubFile - show data point information (MAP file) in subFile outputStream/ xml chart file for CHT or TPL format in subFile outputStream

option - JPEG file quality (0 - 100) / PNG file compression Available PNG Compression format are :
PNG_COMPRESSION_DEFAULT PNG_COMPRESSION_MAX PNG_COMPRESSION_NONE

Throws:

java.io.IOException

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

Throws:

java.lang.Exception

exportDataFile

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

Exports Data File

Parameters:

out - The outputStream. The caller is responsible for closing it.

separator - Available separators for TXT format are :
QbChart.COMMA
QbChart.SEMICOLON
QbChart.SPACE

format - Available formats are :
QbChart.TXTFORMAT
QbChart.XMLFORMAT

Throws:

java.lang.Exception

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.

Specified by:

refresh in class quadbase.ChartAPI.swing.QbChartBasic

Throws:

java.io.IOException

java.sql.SQLException

java.lang.ClassNotFoundException

setNewData

public quadbase.chart.Chart setNewData(quadbase.chart.ColData[] colData)
                                throws java.lang.Exception

internal use only

Specified by:

setNewData in interface quadbase.common.util.internal.IChart

Throws:

java.lang.Exception

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

Throws:

java.lang.Throwable

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

Throws:

java.lang.Exception

getDrillDownChart

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

Return the drill-down chart with the matching name

Throws:

java.lang.Exception

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.

Throws:

java.lang.Exception

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,
                                           boolean prevParamPrompt)
                                    throws java.lang.Exception

Throws:

java.lang.Exception

updateDrillDownCharts

public void updateDrillDownCharts()
                           throws java.lang.Exception

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

Specified by:

readExternal in interface java.io.Externalizable

Throws:

java.io.IOException

java.lang.ClassNotFoundException

writeExternal

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

This method provides support for writing serialized charts

Specified by:

writeExternal in interface java.io.Externalizable

Throws:

java.io.IOException

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)

Throws:

java.lang.Exception

getMaxCharForRecordFile

public static int getMaxCharForRecordFile()

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

setMaxCharForRecordFile

public static void setMaxCharForRecordFile(int r)
                                    throws java.lang.Exception

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

Throws:

java.lang.Exception

getPagingThreshold

public static int getPagingThreshold()

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

setPagingThreshold

public static void setPagingThreshold(int r)

set threshold value (in MB) for enable paging feature if value = -1, load everything in memory (default)

getPageBufferSize

public static int getPageBufferSize()

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

setPageBufferSize

public static void setPageBufferSize(int r)
                              throws java.lang.Exception

set the page buffer size in memory (in MB) when using paging feature to generate the report/ chart (larger buffer results faster generating time)

Throws:

java.lang.Exception

getMaxFieldSize

public static int getMaxFieldSize()

Gets max number of character for record in column when using paging feature to generate the report/ chart

setMaxFieldSize

public static void setMaxFieldSize(int r)
                            throws java.lang.Exception

set max number of character for record in column when using paging feature to generate the report/ chart

Throws:

java.lang.Exception

getTotalPageBufferSize

public static int getTotalPageBufferSize()

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

setTotalPageBufferSize

public static void setTotalPageBufferSize(int r)
                                   throws java.lang.Exception

set the total page buffer size in memory (in MB) for server when using paging feature to generate the report/ chart (larger buffer results faster generating time)

Throws:

java.lang.Exception

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.

getHTMLParamPage

@Deprecated
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

@Deprecated
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

@Deprecated
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

@Deprecated
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

@Deprecated
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

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

Deprecated. this method has no effect - GIF export is always enabled

Sets whether the Qbchart can generate GIF or not

Throws:

java.lang.Exception

setBufferedImageUsed

public void setBufferedImageUsed(boolean state)

Sets whether the QbChart to use java.awt.image.BufferedImage technology to export image

Parameters:

state - The new state. The default value is false.

isBufferedImageUsed

public boolean isBufferedImageUsed()

Returns whether the QbChart to use java.awt.image.BufferedImage technology to export image

Returns:

the state

setBufferedImageType

public void setBufferedImageType(int imageType)

Sets java.awt.image.BufferedImage image type

Parameters:

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

See Also:

BufferedImage

getBufferedImageType

public int getBufferedImageType()

Returns java.awt.image.BufferedImage image type

Returns:

image type

setGrayscaleForExport

public void setGrayscaleForExport(boolean isGrayscale)

Sets using grayscale for export

Parameters:

isGrayscale - value for grayscale export. The default value is false

isGrayscaleForExport

public boolean isGrayscaleForExport()

Returns using grayscale for export

Returns:

isGrayscale value for grayscale export. The default value is false

getTemplateFile

public final 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.

Throws:

java.io.IOException

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 quadbase.ChartAPI.swing.QbChartPanel

Parameters:

border - The border to be rendered for the component (border must be instance of javax.swing.border.Border object)

setOpaque

public void setOpaque(boolean isOpaque)

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

Overrides:

setOpaque in class 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.

Throws:

java.awt.IllegalComponentStateException

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".

Throws:

java.io.IOException

getDimension

public final int getDimension()

Returns the dimension (2D or 3D) of the chart.

Associated QbChart property: DIMENSION

Returns:

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

setDimension

public final void setDimension(int d)

Sets the dimension (2D or 3D) of the chart.

Associated QbChart property: DIMENSION

Parameters:

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

getType

public final int getType()

Returns the type of the chart.

Associated QbChart property: CHART_TYPE

Returns:

an integer constant denoting the chart type.

setType

public final void setType(int type)

Sets the type of the chart.

Associated QbChart property: CHART_TYPE

Parameters:

type - : an integer constant denoting a chart type.

isPrintKeyEnabled

public boolean isPrintKeyEnabled()

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

Associated QbChart property: PRINTING

Returns:

True if print keys are enabled, false otherwise.

setPrintKeyEnabled

public void setPrintKeyEnabled(boolean b)

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

Associated QbChart property: PRINTING

Parameters:

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

isRefreshEnabled

public boolean isRefreshEnabled()

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

Returns:

True if refresh key is enabled, false otherwise.

setRefreshEnabled

public void setRefreshEnabled(boolean b)

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

Parameters:

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

isHiLowAsCandleStick

public final boolean isHiLowAsCandleStick()

Returns true if a hi-low chart is to be displayed in the form of a candlestick chart. The default is false.

Associated QbChart property: CANDLE_STICK

Returns:

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

setHiLowAsCandleStick

public final void setHiLowAsCandleStick(boolean b)

This function is used to display a HLCO chart in the form of a candlestick chart, depending on the value of parameter b. The default is false.

Associated QbChart property: CANDLE_STICK

Parameters:

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

setScrollBarOption

@Deprecated
public static void setScrollBarOption(int option)

Deprecated. This method is no longer existed. Please see quadbase.util.ICanvas.setScrollBarOption

Sets the scrollbar option for the main chart panel.

Parameters:

option - Possible scrollbar option. Choices are:

 ScrollPane.SCROLLBARS_ALWAYS
 ScrollPane.SCROLLBARA_AS_NEEDED
        ScrollPane.SCROLLBARS_NEVER

geth3DControlPanel

public final I3DControlPanel geth3DControlPanel()

Returns a handle to properties of the 3D control panel. Properties of the panel can be directly changed by calling methods on this interface.

Returns:

a handle to the interface quadbase.util.I3DControlPanel.

See Also:

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

@Deprecated
public final ITrendLineSet gethTrendLines()

Deprecated. Please use gethDataLines instead

Returns a handle to the set of trend lines. Properties of trend lines can be directly changed by calling methods on this interface.

Returns:

a handle to quadbase.ChartAPI.swing.ITrendLineSet.

See Also:

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

gethAggregationInfo

public final IAggregationInfo gethAggregationInfo()

Returns a handle to the aggregation property interface. Aggregation properties can be directly changed by calling methods on this interface.

Returns:

a handle to quadbase.util.AggregationInfo.

See Also:

IAggregationInfo

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.

Throws:

java.net.UnknownHostException

setServerPortNumber

public static void setServerPortNumber(int port)

Set the port number of EspressManager. Use this port number instead of the one provided in the espressmanager.cfg file. It also eliminates the need of the espressmanager.cfg file in the working directory.

setServerHosts

public static void setServerHosts(java.util.Vector<java.lang.String> hostnames)

Set the list of host names for EspressManager when tunneling is used. Use these hosts along with the ones provided in the espressmanager.cfg file. If the espressmanager.cfg file is not present, then only these hosts will be used.

getParameterPage

public 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()