# ===========================================================================
#  Licensed Materials - Property of IBM
#  "Restricted Materials of IBM"
#
#  IBM SDK, Java(tm) Technology Edition, v5
#  (C) Copyright IBM Corp. 1998,2005. All Rights Reserved
#
#  US Government Users Restricted Rights - Use, duplication or disclosure
#  restricted by GSA ADP Schedule Contract with IBM Corp.
# ========================================================================

About Metalworks
================
Metalworks is a simple Swing-based simulated e-mail
application.  It shows off several features of Swing, including
JInternalFrame, JTabbedPane, JFileChooser, JEditorPane, and
JRadioButtonMenuItem.  Metalworks is optimized to work with the
Java look and feel (codenamed "Metal") and shows use of several
features, such as themes, that are specific to the Java look and
feel.


Running Metalworks
==================

To run the Metalworks demo:

  java -jar Metalworks.jar

These instructions assume that this installation's version of the java
command is in your path.  If it isn't, then you should either
specify the complete path to the java command or update your
PATH environment variable as described in the installation
instructions for the Java 2 SDK. CLASSPATH should also specify the
current directory in order to locate the ./resources subdirectory.


Metalworks Features
===================
The functionality of the Metalworks demo is minimal, and many
controls are non-functional.  They are intended only to show how
to construct the UI for such interfaces.  Things that do work in
the Metalworks demo include:

1. Choosing New from the File menu displays an e-mail
   composition window.

2. Choosing Open from the File menu brings up the file chooser.

3. Choosing Preferences from the Edit menu will bring up a
   dialog.  Most of this dialog is only for show.

4. Choosing About Metalworks from the Help menu brings up a
   JOptionPane with a brief description of the application.

5. Choosing Open Help Window from the Help menu brings up an
   internal frame that displays a set of HTML files containing
   all sorts of useful info.  Look through these for tips about
   using Metal.

6. The Theme menu allows you to change the color theme of the
   application.  The default theme (Steel) and several other
   demo themes are included.  Note that the themes can control
   not only the colors, but also the sizes of many controls.
   Also included with this demo is the PropertiesMetalTheme
   class, which allows you to read a theme's colors from a text
   file.  The Charcoal theme is an example of using this.

7. Selecting from the Drag menu allows you to change the dragging style of the 
   JInternalFrames( ie. email composition window, In-Box window & Help window).
