JEditList 1.1
Sample Applet & Application
WILDCREST ASSOCIATES

[Main Page] [Sample Program] [User Manual] [Javadoc Documentation]
[Installation & Compatibility] [License & Contact Information]

This page tells you how to run JEditListTest, a program which demonstrates the capabilities of JEditList. JEditListTest may be run as either an applet or a stand-alone application. You can also click here to view the source code for JEditListTest.

Because JEditList is a Swing-based component, you must have Swing (JFC) installed on your system (i.e., swingall.jar must appear your classpath).

The 1.1 versions of JEditList and JEditListTest are built assuming the new Swing package names javax.swing.*.  These names are used in Swing 1.1beta3 and is the packaging for the final shipping versions of Swing 1.1 and JDK1.2.

JDK1.2beta4, Swing 1.0.1, and Swing 1.0.2 use the old package names com.sun.java.swing.*, and JEditList 1.1 will not work with these releases (use JEditList 1.0 instead).

JDK1.2beta3 used the names java.awt.swing.*, and no version of JEditList is available for that release.

Swing requires JDK 1.1.2 or later, with JDK 1.1.5 or later preferred.  Information on how to download (free) and install Swing is available at the Sun Java site.
 

Run JEditListTest application (recommended)

It is usually better to run JEditListTest as a stand-alone application, as there are certain limitations that arise when running it as an applet in most standard browser configurations (see below),   In particular, as an application it starts up fast and you will have all keyboard equivalents and full ability to cut, copy, and paste between JEditList components, or to and from the other Swing components or your browser or any other applications (be aware that regular text cut & paste does not work in JDK 1.1.7 on Win 95 due to a bug, so if you are using JDK 1.1.7 on Win 95, you will only be able to cut and paste between JEditList components.  The subsequent JDK 1.1.7A release fixes this problem.).

The JEditListTest applet displays two JEditLists, plus regular Swing JList, JTextArea, JTextField, and JComboBox components for comparison and for performing cut and paste operations.  Use the right mouse button (or equivalent) on your system to bring up the popup menu on either JEditList component, or use the keyboard equivalents.

An interesting demo is to copy and paste URLs from the second JEditList into the "Location" box of your favorite browser, then hit "Enter" to go to that web site.  Or you can copy and paste (or insert) the names of web sites you navigate to in your browser into the JEditList to save them as "bookmarks".  This demonstrates just one possible application of the JEditList component.

To run the JEditListTest application, download the JEditList distribution (.zip) file to your machine and unzip it.  Then make the main JEditList directory your current directory and in a command line window type:
    java JEditListTest
or on some systems you may need to use:
    java -classpath %classpath% JEditListTest
or on Windows you can simply double-click on:
        JEditListTest.bat
 

Run JEditListTest applet

Make sure your browser is set up for Swing (at the Sun Java site, there is a nice guide that will test if your browser is set up for Swing and what to do if not).  Then click here to run the JEditListTest applet in your browser.  Be patient!  Some browsers seem to take a minute or two to run Swing for the first time.

NOTE: Unless you have set up your browser specially, the security "sandbox" restrictions of standard browsers prevent unsigned applets from using cut, copy, and paste to or from the system clipboard.  As a result, cut, copy, paste, insert, and append operations will only work within and between the two JEditList components, but not with the other Java components or the browser or other applications.

In addition, when the applet page is larger than the browser window, some browsers will take over some of the default JEditList keyboard equivalents for their own use so that these keyboard equivalents may not function in JEditListTest.  If this occurs, use the popup menu.  In applets you ship, you will want to choose your keyboard equivalents so that they don't conflict with the keyboard equivalents used by the browsers, tools, or environments in which your applet is intended to run.



© Copyright 1998, Wildcrest Associates (http://www.wildcrest.com)