src/demo/share/jfc/Metalworks/README.txt
author mgronlun
Sun, 22 Sep 2019 15:38:32 +0200
branchJEP-349-branch
changeset 58258 48aabad45dac
parent 47216 71c04702a3d5
permissions -rw-r--r--
instantiated super klasses
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     1
About Metalworks
90ce3da70b43 Initial load
duke
parents:
diff changeset
     2
================
90ce3da70b43 Initial load
duke
parents:
diff changeset
     3
Metalworks is a simple Swing-based simulated e-mail
90ce3da70b43 Initial load
duke
parents:
diff changeset
     4
application.  It shows off several features of Swing, including
90ce3da70b43 Initial load
duke
parents:
diff changeset
     5
JInternalFrame, JTabbedPane, JFileChooser, JEditorPane, and
90ce3da70b43 Initial load
duke
parents:
diff changeset
     6
JRadioButtonMenuItem.  Metalworks is optimized to work with the
90ce3da70b43 Initial load
duke
parents:
diff changeset
     7
Java look and feel (codenamed "Metal") and shows use of several
90ce3da70b43 Initial load
duke
parents:
diff changeset
     8
features, such as themes, that are specific to the Java look and
90ce3da70b43 Initial load
duke
parents:
diff changeset
     9
feel.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    10
90ce3da70b43 Initial load
duke
parents:
diff changeset
    11
90ce3da70b43 Initial load
duke
parents:
diff changeset
    12
Running Metalworks
90ce3da70b43 Initial load
duke
parents:
diff changeset
    13
==================
90ce3da70b43 Initial load
duke
parents:
diff changeset
    14
90ce3da70b43 Initial load
duke
parents:
diff changeset
    15
To run the Metalworks demo:
90ce3da70b43 Initial load
duke
parents:
diff changeset
    16
90ce3da70b43 Initial load
duke
parents:
diff changeset
    17
  java -jar Metalworks.jar
90ce3da70b43 Initial load
duke
parents:
diff changeset
    18
90ce3da70b43 Initial load
duke
parents:
diff changeset
    19
These instructions assume that this installation's version of the java
90ce3da70b43 Initial load
duke
parents:
diff changeset
    20
command is in your path.  If it isn't, then you should either
90ce3da70b43 Initial load
duke
parents:
diff changeset
    21
specify the complete path to the java command or update your
90ce3da70b43 Initial load
duke
parents:
diff changeset
    22
PATH environment variable as described in the installation
90ce3da70b43 Initial load
duke
parents:
diff changeset
    23
instructions for the Java(TM) SE Development Kit.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    24
90ce3da70b43 Initial load
duke
parents:
diff changeset
    25
90ce3da70b43 Initial load
duke
parents:
diff changeset
    26
Metalworks Features
90ce3da70b43 Initial load
duke
parents:
diff changeset
    27
===================
90ce3da70b43 Initial load
duke
parents:
diff changeset
    28
The functionality of the Metalworks demo is minimal, and many
90ce3da70b43 Initial load
duke
parents:
diff changeset
    29
controls are non-functional.  They are intended only to show how
90ce3da70b43 Initial load
duke
parents:
diff changeset
    30
to construct the UI for such interfaces.  Things that do work in
90ce3da70b43 Initial load
duke
parents:
diff changeset
    31
the Metalworks demo include:
90ce3da70b43 Initial load
duke
parents:
diff changeset
    32
90ce3da70b43 Initial load
duke
parents:
diff changeset
    33
1. Choosing New from the File menu displays an e-mail
90ce3da70b43 Initial load
duke
parents:
diff changeset
    34
   composition window.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    35
90ce3da70b43 Initial load
duke
parents:
diff changeset
    36
2. Choosing Open from the File menu brings up the file chooser.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    37
90ce3da70b43 Initial load
duke
parents:
diff changeset
    38
3. Choosing Preferences from the Edit menu will bring up a
90ce3da70b43 Initial load
duke
parents:
diff changeset
    39
   dialog.  Most of this dialog is only for show.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    40
90ce3da70b43 Initial load
duke
parents:
diff changeset
    41
4. Choosing About Metalworks from the Help menu brings up a
90ce3da70b43 Initial load
duke
parents:
diff changeset
    42
   JOptionPane with a brief description of the application.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    43
90ce3da70b43 Initial load
duke
parents:
diff changeset
    44
5. Choosing Open Help Window from the Help menu brings up an
90ce3da70b43 Initial load
duke
parents:
diff changeset
    45
   internal frame that displays a set of HTML files containing
90ce3da70b43 Initial load
duke
parents:
diff changeset
    46
   all sorts of useful info.  Look through these for tips about
90ce3da70b43 Initial load
duke
parents:
diff changeset
    47
   using Metal.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    48
90ce3da70b43 Initial load
duke
parents:
diff changeset
    49
6. The Theme menu allows you to change the color theme of the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    50
   application.  The default theme (Steel) and several other
90ce3da70b43 Initial load
duke
parents:
diff changeset
    51
   demo themes are included.  Note that the themes can control
90ce3da70b43 Initial load
duke
parents:
diff changeset
    52
   not only the colors, but also the sizes of many controls.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    53
   Also included with this demo is the PropertiesMetalTheme
90ce3da70b43 Initial load
duke
parents:
diff changeset
    54
   class, which allows you to read a theme's colors from a text
90ce3da70b43 Initial load
duke
parents:
diff changeset
    55
   file.  The Charcoal theme is an example of using this.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    56