Thank you for purchasing or evaluating JClass DesktopViews. This document contains installation instructions, JDK requirements, and release notes for the products in the JClass DesktopViews suite.
Note: JClass DataSource, JClass Field, and JClass HiGrid are no longer part of the suite. If you require one of these products, you should request JClass DesktopViews version 6.3.0.
JClass components work with any platform that supports JavaBean components using the Java Platform Standard Edition (hereafter referred to as JDK) version 1.4.2 or later. We recommend using the most recent JDK version available for your platform.
Note: Some code patterns used in this release are not compatible with JDKs prior to JDK 1.4.2. Some features, demos, and examples may throw exceptions if used with older JDKs.
* Using JavaBeans is not supported on this IDE
Note: If you experience drawing problems, you may want to upgrade to the latest drivers for your video card from your video card vendor.
This section contains information about installing and operating this product in non-English or non-ASCII configurations, such as those needed by customers outside the USA. This section does not replace the materials about supported platforms and configurations found elsewhere in the product documentation.
The platforms and configurations supported in this release may use any time zone, character encoding, language, or locale configuration to operate this product. All components of this product must/should be configured to use the same or compatible character encodings and must/should be installed to use the same locale and/or regional options.
This release has been tested with the following language and platform
combinations in addition to U.S. English:
This product has the following known capabilities or limitations:
Requirement for PDF viewers
In order to display PDF files created with JClass correctly,
your PDF viewer must support the PDF 1.4 specification. Failing that,
JClass PDF files may display with incorrect formatting and some PDF
features may be disabled. We recommend using the latest version of Adobe
Acrobat.
Java 2 Appletviewer Usage
Some JClass examples and demos may not run using the appletviewer
tool (particularly "common" demos using multiple JClass products).
JDK 1.2 changed appletviewer so that it does not use the CLASSPATH,
and by default runs using more security. To work around this issue,
try to run the applet with no security enabled; for example:
appletviewer -nosecurity index.html
Note that there should be no problems running JClass demos
or examples using the Java interpreter, for example:
java examples.chart.axis.TimeAxis
Java 2 Browser Support (Plug-In) If your browser doesn't support Java 2, you can use the Java Plug-In to run this version of JClass. For some older browsers, a conversion must be run on all HTML files in order to use the Plug-In. The conversion is provided with the Plug-In, and does not interfere with the operation of the pages. Please refer to http://java.sun.com/products/plugin/ for more details on the Java Plug-In for Java 2.
There are four basic steps to installing JClass DesktopViews:
These steps are described in the JClass DesktopViews Installation Guide. The Installation Guide also includes general information on licensing, setting up your environment, running examples and demos, and integrating JClass DesktopViews with an IDE.
Note: JClass DesktopViews automatically creates a JCLASS_HOME environment variable that points to the directory you chose while running the installer, for example, C:/JClassDesktopViews.
You can launch the Gallery executable at a command prompt:
cd JCLASS_HOME/bin
jcexamples
Windows users can also launch the Gallery from the JClass DesktopViews program group off the Start menu.
For more information, see the JClass DesktopViews Installation Guide.
In general, source code for each of the products is installed in a directory hierarchy matching the package names. For example, JClass Chart source code is installed in JCLASS_HOME/com/klg/jclass/chart. There are two exceptions. JClass Elements is installed in JCLASS_HOME/com/klg/jclass/swing and shared code is installed in JCLASS_HOME/com/klg/jclass/util.
JClass customers who wish to obtain either of these versions should contact their Quest Software sales representative.
JClass 5.0 "J"
JClass 5.0 "J" supports JDK 1.1.8 or greater with Swing 1.1.1 environments.
JClass "J" version is an excellent choice for developers who are adding
functionality to existing Java programs operating in a Java 1.1.x environment
or programmers developing in environments that do not yet support Java
2. Also, use the collections JAR that ships with JClass 5.0 "J" to ensure
compatibility.
JClass 3.6.3
JClass 3.6.3 supports JDKs (1.02,1.1.x) using AWT. JClass
3.6.3 is an excellent choice for programmers who are extending existing
systems running in environments that do not support Swing or who do
not wish to use Swing. The JClass 4.0 (and later) API was redesigned for Java 2 and JFC/Swing,
and is not compatible with JClass 3.6. A porting guide is available
to help you migrate your JClass 3.6 application to use a later version
of JClass. Please contact your Quest Software sales representative.
43879 Last contour level not drawn correctly.
23379 OutOfMemoryError when we set custom contour level with zero
value.
com.klg.jclass.util.legend.JCLegend in the
JClass DesktopView API and see setSymbolRenderMode().
35028 Add support for time-based values in JDBCDataSource.
44296 Radar charts do not allow negative values.
48916 Customizer: Chart not repainted when a threshold or marker is removed.
52211 Data not always saved when saving Chart to XML (or HTML).
15295 Line style in legend doesn't match line style in chart.
33062 JCAxis.setNumSpacing has no effect on
VALUE_LABELS. Note: NumSpacing has been replaced by
JCAnno mechanism.
33440 Labels disappear when setNumSpacing is used with exponential
numbers.
36067 Encoding JCChart to postscript with
JCSymbolStyle.DOT does not show symbols.
37109 In a chart with two data views, setting IsIncluded=false
on one series makes that series invisible.
37151 Customizer: "Use this Font" button throws NullPointerException.
39557 JCDefaultChartLabelManager.removeAutoLabels() throws
ArrayIndexOutOfBoundsException.
41079 [CR0109071] Failure to zoom when chart precision is exceeded should be
documented in Javadoc.
41671 Cannot interactively zoom with a logarithmic axis.
44581 Enabling gridlines for radar and area radar charts throws exceptions.
47763 [CR0163253] Extra lines are drawn when a chart is embedded in PageLayout
and outputted to PDF.
48016 When Annotation Method is set to Time Labels and Annotation Rotation is
Other, the x-axis labels do not display correctly.
48527 Picking does not work correctly for negative values in a stacking
area chart.
JCChart component fails to stretch accordingly under dual
screen environment.JCChart legend is displayed in the wrong position if there is
a large number of data series.10105 Repainting problems with fast updates to chart (SWING limitation).
11116 NumberFormat class gives wrong annotation value for zero
values the second time around.
The circular and linear gauges have been moved to JClass Gauge. See JClass Gauge Release Notes.
39268 JDK 1.5: In JCPopupCalendar, the hour field in the time spinner does
not spin.
40238 [CR0103159] Calling setTreeTableModel() removes any ListSelectionListener
objects that were added to the JCTreeTable selection model.
44973 Column sort in JCSortableTable is slow when the table contains lots of rows.
15447 setRootVisible(false) is not taken in account when
JCTreeTable view is changed from Tree to Table.
15539 Content of JCWizardPage does not stretch properly
using a JCElastic interface.
16337 Dynamically updating the table model interferes with tree table sorting.
17000 Maximizing a JCMDIFrame inside of a JCMDIPane
does not work correctly.
23749 StackOverflowError thrown when using
JCSpinFieldCellEditor in JCSortableTable.
27431 Cannot start editing without mouse in TreeColumn
of JCTreeTable.
27460 CheckBoxEditor in TreeTable behaves differently
in JDK 1.4.
28015 Response on folder selection gets slower over time.
28873 JCSpinNumberBox does not notify listeners when invalid input.
29253 On row selection, highlight color should fill in the intercell spacing.
30186 expandPath() method of TreeTable does not
work correctly.
35047 JCDateChooser not intuitive with specific day values.
38728 Min/max/close buttons disappear on a maximized JCMDIPane in a Frame.
40954 [CR0108213] JCTreeTable does not fire TreeSelectionEvent and only
fires ListSelectionEvent when a tree table row is selected.
JClass Gauge is new for this release of JClass DesktopViews. It contains
the circular and linear gauges that were part of JClass Elements, a new
indicator gauge and panel, and a new light-weight graph component.
If you are updating an application that has circular or linear gauges,
you need to import the package com.klg.jclass.gauge.JCGauge.
LinearGaugeBean.java is now LinearGauge.java
and CircularGaugeBean.java is now
CircularGauge.javaIndicatorGauge.java and
IndicatorGaugePanel.java beansJCGraph.javaPortableImage objectsscaleImage property has been deprecated and replaced
with imageScaled49171 If set maximum of JCGraph, the max value can get "adjusted" to be different than what was set.
24730 Center of circular gauge draws incorrectly for
TOP_HALF_CIRCLE and LEFT_HALF_CIRCLE.
43403 Default range names do not appear in legend.
46776 Circular/Linear scales use foreground color to draw background.
Note: For backward compatibility, the setForeground()
method remains, but now calls the setBackground() method.
47456 Beans: Image properties not available.
47724 TailedPointer and TailedArrow indicator/needles do not draw to outer
extent correctly.
48695 Tick labels do not draw correctly using the Evaluation version.
25943 Setting JCCircularRange results in a band with irregular
thickness.
48525 In Preferences dialog, selecting a font and then clicking Cancel throws NullPointerException and makes the Preferences dialog unusable.
9533 Up-one-level button in the toolbar never becomes disabled.
12881 VM can't load javax.swing.* classes when these are
archived by JarMaster.
13869 Choosing "save as" does not update window title to the new file
name.
14255 JarMaster does not always allow you to select multiple files.
32654 Help window in Manifest editor is not functioning properly.
48973 [CR0170421] Double click needed to transfer the focus from an
editable cell to a different component.
49125 [CR0171416]Table: ALT key not processed properly in JDK1.4 and later.
49368 [CR0172585]Table: PageDown key does not work properly in JCTable if it
contains HiddenRows.
54962 Popups show up on wrong monitor in dual monitor environment.
30944 [CR0154075] JCKeyModifier has no effect.
40235 [CR0113095] Esc key doesn't cancel edit when using Cell Editor in a table
in JInternalFrame.
40386 Cells skipped in traversal and selection.
40471 JCXMLTableModel ignores xml encoding.
41369 The combination of spanned cells and frozen columns causes flashing between
different backgrounds in some cells.
41685 Text in spanned cells wraps to the width of a single cell.
43232 [CR0130517] In WordWrap table cells, using Ctrl+V pastes copied text twice.
44428 [CR0137771] Integers read in XML file converted to doubles.
45573 ExpressionVariable stores instances in a static map and never frees them
for garbage collection.
45641 [CR0147759] When the number of frozen rows is greater than the number that can be
currently viewed, the scroll bar does not work correctly.
45867 [CR0149141] Drag and drop of a column does not stay in a Dataview of a
JCTable if mouse button released outside the frame window.
46569 [CR0153234] Hide columns doesn't work if columns are swapped.
47422 [CR0160400] Median formula in JCTable returns wrong value.
48143 TableDataView does not honor table.repaint_enabled=false.
10445 Deleting rows of various heights causes heights to get mixed up if height
is VARIABLE.
10543 Selection fails if a mouse click is on a spanned portion of a spanned cell
range.
10835 Mouse-generated TraverseCell events are fired twice by
datasources implementing EditableTableModel.
10846 JCComboBoxCellEditor/Renderers(Object[], int[]) constructor
does not appear to function properly.
11076 JCListTable does not have the sort capabilities of a
JCTable.
11162 Empty rows added to editable datasources are not editable.
11204 Table moves when cell resized/tracks cursor incorrectly is resizable from
outside table.
11353 Strange behavior after calling setAutoEdit(true).
11393 JCComboBoxCellEditor unusable when extended outside applet
with Windows or Motif look and feel.
11673 JCTraverseCellEvent.setCancelled(boolean) does not work.
11724 JCTable does not support accessibility.
11807 The getTopRow() method returns 0 unless
setTopRow() has been called.
11947 Null values not allowed in field validators used in tables.
11992 Failed repaint when column dragged across header and release onto cell
area.
13514 Cannot choose printers through print preview Window.
14061 Large spanning ranges break table.
14515 Table spans do not print correctly.
14546 Problem with column re-ordering.
14667 Focus remains on previous cell after column label is clicked.
14668 Frozen columns cause isCellVisible to report inaccurately.
15556 JBdbTable unable to delete record without exception.
18229 AbstractDataSource.fireDataReset() does not update
RowColumnSeriesModel.
19899 SortLabel class is limited in application.
24203 JCTable.isEditable(...) throws
StackOverflowError if performed on a spanned, hidden cell.
25259 Border does not go around the entire table if row labels are not visible.
26033 Right aligned cells not well positioned within column.
27193 Two tabs require to move to next cell when
JCPopupFieldCellEditor is used to change date value.
27353 The top_row variable is not updated as table is scrolled.
31122 Range selection by dragging the mouse over spanned row labels fails.
39969 Pressing Ctrl Tab doesn't cause focus to go to the next
component. Workaround exists: Define a focus traversal policy for the table's
container (by extending the abstract FocusTraversalPolicy class) which dictates
the components before and after the table. The container must also be made a
focus cycle root. Contact technical support to get a code example.
41714 Column borders disappear when the last column in a table is hidden.
41715 Column label borders disappear when the first data column is frozen.
48571 [CR0166715] JCTable does not function correctly if the number
of rows is 108 million or greater.
44888 [CR0143142] Add support for GradientPaint in PDF graphics driver.
17852 JClass PageLayout goes into endless loop if an image is too big for the
page.
18254 Support for Greek characters.
32634 Composite unicode characters not appearing properly for some fonts.
34859 Memory leak in JCPageTable. The list of tables was not flushed
when the flushPolicy property was set to
FLUSH_POLICY_ON_OUTPUT.
37300 Investment demo throws exception when printing to file.
37562 When multiple columns are hidden in a JCTable,
JCPageTableFromJCTable.createTable() creates a JCPageTable that
shows the wrong set of columns.
41685 Text in spanned cells wraps to the width of a single cell.
42173 Acrobat 7 throws errors on PDFs with empty cells in a table.
44428 [CR0137771] Integers read in XML file converted to doubles.
46877 [CR0155053] JCPageTable not updating TableDataModel correctly.
47025 [CR0155053] How to populate JCPageTable's tableData not
documented. Not the desired method; example code corrected.
47763 [CR0163253] Extra lines are drawn when a chart is embedded in PageLayout
and outputted to PDF.
48231 JCFrame.print(table, firstColumn, lastColumn, firstRow, lastRow) ignores
lastRow.
8143 Transparent GIFs are not handled.
8205 Embedding images aligned to the bottom of the line messes up the next line.
8411 PCL printer does not clip text that is printed outside of a frame.
8421 PCL font strings and tabs lengths are computed incorrectly.
10890 JPEGs are not printed correctly and some other distortions.
11384 PCL output cuts off JLabel text.
11559 Kerning problems with text in mixed weight fonts (bold/plain).
12098 JClass PageLayout ignores Swing JTable formatting
information.
12261 Discrete words joined together when justification is used with a small
font.
12611 PDF file generated for a table containing text is too large.
13132 Processing of line feed characters in JCPageTable.
13804 JCAWTPrinter.cancel() method outputs a blank page to the AWT
printer.
14605 embedComponent() method does not preserve dashed line styles
in JCChart.
14609 Fonts not displaying properly in some instances.
14712 The embedComponent() method fails ungracefully if no image
path is given for HTML printer.
14764 The floatImage() method is malfunctioning when there is not
enough space on the same page.
14857 ZapfDingbats font must be flowed in first for it to work.
14947 Bad fonts in chart output to EPS.
15287 JCPDFPrinter and JCPCLPrinter problems with
JCPageTable cells that are longer than the page length.
15738 JC[AWT]Printer.setNumCopies(int) is ignored.
15805 Spanned cell in JCTable causes error in
JCPageTable when using JCPageTableFromJCTable.
15979 JCPageTableFromJCTable.createTable(document,table,true)
method throws java.lang.IllegalArgumentException.
17429 Converting from JCTable to JCPageTable using
TableDataModel as an argument throws
java.lang.IllegalArgumentException.
17452 When using JCTableStyle in JCPageTable, some
styles do not function properly.
17464 PCL printing does not scale embedded components.
17758 Badly rendered Chart3d in PDF output.
17903 JCPageTable truncating cells when table cell is longer than
the length of the page.
18256 Incorrect PCL produced.
18500 The getSize() method of JCFrame in
PageTable always returns height of 1000 inches.
20744 Encoders for wide components produce landscape documents.
20809 NullPointerException in
JCAWTPreviewer.dispose().
20828 Embedded components are not drawing properly in PCL.
20830 Tab filled with dots overwriting tabbed text in AWT printer.
22732 JCPageTable does not clip at column boundary.
23902 PCL output erroneous and differs greatly from equivalent PDF output.
26102 JCAWTPrinter.cancel() throws
NullPointerException.
26557 Clip improperly handled during rotations, scales, etc.
29190 Vertical component of insertion point ignored when placing tables.
29464 AWT printers can not use OUTPUT_POLICY_IMMEDIATE.
29665 JPEG encoder gives transparent images black background.
7978 JAVA bug: AWT printer only -- superscript and subscript are mixed up and
positioned too far from the baseline. Related to bug 8083.
8005 JAVA bug: AWT underlining covers the bottom pixels of the text which is
underlined. Filed with Sun, not yet accepted. Review ID 54732.
8032 JAVA bug: Table and cell borders extend too far past their cell using all
printers except PCL (like a #).
8043 JAVA bug: All frames are shifted by about 1/8 of an inch to the bottom
right using the AWT printer only.
8087 JAVA bug: Courier 12pt underlined font is a different height than other
Courier 12pt fonts (it is too small).
8097 JAVA bug: The lower case "s" crowds other letters in the
Helvetica 10pt font using the AWT printer.
34247 Segmentation Fault on Mac OS with Java 1.4 when generating PDF output.
Workaround: To print to PDF, specify the -awt option, click the
Preview button from the print dialog, then save the preview PDF in Preview.app.
35438 The MacOS X 10.2 java 1.4.1_01 VM crashes when used with pagelayout PCL
and (E)PS printers.
48744 Generating PostScript on MacOS with JDK 1.4.2 does not work in all
cases and may cause your application to crash with system errors.
This document contains proprietary information protected by copyright. The software described in this document is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser's personal use without the written permission of Quest Software, Inc.
If you have any questions regarding your potential use of this material, contact:
Quest Software World Headquarters
LEGAL Dept
5 Polaris Way
Aliso Viejo, CA 92656
www.quest.com
email: legal@quest.com
Refer to our web site for regional and international office information.
Quest, Quest Software, the Quest Software logo, and JClass are registered trademarks of Quest Software, Inc. Other trademarks and registered trademarks used in this guide are the property of their respective owners.
This product includes software developed by the Apache Software Foundation http://www.apache.org.
This product includes software developed by the JDOM Project (http://www.jdom.org). Copyright © 2000-2002 Brett McLaughlin & Jason Hunter, all rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest products. EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to update the information contained in this document.