JClass ChartProgrammer's Guide and Reference Manual
Version 2.0 and 2.0T
The Best Java Charting Solution
JCLASS STANDARD LICENSE AGREEMENT
Important -- Read Carefully Before Using Software Package(s)
SOFTWARE LICENSE
LIMITED WARRANTY
U.S. GOVERNMENT RESTRICTED RIGHTS
Preface
Assumptions
Typographical Conventions Used in this Manual
Overview of Manual
Related Documents
Installing JClass Chart
Before You Begin
JDK 1.0.2 and JDK 1.1
Determining the JDK and JClass Chart Version
Minimum Requirements
Installation and File Descriptions
The -classes.zip Archive
JClass Chart Overview
Introduction
Feature Overview
Setting CLASSPATH
Windows 95
Windows NT (3.51 and higher)
Using the Java Programming Language
Compiling a Program
Distributing JClass Chart Applications
Technical Support and Feedback
Technical Support Plans
Standard Support (included with purchase)
Gold Support
How to Get Technical Support
Before Contacting Customer Service
The KL Group Web Site
JClass Support Newsgroup
JClass Developers Forums
JClass Email List
JClass Newsgroup Forum
Announcements Mailing List
Request for Comments
1 Chart Basics
Chart Terminology
Using the Chart Customizer
Immediate Feedback Model
Displaying the Chart Customizer at Run-Time
Editing Chart Properties
Displaying the Editor at Design Time
Interacting with the Chart
Choosing the Chart Type
Understanding Data Layout
Array Layout
General Layout
2 Developing a Simple JClass Chart Program
Introduction
A Basic Plot Chart
Adding Formatting Information
Adding Headers and Footers
Adding a Legend
Customizing Axis Labels
The Completed Program
Plotting an Inverse Chart
Changing to a Bar Chart
Inverting Bar Orientation
End-User Interaction
Proceeding From Here
3 JClass Chart and Java Beans
Java Beans
Properties
Setting Properties with a Java IDE at Design-Time
Setting Properties at Run-Time
Setting Properties using Methods
Setting Applet Properties in an HTML File
Determining Which Technique to Use
New Event Model
JCChart and JCChartComponent
4 Building a Chart
Creating a New Chart in a Nutshell
Axis Annotation Overview
Values Annotation
ValueLabels Annotation
PointLabels Annotation
TimeLabels Annotation
Choosing Annotation Method
Annotating with Values
Numbering Precision
Numbering and Ticking Increments
Annotating with ValueLabels
Annotating with PointLabels
Annotating with TimeLabels
Time Unit
Time Base
Time Format
Positioning Axis Annotations
Specifying Annotation Placement
Chart Orientation and Axis Direction
Chart Orientation
Axis Direction
Setting Axis Bounds
Min and Max
Customizing Origins
Origin Placement
Origin Coordinates
Logarithmic Axes
Specifying a Logarithmic Axis
Titling Axes and Rotating Axis Elements
Adding an Axis Title
Axis Title Rotation
Axis Title Text
Rotating Axis Annotation
Adding Grid Lines
Grid Spacing
Grid Appearance
Adding a Second Axis
Defining Axis Multiplier
Using a Constant Value
Hiding the Second Axis
Other Second-Axis Properties
5 Customizing Chart Elements
Adding Header and Footer Titles
Title Text and Alignment
Title Positioning
Title Border
Title Colors
Title Font
Using a Legend
Legend Text and Orientation
Legend Positioning
Legend Border
Legend Colors
Legend Font
Changing ChartStyles
FillStyle
LineStyle
SymbolStyle
Using Borders
Changing a border
Choosing Fonts
Changing Fonts
Setting Colors
Specifying Colornames
Specifying RGB colors
Color Defaults
Changing Color
Positioning Chart Elements
Changing the View Location
Changing Width and Height
3D Effect
3D Depth
3D Elevation
3D Rotation
Special Bar Chart Properties
Cluster Overlap
Cluster Width
Special Pie Chart Properties
Building the Other Slice
Other Slice Style and Label
Pie Ordering
Exploded Pie Slices
Hi-Lo and Candle Charts
Hi-Lo-Open-Close Charts
Customizing ChartStyles
Simple and Complex Candle Charts
Example Programs
6 Programming JClass Chart
Programming Basics
Object Hierarchy
Setting an Object Property
Using Collections
Calling Methods
Demo Programs
Axis Labelling
Batching Chart Updates
Coordinate Conversion Methods
CoordToDataCoord and DataIndexToCoord
Map and Unmap
Double Buffering
FastAction
Programming Actions
Event Triggers
Valid Modifiers
Programming Event Triggers
Removing Action Mappings
Calling an Action Directly
Specifying Action Axes
Programming ChartStyles
Customizing Chart Styles
Using a Time-axis
Date Methods
Data Sources
Chartable and EditableChartable
Stock Data Sources
InputStreamDataSource and Other Stock Data Sources
Image-Filled Bar Charts
Using JCStrings
Using Pick and Unpick
Pick Focus
Unpick
Appendix A JClass Chart Inheritance Hierarchy and Containment Listing
Inheritance Hierarchy
Containment Listing
Appendix B JClass Chart Property Listing
ChartDataView
ChartDataViewSeries
ChartRegion
ChartText
JCAxis
JCAxisFormula
JCAxisTitle
JCBarChartFormat
JCBorderStyle
JCCandleChartFormat
JCChart
JCChartArea
JCChartComponent
JCChartLabel
JCChartStyle
JCFillStyle
JCHLOCChartFormat
JCLegend
JCLineStyle
JCPieChartFormat
JCSymbolStyle
JCTitle
JCValueLabel
PlotArea
Appendix C JCString Properties
Alignment
Color
Fonts
Horizontal and Vertical Spacing
Hypertext
Images
Reset
Strikethrough text
Underlined text
Appendix D Colors and Fonts
Colorname Values
RGB Color Values
Fonts
Appendix E HTML Property Reference
ChartDataView Properties
ChartDataViewSeries Properties
JCAxis X- and Y-axis Properties
JCBarChartFormat Properties
JCCandleChartFormat Properties
JCChart/JCComponent Properties
JCChartArea Properties
JCChartLabel Properties
JCDataIndex Properties
JCHLOCChartFormat Properties
JCHiLoChartFormat Properties
JCLegend Properties
JCPieChartFormat Properties
JCTitle Header and Footer Properties
Example HTML File
JClass Chart API Reference Documentation
jclass.chart Package
jclass.util Package
jclass.contrib Package