# Preface

Introducing JClass BWT · Assumptions

Typographical Conventions in this Manual · Overview of the Manual

Related Documents · Technical Support

The JClass Developers Forums and Feedback

## Introducing JClass BWT

JClass BWT is a collection of pre-built, pre-tested, 100% Java GUI components. Now you can develop stable Java applications faster and easier than ever before.

JClass BWT may be used in conjunction with other KL Group JClass components like JClass LiveTable and JClass Field.

All JClass BWT components are written entirely in Java; as long as the Java implementation for a particular platform works, JClass BWT will work.

You can freely distribute Java applets and applications containing JClass components according to the terms of the JCLASS STANDARD LICENSE AGREEMENT .

#### Feature Overview

For a run down of features supported by each JClass BWT component, see the appropriate chapter. In general, JClass BWT components offer the Java developer:

- Consistent look and feel across all platforms
- Mixed font, multi-color text, image, and URL support
- Java Beans-style API and event-handling for both JDK 1.1 and JDK 1.0.2
- JCStrings, which enable component text to use multiple fonts, images, and hypertext links

## Assumptions

This manual assumes that you have some experience with the Java programming language. You should have a basic understanding of object-oriented programming and Java programming concepts such as classes, methods, and packages before proceeding with this manual. See " Related Documents " later in this section of the manual for additional sources of Java-related information.

## Typographical Conventions in this Manual

`Typewriter Font` | Java language source code and examples of file contents. JClass BWT and Java classes, objects, methods, properties, constants and events. HTML documents, tags, and attributes. Commands that you enter on the screen.
Italic Text | Pathnames, filenames, URLs, programs and method parameters. New terms as they are introduced, and to emphasize important words. Figure and table titles. The names of other documents referenced in this manual, such as Java in a Nutshell.
Bold | Keyboard key names and menu references.

## Overview of the Manual

Part I -- "Using JClass BWT", describes how to use the individual components of JClass BWT.

Getting Started contains information about configuring JClass BWT, basic information about Java, and specific issues to be aware of before you begin using JClass BWT.

Chapter 2, " JCLabel and JCButton ", describes how to use the label and pushbutton components.

Chapter 3, " JCCheckbox and JCCheckboxGroup ", describes how to use the checkbox and radio button components.

Chapter 4, " JCTabButton and JCTabManager ", describes how to use the tab manager and tab button components.

Chapter 5, " JCScrolledWindow ", describes how to use the scrolled window component.

Chapter 6, " JCList and JCMultiColumnList ", describes how to use the list box and multi-column list components.

Chapter 7, " JCOutliner ", describes how to use the outliner components.

Chapter 8, " JCTextComponent, JCTextArea and JCTextField ", describes how to use the text field and text area components.

Chapter 9, " JCArrowButton ", describes how to use the arrow button component.

Chapter 10, " JCComboBox ", describes how to use the combobox component.

Chapter 11, " JCSpinBox and JCSpinBoxString ", describes how to use the spinbox component.

Chapter 12, " JCProgressMeter ", describes how to use the progress meter component.

Chapter 13, " JCSlider ", describes how to use the slider component.

Chapter 14, " JCSplitterWindow and JCSeparator ", describes how to use the splitter window component.

Chapter 15, " JCAlignerLayout ", describes how to use the BWT Aligner layout manager.

Chapter 16, " JCScrollbar ", describes how to use the scrollbar component.

Part II --"Reference Appendices", contains additional technical reference information related to programming with JClass BWT.

Appendix A, " Colors and Fonts ", lists all of the colornames and RGB values that can be used in JClass BWT applications. It also lists all of the fonts and font style constants that can be used.

Appendix B, " JCString Properties ", describes the types of JCString properties available for adding hypertext, images and text within programs utilizing JClass BWT components.

Appendix C, " JClass BWT Event Summary ", includes a summary table of events used in JClass BWT, a listing that maps AWT events to JClass BWT 2.0 counterparts, and a table that maps JClass BWT 1.0x callbacks to their 2.0 counterparts.

## Related Documents

The following resources are available for Java programmers in print or on the World Wide Web:

- "Writing Java Programs" at http://www.javasoft.com/docs/programmer.html and the "Java Tutorial " at http://www.javasoft.com/docs/books/tutorial/index.html from Sun Microsystems
- Java in a Nutshell from O'Reilly & Associates
- Resources for using Java Beans are at http://www.javasoft.com/beans/resources.html

You do not need these documents to use JClass BWT and they are not endorsed by KL Group. They are simply a sampling of useful references for the Java programming language.

## Technical Support

KL Group's Customer Service Team provides two separate support plans to suit your needs. Standard Support , included with your purchase, gives you:

- Unlimited access to KL Group's web site, which contains additional example and demo programs, FAQs, product updates, and Knowledge Base
- JClass Support Newsgroup

At an additional cost, you can receive the benefits of the Gold Support plan for a full year, including:

- Software subscriptions for major upgrades
- Technical support questions and requests submitted directly to the Customer Service Team at KL Group through the Express Case Submission form on our web site
- Individual problem resolution through email, telephone or fax.

For information on how to obtain Gold Support for your JClass product, contact the JClass Sales Team at (416) 594-1026.

#### Before Contacting Customer Service

Please have the following information ready when contacting Customer Service:

- The type and version of the operating system you are using
- Your development environment and its version
- Your JClass serial number
- A full description of the problem including the steps required to duplicate it.

Support Channel | Help Available | Contact
--- | --- | ---
KL Group Web page | Updated Frequently Asked Questions (FAQ) list answering common questions Updated example and demo programs Product updates, bug-fixes, minor feature enhancements JClass Knowledge Base Help with using JClass Components in Integrated Development Environments (IDEs) Gold Support Express Case submission | Point your Web browser to http://www.klg.com and navigate to the Customer Service page
JClass Support Newsgroup | This newsgroup is an informal technical support resource that any JClass developer can use to get (or give) help for JClass products. The JClass Support and Product teams monitor the newsgroup regularly but do not answer every question posted. Instead, effort is concentrated on answering questions not covered in the Knowledge Base or FAQ documents. | Point your news reader to: news://news.klg.com/klg.support.jclass

## The JClass Developers Forums and Feedback

KL Group maintains an unmoderated Internet electronic mail forum and newsgroup for all developers interested in discussing JClass products. Developers can use these forums to discuss JClass products and programming, and to share ideas with other developers around the world.

#### JClass Email List

To join the email list:

- Send email to `jclass-forum-request@klg.com` with the word "`subscribe`" in the body of the message.

To send a message to everyone on the list:

- Send email to `jclass-forum@klg.com` .

#### JClass Newsgroup Forum

To access the newsgroup:

- Point your news reader to news://news.klg.com/klg.forum.jclass

#### Announcements Mailing List

Occasionally, KL Group sends JClass-related product announcements to its customers via a mailing list. To add yourself to this mailing list, send email with the word "`subscribe`" in the body of the message to:

- `jclass_announce-request@klg.com`

#### Request for Comments/Feedback

We are interested in hearing about how you use JClass BWT, any problems you encounter, or any additional features you would find helpful. The majority of enhancements to JClass products are the result of customer requests.

Please send your comments to:

KL Group Inc.
260 King Street East
Toronto, Ontario, M5A 1K3 Canada

Phone: (416) 594-1026
Fax: (416) 594-1919
Email: `dev_jclass@klg.com
` Internet: news://news.klg.com/klg.support.jclass

Your feedback is appreciated, but a response is not guaranteed. Please refrain from using the `dev_jclass` email address for technical support questions.