JMultiLineLabel 1.0 Installation & Compatibility

WILDCREST ASSOCIATES

Installation

Download the JMultiLineLabel zip file and unzip.  This will create a JMultiLineLabel folder containing both code and documentation.

To access the documentation, use your favorite browser to view the file JMultiLineLabelREADME.html.

To use JMultiLineLabel as an ordinary class in Java applications, since JMultiLineLabel comprises a group of classes in package com.wildcrest.jmultilinelabel, the folder com\wildcrest\jmultilinelabel needs to be accessible from your class path. You need to do one of the following things:

1. Modify your classpath to include the JMultiLineLabel folder (the top-level folder of what was unzipped)
2. Modify your classpath to include JMultiLineLabel.jar
3. Pick a folder in your current classpath that does not already have a com folder. Copy JMultiLineLabel's com folder into it.  One possibility is the folder that contains your application, which is always in your classpath.
4. Pick an existing com folder in your current classpath that does not have a wildcrest subfolder.  Copy the wildcrest subfolder into your existing com folder
5. If you already have a com\wildcrest folder in your classpath, copy JMultiLineLabel's com\wildcrest\jmultilinelabel subfolder into it

1. Put com\wildcrest\jmultilinelabel\JMultiLineLabel.class in the same folder as your applet (whether on your local system or across the network)
2. In the applet tag, set ARCHIVE="JMultiLineLabel.jar" (or "C:\directory\JMultiLineLabel.jar" if it is somewhere else)
3. In the applet tag, set CODEBASE="directory-containing-com\wildcrest\jmultilinelabel\JMultiLineLabel.class"

JMultiLineLabel is a Swing-compatible component.  This means you also need to have swingall.jar (or equivalent) installed somewhere in your classpath.  See the Sun Java memo on testing whether you have Swing installed and how to install it if necessary and installation information available in the Swing Connection area at the Sun Java site.  Sun specifies that Swing requires JDK 1.1.2 or later, with JDK 1.1.5 or later preferred.  JMultiLineLabel uses javax.swing. package naming, so JMultiLineLabel does not work with JDK 1.2beta3, JDK 1.2beta4, Swing 1.0.1, or Swing 1.0.2, but will work with Swing 1.1beta3 and the final versions of Swing 1.1 and JDK 1.2 (see discussion in Sample Program section and below).

To use JMultiLineLabel as a JavaBean, copy JMultiLineLabel.jar into the jar folder appropriate for your visual application builder:
        for the JavaSoft BDK BeanBox: \bdk\jars
        for the IBM WebRunner BeanTester: \webrunner\BeanTools\beantester\beans
        for Symantec Visual Cafe: can place the .jar anywhere (use "Insert: Component to Library..." command, then add to desired palette)
        for Borland JBuilder: can place the .jar anywhere (right click on component palette, select "Properties", then use "Add from Archive")

FYI, the JMultiLineLabel class files in com\wildcrest\jmultilinelabel are identical to the corresponding class files in the JMultiLineLabel.jar archive.
 

Compatibility and known problems

JMultiLineLabel 1.0 was developed under JDK 1.1.7A and Swing 1.1 on Windows 95.  Compatibility has been tested on different platforms as follows:

Windows:

JMultiLineLabel 1.0 has been tested successfully on Windows with:

• JDK 1.1.5 with Swing 1.1final on Windows 95
• JDK 1.1.6 with Swing 1.1final on Windows 95
• JDK 1.1.7A with Swing 1.1final on Windows 95
• JDK 1.2final on Windows 95
• JDK 1.1.6 with Swing 1.1beta3 on Windows NT
• JDK 1.1.7B with Swing 1.1beta3 on Windows NT
• Netscape Communicator 4.06 (JDK1.1.4, Swing 1.1beta3) on Windows 95 (Swing can initially take a minute or two to load)
• Microsoft Internet Explorer 4.0 (Microsoft VM, Swing 1.1beta3) on Windows 95

• JDK 1.2beta3, JDK 1.2beta4, Swing 1.0.1, or Swing 1.0.2 since Sun used different Swing package names in those releases.

Macintosh:

As of the date of this release, Swing has not yet been released for the Macintosh, therefore JMultiLineLabel has not been tested on this platform..
 

Solaris:

JMultiLineLabel 1.0 has been tested successfully on Solaris using:

• JDK 1.1.7B with Swing 1.1beta3 on Solaris

Please report any difficulties with JMultiLineLabel on your configurations by email to products@wildcrest.com.  Be sure to include what Java release, OS, and development environment or bean tools you are using.  Efforts will be made to fix problems in JMultiLineLabel, but certain problems may not be possible for it to detect and/or correct.