JClass LiveTableProgrammer's Guide and Reference Manual
Version 2.1 and 2.1T
The Essential Java Grid/Table Component
JCLASS STANDARD LICENSE AGREEMENT
Important -- Read Carefully Before Using Software Package(s)
SOFTWARE LICENSE
LIMITED WARRANTY
U.S. GOVERNMENT RESTRICTED RIGHTS
Preface
Introducing JClass LiveTable
Feature Overview
Assumptions
Typographical Conventions in this Manual
Overview of Manual
Related Documents
Technical Support
Before Contacting Customer Service
How to Get Help
The JClass Developers Forums and Feedback
JClass Email List
JClass Newsgroup Forum
Announcements Mailing List
Request for Comments/Feedback
1Getting Started
Before You Begin
Setting your CLASSPATH
The CLASSPATH Statement
Setting the CLASSPATH in MS Windows
Windows 95
Windows NT (3.51 and higher)
Setting the CLASSPATH in Unix
JAR files and your CLASSPATH
Installation and File Descriptions
The -classes.zip Archive
Java Basics
Java Applications and Java Applets
JDK 1.0.2 and JDK 1.1
Determining the JDK and JClass LiveTable Version
JClass LiveTable and Java Beans
2 Developing a Simple JClass LiveTable Pro Program
Writing a Simple Java Stand-Alone Application
A Basic Table Applet
Inserting an Applet into a Web Page
Basic Stand-Alone Table Application
Setting the Table Size
Adding Column Labels and Formatting the Table
Setting Labels
Changing Alignment
Changing the Fonts
Formatting Parts of the Table
Adding a Title
Overall Table Formatting
The Finished Application
Loading Properties from a Web Page
End-User Interaction
Proceeding From Here
3 JClass LiveTable Pro Basics
Table Anatomy
Cell
Label
Current Cell
Text Component Management
TextComponent
Scrollbar Components
Table Contexts
A Cell
A Row Label
A Column Label
All Cells in Row/Column
Entire Row/Column
All Cells in Table
Entire Table
Range
Setting Cell/Label Properties
Using HTML Files to Set Properties
Displaying Reserved Characters within Cells
4 Programming JClass LiveTable Pro
Property Summary
Number of Rows/Columns
Visible Rows/Columns
Displaying the Entire Table
Frozen Rows and Columns
Freezing Rows and Columns
Frozen Row/Column Placement
Row and Column Labels
Setting and Retrieving Label Values
Setting All Labels
Setting Individual Label Values
Retrieving a Label
Label Placement and Spacing
Label Placement
Label Spacing
Table Titles
Adding a Title
Positioning a Title
Resize Handling
Row Height and Column Width
Character Height and Width
Pixel Height and Width
Variable Height and Width
Hiding Rows and Columns
Cell and Label Margins
Foreground, Background and Shadow Colors
Specifying Colors
Selected Cells
Repeating Colors
Cell and Label Text Alignment
Cell and Label Fonts
Border Types and Sides
Cell and Label Border Types
Cell and Label Border Thickness
Cell and Label Border Sides
Frame Border Attributes
Images
Image Format
Specifying an Image
Removing an Image
Image Layout
Text and Image Clipping
Clipping
Cell and Label Spanning
User Data
5 JClass LiveTable Pro Data
The Cells Vector
Convenience Procedures
Getting Data into a Table
Data from a File
Manipulating Table Data
Setting and Retrieving Cell Values
User Editing
Retrieving Cell Values
Searching for Strings
Adding Rows and Columns
Deleting Rows and Columns
Moving Rows and Columns
Clearing Cell Values
Clearing the Entire Table
6 Programming User Interaction
Default User Interaction
User Interaction Customization
List Mode
Table Scrolling
Scrollbars
Scrollbar Attachment
Scrollbar Display
Jump Scrolling
Scrollbar Attributes
Programming Scrolling
Disabling Interactive Scrolling
Forcing Scrolling
Scroll Listener Methods
Row and Column Resizing
Disallowing Cell Resizing
Controlling Resizing
Cell Traversal
Disallowing Cell Traversal
Minimum Cell Visibility
Forcing Traversal
Controlling Interactive Traversal
Cell Editing
Forcing Edits to Be Assigned to a Cell
Disallowing Cell Editing
Case Conversion
Multiple-Line Cells
Text Length
Text Component Attributes
Controlling Editing at Runtime
Cell Selection
Selection Policy
Selected Cell List
Selection Colors
Working with Selected Ranges
Forcing Selection
Removing Selections
Runtime Selection Control
Mouse Pointers
Disabling Pointer Tracking
7 JClass LiveTable Pro Programming
Components in Cells/Labels
Components in Cells/Labels
Components in a Table
Adding a Component
Variable Rows/Columns
Hiding a component
Determining Component Location
Create Component Listener
Display Component Event Listener
Components in HTML Files
Cell/Label Value Validation
Overview
Cell/Label Data Type
Validation Policy
Validate Cell Listener
Table Sizing and Resizing
Expose and Resize Listener
Multiple Tables with Common Cell Values
Performance Improvement
General Performance
Interactive Performance
Display Performance
Cell Values Handling
Using an External Data File
Live Data Updating
Appendix A Colors and Fonts
Colorname Values
RGB Color Values
Fonts
Appendix B JCString Properties
Alignment
Color
Fonts
Horizontal and Vertical Spacing
Hypertext
Images
Reset
Strikethrough text
Underlined text
Appendix C JClass LiveTable Event Summary
1.0 Callback Conversion Table
JClass Table API Reference Documentation
jclass.table Package
jclass.util Package
jclass.contrib Package