From ca0d6ea6f707f40d203f043d694dbd405076dc75 Mon Sep 17 00:00:00 2001
From: Yuri Nesterenko
Date: Mon, 14 Oct 2013 11:47:27 +0400
Subject: [PATCH] 8025824: [cleanup] Fix tidy errors and warnings in
preformatted HTML files related to 2d/awt/swing
Reviewed-by: anthony, alexsch
---
.../classes/com/apple/eawt/event/package.html | 2 +
.../classes/com/apple/eawt/package.html | 2 +
.../share/classes/java/awt/color/package.html | 1 +
.../java/awt/datatransfer/package.html | 1 +
.../share/classes/java/awt/dnd/package.html | 15 ++--
.../java/awt/doc-files/AWTThreadIssues.html | 12 ++-
.../java/awt/doc-files/DesktopProperties.html | 38 +++++----
.../classes/java/awt/doc-files/FocusSpec.html | 20 ++---
.../classes/java/awt/doc-files/Modality.html | 79 +++++++++----------
.../share/classes/java/awt/event/package.html | 1 +
.../share/classes/java/awt/font/package.html | 1 +
.../share/classes/java/awt/geom/package.html | 1 +
.../share/classes/java/awt/image/package.html | 1 +
.../java/awt/image/renderable/package.html | 1 +
jdk/src/share/classes/java/awt/package.html | 3 +-
.../share/classes/java/awt/print/package.html | 1 +
.../javax/print/attribute/package.html | 13 ++-
.../print/attribute/standard/package.html | 3 +-
.../classes/javax/print/event/package.html | 3 +-
.../share/classes/javax/print/package.html | 8 +-
.../classes/javax/swing/border/package.html | 2 +-
.../javax/swing/colorchooser/package.html | 1 +
.../classes/javax/swing/event/package.html | 2 +-
.../javax/swing/filechooser/package.html | 2 +-
.../javax/swing/plaf/basic/package.html | 2 +-
.../javax/swing/plaf/metal/package.html | 2 +-
.../swing/plaf/multi/doc-files/multi_tsc.html | 61 ++++++--------
.../javax/swing/plaf/multi/package.html | 2 +-
.../plaf/nimbus/doc-files/properties.html | 2 +
.../javax/swing/plaf/nimbus/package.html | 10 +--
.../classes/javax/swing/plaf/package.html | 2 +-
.../plaf/synth/doc-files/synthFileFormat.html | 10 +--
.../javax/swing/plaf/synth/package.html | 1 +
.../classes/javax/swing/table/package.html | 2 +-
.../javax/swing/text/html/package.html | 2 +-
.../javax/swing/text/html/parser/package.html | 2 +-
.../classes/javax/swing/text/package.html | 2 +-
.../classes/javax/swing/text/rtf/package.html | 2 +-
.../classes/javax/swing/tree/package.html | 2 +-
.../classes/javax/swing/undo/package.html | 2 +-
40 files changed, 161 insertions(+), 158 deletions(-)
diff --git a/jdk/src/macosx/classes/com/apple/eawt/event/package.html b/jdk/src/macosx/classes/com/apple/eawt/event/package.html
index 9c05d88c821..0946e60f309 100644
--- a/jdk/src/macosx/classes/com/apple/eawt/event/package.html
+++ b/jdk/src/macosx/classes/com/apple/eawt/event/package.html
@@ -1,5 +1,7 @@
+
+
Classes for receiving gesture events.
diff --git a/jdk/src/macosx/classes/com/apple/eawt/package.html b/jdk/src/macosx/classes/com/apple/eawt/package.html
index e11ed40ba3f..81bc1a8d3f8 100644
--- a/jdk/src/macosx/classes/com/apple/eawt/package.html
+++ b/jdk/src/macosx/classes/com/apple/eawt/package.html
@@ -1,5 +1,7 @@
+
+
Provides classes for integrating Java applications with the native application environment.
diff --git a/jdk/src/share/classes/java/awt/color/package.html b/jdk/src/share/classes/java/awt/color/package.html
index 8b82f8e59eb..13ab17419a3 100644
--- a/jdk/src/share/classes/java/awt/color/package.html
+++ b/jdk/src/share/classes/java/awt/color/package.html
@@ -25,6 +25,7 @@
+
Provides classes for color spaces. It contains an
diff --git a/jdk/src/share/classes/java/awt/datatransfer/package.html b/jdk/src/share/classes/java/awt/datatransfer/package.html
index a16e0090889..f33946cac58 100644
--- a/jdk/src/share/classes/java/awt/datatransfer/package.html
+++ b/jdk/src/share/classes/java/awt/datatransfer/package.html
@@ -25,6 +25,7 @@
+
Provides interfaces and classes for transferring data
diff --git a/jdk/src/share/classes/java/awt/dnd/package.html b/jdk/src/share/classes/java/awt/dnd/package.html
index b39c069b0c5..f2df34617bd 100644
--- a/jdk/src/share/classes/java/awt/dnd/package.html
+++ b/jdk/src/share/classes/java/awt/dnd/package.html
@@ -25,6 +25,7 @@
+
Drag and Drop is a direct manipulation gesture found in many Graphical
@@ -51,18 +52,18 @@ states (not entirely sequentially):
associated with some presentation
element (Component) in the GUI, to initiate a Drag and Drop of
some potentially Transferable data.
-
+
1 or more DropTarget(s) come into/go out of
existence, associated
with presentation elements in the GUI (Components), potentially
capable of consuming Transferable data types.
-
+
A DragGestureRecognizer is
obtained from the DragSource and is
associated with a Component in order
to track and identify any Drag
initiating gesture by the user over the Component.
-
+
A user makes a Drag gesture over the Component,
which the registered
DragGestureRecognizer detects, and notifies its
@@ -76,13 +77,13 @@ contains the abstract class MouseDragGestureRecognizer for
recognizing mouse device gestures. Other abstract subclasses may be
provided by the platform to support other input devices or
particular Component class semantics.
-
+
The DragGestureListener causes the
DragSource to initiate the Drag
and Drop operation on behalf of the user, perhaps animating the
GUI Cursor and/or rendering an Image of the item(s) that are the
subject of the operation.
-
+
As the user gestures navigate over Component(s)
in the GUI with
associated DropTarget(s), the DragSource
@@ -111,11 +112,11 @@ as follows:
By the transfer "operation" selected by the user, and supported by
both the DragSource and DropTarget: Copy, Move or Reference(link).
-
+
By the intersection of the set of data types provided by the
DragSource and the set of data types comprehensible by the
DropTarget.
-
+
When the user terminates the drag operation, normally resulting in a
successful Drop, both the DragSource and DropTarget
receive
diff --git a/jdk/src/share/classes/java/awt/doc-files/AWTThreadIssues.html b/jdk/src/share/classes/java/awt/doc-files/AWTThreadIssues.html
index 735cfdd97d6..93d185181fe 100644
--- a/jdk/src/share/classes/java/awt/doc-files/AWTThreadIssues.html
+++ b/jdk/src/share/classes/java/awt/doc-files/AWTThreadIssues.html
@@ -23,7 +23,11 @@
questions.
-->
+
+
+
+
AWT Threading Issues
@@ -81,13 +85,13 @@ this machinery are as follows:
dispatched:
Sequentially.
-
That is, it is not permitted that several events from
- this queue are dispatched simultaneously.
+
That is, it is not permitted that several events from
+ this queue are dispatched simultaneously.
In the same order as they are enqueued.
-
That is, if AWTEvent A is enqueued
+
That is, if AWTEvent A is enqueued
to the EventQueue before
AWTEvent B then event B will not be
- dispatched before event A.
+ dispatched before event A.
There is at least one alive non-daemon thread while there is at
least one displayable AWT or Swing component within the
diff --git a/jdk/src/share/classes/java/awt/doc-files/DesktopProperties.html b/jdk/src/share/classes/java/awt/doc-files/DesktopProperties.html
index ff9b144951c..8a3923c0f40 100644
--- a/jdk/src/share/classes/java/awt/doc-files/DesktopProperties.html
+++ b/jdk/src/share/classes/java/awt/doc-files/DesktopProperties.html
@@ -23,7 +23,11 @@
questions.
-->
+
+
+
+
AWT Desktop Properties
@@ -51,8 +55,8 @@ unavailable for any reason, the implementation will return
The following table summarizes the desktop properties documented
here, and their value types.
-
@@ -84,14 +88,14 @@ This is particularly important when creating
Swing components which
are required to appear consistent with native desktop components or other
Swing components.
-
+
Basic Usage
The standard desktop property named
"awt.font.desktophints"
can be used to obtain the rendering hints that best match the desktop settings.
The return value is a
- Map of
+ Map of
RenderingHints which
can be directly applied to a Graphics2D.
@@ -105,7 +109,7 @@ if (map != null) {
}
Advanced Usage Tips
-
+
Listening for changes
An application can listen for changes in the property
@@ -161,7 +165,7 @@ RenderingHints getRenderingHints(Graphics2D g2d,
if (hintsToSave.size() == 0) {
return savedHints;
}
- /* RenderingHints.keySet() returns Set
Definitions
+
Definitions
Document - a window without an owner that, together with
all its child hierarchy, may be operated on as a single self-contained
document.
- Every window belongs to some document its root can be found as
+ Every window belongs to some document — its root can be found as
the closest ancestor window without an owner.
@@ -73,7 +73,7 @@
Warning! Some window managers allow users to change the window
- Z-order in an arbitrary way in that case the last requirement
+ Z-order in an arbitrary way — in that case the last requirement
may not be met.
@@ -92,12 +92,12 @@
Note: Everywhere in this document the notion of "window" is equal
- to a top-level window in the Java programming language in other words
+ to a top-level window in the Java programming language — in other words
an instance of java.awt.Window or any descendant class.
-
Modality types
+
Modality types
There are four supported modality types :
@@ -163,11 +163,11 @@
-
Show/hide blocking
+
Show/hide blocking
Showing the window or modeless dialog: "F"
- All the visible modal dialogs are looked through if F is from the SB
+ All the visible modal dialogs are looked through — if F is from the SB
of one of them, it becomes blocked by it. If there are several such
dialogs, the first shown is used. If no such dialogs exist, F remains
unblocked.
@@ -185,7 +185,7 @@
dialogs outside M's SB and modal dialogs outside M's SB that do not
block M).
-
+
After the modal dialog M is shown, it becomes blocked by the first shown
dialog from the first group (if there are any), all the windows from the
second one become blocked by M, and all the windows from the third group
@@ -197,12 +197,12 @@
Showing the document-modal dialog: "M"
All the visible application- and toolkit-modal dialogs are looked
- through if M is from the SB of one of them,
+ through — if M is from the SB of one of them,
it becomes blocked by it. If there are several such dialogs,
the first shown is used. If no such dialogs exist, M remains unblocked.
Showing the application-modal dialog: "M"
- All the visible toolkit-modal dialogs are looked through
+ All the visible toolkit-modal dialogs are looked through —
if M is from the SB of one of them, it becomes blocked by it.
If there are several such dialogs, the first shown is used.
If no such dialogs exist, M remains unblocked.
@@ -212,7 +212,7 @@
-
+
The Standard Blocking Matrix
current/shown
@@ -293,11 +293,10 @@
Implementation note: Changing the modal exclusion type for a visible window
may have no effect until it is hidden and then shown again.
-
-
-
Minimizing, maximizing and closing blocked windows
When a modal dialog blocks a window, the user may not be able to maximize or
- minimize the blocked window however, the actual behavior is unspecified
+ minimize the blocked window— however, the actual behavior is unspecified
and platform-dependent. In any case, the user can't close the blocked window
- interactively but it can be closed programmatically by calling the
+ interactively— but it can be closed programmatically by calling the
setVisible(false) or dispose() methods on the blocked
window.
Blocked windows activations
When the user selects a blocked window, it may be brought to the front, along
- with the blocking modal dialog which would then become the active window
+ with the blocking modal dialog which would then become the active window—
however, the actual behavior is unspecified and platform-dependent.
@@ -339,9 +338,9 @@
If the modal dialog to be hidden does not have focus, the active window remains
unchanged.
-
+
-
Security
+
Security
A special AWTPermission, "toolkitModality",
@@ -386,35 +385,35 @@
Examples
-
+
-
+
Frame "F" is shown
Document-modal dialog "Di" is shown
-
F becomes blocked by Di it's in the same document
+
F becomes blocked by Di — it's in the same document
Document-modal dialog "Dii" is shown
-
Di becomes blocked by Dii it's in the
+
Di becomes blocked by Dii — it's in the
same document
-
+
-
+
Frame "F" is shown
Document-modal dialog "Di" is shown
-
F becomes blocked by Di it's in the same document
+
F becomes blocked by Di — it's in the same document
Document-modal dialog "Dii" is shown
-
Di becomes blocked by Dii
+
Di becomes blocked by Dii —
it's in the same document
Di is hidden
-
F becomes blocked by Dii it's in the same document
+
F becomes blocked by Dii — it's in the same document
@@ -424,45 +423,45 @@
-
+
Frame "F" is shown
Toolkit-modal dialog "Di" is created, but not shown
Document-modal dialog "Dii" is shown
-
F becomes blocked by Dii it's in the same document
+
F becomes blocked by Dii — it's in the same document
Application-modal dialog "Diii" is shown
-
Dii becomes blocked by Diii
+
Dii becomes blocked by Diii —
it's in the same application
Di is shown
-
Di becomes blocked by Dii it's its owner
-
Diii remains unblocked it blocks Dii and
+
Di becomes blocked by Dii — it's its owner
+
Diii remains unblocked — it blocks Dii and
Dii blocks Di
-
+
-
+
Frame "F" is shown
Toolkit-modal dialog "Di" is created, but not shown
Document-modal dialog "Dii" is shown
-
F becomes blocked by Dii it's in the same document
+
F becomes blocked by Dii — it's in the same document
Application-modal dialog "Diii" is shown
-
Dii becomes blocked by Diii it's in the
+
Dii becomes blocked by Diii — it's in the
same application
Di is shown
-
Diii becomes blocked by Di Di
+
Diii becomes blocked by Di — Di
is not blocked
Di remains unblocked
-
+
diff --git a/jdk/src/share/classes/java/awt/event/package.html b/jdk/src/share/classes/java/awt/event/package.html
index edf84c11476..eec07cacd6c 100644
--- a/jdk/src/share/classes/java/awt/event/package.html
+++ b/jdk/src/share/classes/java/awt/event/package.html
@@ -25,6 +25,7 @@
+
Provides interfaces and classes for dealing with different
diff --git a/jdk/src/share/classes/java/awt/font/package.html b/jdk/src/share/classes/java/awt/font/package.html
index ec5d783e708..d4d0a0a998d 100644
--- a/jdk/src/share/classes/java/awt/font/package.html
+++ b/jdk/src/share/classes/java/awt/font/package.html
@@ -25,6 +25,7 @@
+
Provides classes and interface relating to fonts. It
diff --git a/jdk/src/share/classes/java/awt/geom/package.html b/jdk/src/share/classes/java/awt/geom/package.html
index e0ff8681e04..4b18dee4c5f 100644
--- a/jdk/src/share/classes/java/awt/geom/package.html
+++ b/jdk/src/share/classes/java/awt/geom/package.html
@@ -25,6 +25,7 @@
+
Provides the Java 2D classes for defining and performing operations
diff --git a/jdk/src/share/classes/java/awt/image/package.html b/jdk/src/share/classes/java/awt/image/package.html
index 9ef6e7f419b..c2f4c69d5c5 100644
--- a/jdk/src/share/classes/java/awt/image/package.html
+++ b/jdk/src/share/classes/java/awt/image/package.html
@@ -25,6 +25,7 @@
+
Provides classes for creating and modifying images.
diff --git a/jdk/src/share/classes/java/awt/image/renderable/package.html b/jdk/src/share/classes/java/awt/image/renderable/package.html
index 3bcff3c39ab..58a9694269f 100644
--- a/jdk/src/share/classes/java/awt/image/renderable/package.html
+++ b/jdk/src/share/classes/java/awt/image/renderable/package.html
@@ -25,6 +25,7 @@
+
Provides classes and interfaces for producing
diff --git a/jdk/src/share/classes/java/awt/package.html b/jdk/src/share/classes/java/awt/package.html
index 184ca072c9a..1b6527e45b6 100644
--- a/jdk/src/share/classes/java/awt/package.html
+++ b/jdk/src/share/classes/java/awt/package.html
@@ -25,6 +25,7 @@
+
Contains all of the classes for creating user
@@ -53,7 +54,7 @@ If the bounds of a Component object exceed a platform limit,
there is no way to properly arrange them within a Container object.
The object's bounds are defined by any object's coordinate
in combination with its size on a respective axis.
-
+
Additional Specification
diff --git a/jdk/src/share/classes/java/awt/print/package.html b/jdk/src/share/classes/java/awt/print/package.html
index ddbecd2ee54..c04f6f9e33b 100644
--- a/jdk/src/share/classes/java/awt/print/package.html
+++ b/jdk/src/share/classes/java/awt/print/package.html
@@ -25,6 +25,7 @@
+
Provides classes and interfaces for a general printing API. The
diff --git a/jdk/src/share/classes/javax/print/attribute/package.html b/jdk/src/share/classes/javax/print/attribute/package.html
index 7c848c5b296..661cbc2becd 100644
--- a/jdk/src/share/classes/javax/print/attribute/package.html
+++ b/jdk/src/share/classes/javax/print/attribute/package.html
@@ -1,3 +1,4 @@
+
javax.print.attribute package
@@ -30,7 +31,6 @@ questions.
Provides classes and interfaces
that describe the types of JavaTM Print
Service attributes and how they can be collected into attribute sets.
-
What is an Attribute?
When setting up a print job,
a client specifies two things:
@@ -71,7 +71,6 @@ of the results of a print job. The print job determines the manner in
which it achieves the results specified by the processing instructions.
Representing processing instructions as descriptive items
provides more flexibility for implementing print jobs.
-
Attribute Categories and Values
Each printer has a set of capabilities, such as the ability to print on
different paper sizes or the ability to print more than one copy. Each of
@@ -222,7 +221,6 @@ one concrete implementation of each of the attribute set subinterfaces:
All of these classes extend HashAttributeSet
and enforce the restriction that the attribute set is only allowed to contain
the corresponding kind of attribute.
-
Attribute Class Design
An attribute value is a small, atomic data item,
such as an integer or an enumerated value. The Java Print Service API
@@ -299,8 +297,8 @@ certain contexts also implements one or more subinterfaces of
Attribute. Most attribute classes also extend the appropriate
abstract syntax class to get the implementation. Consider the
Sides attribute class:
-
+
public class Sides
extends EnumSyntax
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
@@ -311,8 +309,8 @@ public class Sides
}
...
}
-
+
Since every attribute class implements Attribute, every attribute
class must provide an implementation for the
@@ -363,9 +361,8 @@ because print-request attributes are the types of attributes that
client usually specifies. This example demonstrates creating an attribute
set of print-request attributes and locating a printer that can
print the document according to the specified attributes:
-
Please note: In the javax.print APIs, a null reference parameter to methods
is incorrect unless explicitly documented on the method as having a meaningful
diff --git a/jdk/src/share/classes/javax/print/attribute/standard/package.html b/jdk/src/share/classes/javax/print/attribute/standard/package.html
index b71b72b79bb..540f8ede65a 100644
--- a/jdk/src/share/classes/javax/print/attribute/standard/package.html
+++ b/jdk/src/share/classes/javax/print/attribute/standard/package.html
@@ -1,3 +1,4 @@
+
javax.print.attribute.standard package
@@ -199,7 +200,6 @@ never appear in attribute sets,
so there is no restricted
AttributeSet
subinterface for them.
-
Attribute Table
The table below lists all the printing attributes.
@@ -213,7 +213,6 @@ the column marked "SupportedValuesAttribute"
lists the supported-values attribute class, if any,
with which a print service
indicates the supported values for that attribute category.
-
They may be used to monitor both print services (such as printers going
-on-line & off-line), and the progress of a specific print job.
+on-line & off-line), and the progress of a specific print job.
Please note: In the javax.print APIs, a null reference parameter to methods
is incorrect unless explicitly documented on the method as having a meaningful
diff --git a/jdk/src/share/classes/javax/print/package.html b/jdk/src/share/classes/javax/print/package.html
index df8c04573c6..942e554199c 100644
--- a/jdk/src/share/classes/javax/print/package.html
+++ b/jdk/src/share/classes/javax/print/package.html
@@ -1,3 +1,4 @@
+
javax.print package
@@ -52,7 +53,7 @@ such as IPP printers or JINI printers, a print-service provider can write
implementations of PrintServiceLookup. The print-service provider
can dynamically install these PrintServiceLookup implementations
using the
-
+
SPI JAR file specification.
Attribute Definitions
@@ -105,9 +106,8 @@ Service API: locating printers that can print five double-sided copies
of a Postscript document on size A4 paper, creating a print job from
one of the returned print services, and calling print.
-
Please note: In the javax.print APIs, a null reference parameter to methods
is incorrect unless explicitly documented on the method as having a meaningful
diff --git a/jdk/src/share/classes/javax/swing/border/package.html b/jdk/src/share/classes/javax/swing/border/package.html
index 9bd379bd992..c11b6747eab 100644
--- a/jdk/src/share/classes/javax/swing/border/package.html
+++ b/jdk/src/share/classes/javax/swing/border/package.html
@@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
-
+
diff --git a/jdk/src/share/classes/javax/swing/colorchooser/package.html b/jdk/src/share/classes/javax/swing/colorchooser/package.html
index d64ba91b64b..bf405aa45c1 100644
--- a/jdk/src/share/classes/javax/swing/colorchooser/package.html
+++ b/jdk/src/share/classes/javax/swing/colorchooser/package.html
@@ -25,6 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
+
diff --git a/jdk/src/share/classes/javax/swing/event/package.html b/jdk/src/share/classes/javax/swing/event/package.html
index 5a90113561d..c1fab2cfd12 100644
--- a/jdk/src/share/classes/javax/swing/event/package.html
+++ b/jdk/src/share/classes/javax/swing/event/package.html
@@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
-
+
diff --git a/jdk/src/share/classes/javax/swing/filechooser/package.html b/jdk/src/share/classes/javax/swing/filechooser/package.html
index 58048bab801..6303e9fd35f 100644
--- a/jdk/src/share/classes/javax/swing/filechooser/package.html
+++ b/jdk/src/share/classes/javax/swing/filechooser/package.html
@@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
-
+
diff --git a/jdk/src/share/classes/javax/swing/plaf/basic/package.html b/jdk/src/share/classes/javax/swing/plaf/basic/package.html
index f48ba91ad76..d453d348595 100644
--- a/jdk/src/share/classes/javax/swing/plaf/basic/package.html
+++ b/jdk/src/share/classes/javax/swing/plaf/basic/package.html
@@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
-
+
diff --git a/jdk/src/share/classes/javax/swing/plaf/metal/package.html b/jdk/src/share/classes/javax/swing/plaf/metal/package.html
index e60da42ed46..146cbbbc79b 100644
--- a/jdk/src/share/classes/javax/swing/plaf/metal/package.html
+++ b/jdk/src/share/classes/javax/swing/plaf/metal/package.html
@@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
-
+
diff --git a/jdk/src/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html b/jdk/src/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html
index 5160494f750..3ae0bf2c6c0 100644
--- a/jdk/src/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html
+++ b/jdk/src/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html
@@ -14,14 +14,14 @@ Using the Multiplexing Look and Feel
-
+
This document is based on an article
originally published in
The Swing
Connection.
-
+
@@ -43,7 +43,6 @@ the Java or Windows look and feel, for example --
and requires no modifications to work with auxiliary look and feels.
-
This document has the following sections:
@@ -76,14 +75,12 @@ a Swing Connection article.
It's easy to use auxiliary look and feels with Swing. To instruct
@@ -204,14 +199,12 @@ of the UIs obtained from the default and auxiliary look and feels.
An auxiliary look and feel is like any other look and feel,
@@ -252,7 +245,6 @@ the javax.swing.plaf package.
Dos and Don'ts
-
The following paragraphs provide some general recommendations for developing
@@ -264,22 +256,19 @@ auxiliary look and feels.
to perform all initialization,
and the uninstallUI method
to perform all cleanup.
-
-
-
+
The installUI and uninstallUI
methods are invoked when a component's look and feel is set.
The installUI method gives the new UI object
a chance to add listeners on the component and its data model.
Similarly, the uninstallUI method
lets the previous UI object remove its listeners.
-
-
+
Don't extend
visual look and feels.
-
-
We recommended that you don't implement
+
+ We recommended that you don't implement
UI classes of an auxiliary look and feel as subclasses of the
UI classes of a visual look and feel. Why not? Because they might
accidentally inherit code that installs listeners on a component
@@ -290,13 +279,13 @@ lets the previous UI object remove its listeners.
Instead, we recommend that the UI classes of an auxiliary look
and feel directly extend the abstract UI classes in the javax.swing.plaf
package. By using this strategy, the developer of an auxiliary
- look and feel can avoid competing with the default look and feel.
-
+ look and feel can avoid competing with the default look and feel.
+
Override all UI-specific methods
your UI classes inherit.
-
-
We recommend that each UI class of
+
+ We recommend that each UI class of
an auxiliary look and feel override the methods
defined in the javax.swing.plaf
UI classes it descends from
@@ -309,15 +298,14 @@ lets the previous UI object remove its listeners.
if the
component is opaque. If a UI class from a non-visual auxiliary
look and feel does not override this method, all
- opaque components appear as blank areas on the screen!
-
+ opaque components appear as blank areas on the screen!
+
In many cases, you
might want an auxiliary look and feel to be "incomplete." That
@@ -379,7 +367,6 @@ In the preceding example, an auxiliary look and feel named MyAuxExamining Other UI Objects
-
In
rare instances, a UI object from an auxiliary look and feel
@@ -395,12 +382,10 @@ In the preceding example, an auxiliary look and feel named MyAux
-
How the Multiplexing Look and Feel
Is Implemented
-
The Multiplexing look and feel
@@ -437,8 +422,8 @@ all developers and users.
and feel is always the first to be created. After that, a UI object
is created from each auxiliary look and feel in the order
they are specified in the swing.auxiliarylaf
- property.
-
+ property.
+
When a method that requests information
from a UI object is invoked, the multiplexing UI object
invokes the method on all the UI objects, but returns
@@ -450,8 +435,8 @@ all developers and users.
The getPreferredSize method
is also invoked on the UI object for each auxiliary look and feel,
but the return values are ignored.
-
-
+
+
When a method that does not request information
from the UI object is invoked, the multiplexing UI object
invokes that method on all UIs --
@@ -474,14 +459,12 @@ all developers and users.
-
How to Provide a Custom Multiplexing Look
and Feel
-
-
While
+
While
we hope the behavior of the Multiplexing look and feel is
flexible enough not to require an alternative multiplexing look
and feel, Swing allows the user to specify another multiplexing look
diff --git a/jdk/src/share/classes/javax/swing/plaf/multi/package.html b/jdk/src/share/classes/javax/swing/plaf/multi/package.html
index 31b212bfbdb..94e73080e3d 100644
--- a/jdk/src/share/classes/javax/swing/plaf/multi/package.html
+++ b/jdk/src/share/classes/javax/swing/plaf/multi/package.html
@@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
-
+
diff --git a/jdk/src/share/classes/javax/swing/plaf/nimbus/package.html b/jdk/src/share/classes/javax/swing/plaf/nimbus/package.html
index 338df175b51..5a60f7a7885 100644
--- a/jdk/src/share/classes/javax/swing/plaf/nimbus/package.html
+++ b/jdk/src/share/classes/javax/swing/plaf/nimbus/package.html
@@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
-
+
@@ -39,11 +39,11 @@ component states.
Nimbus allows customizing many of its properties, including painters, by
altering the {@link javax.swing.UIDefaults} table. Here's an example:
-
Per-component customization is also possible. When rendering a component,
Nimbus checks its client property named "Nimbus.Overrides". The value of this
@@ -53,14 +53,14 @@ only. An optional client property, "Nimbus.Overrides.InheritDefaults" of type
Boolean, specifies whether the overriding settings should be merged with
default ones ({@code true}), or replace them ({@code false}). By default they
are merged:
-
+
JProgressBar bar = new JProgressBar();
UIDefaults overrides = new UIDefaults();
overrides.put("ProgressBar.cycleTime", 330);
...
bar.putClientProperty("Nimbus.Overrides", overrides);
bar.putClientProperty("Nimbus.Overrides.InheritDefaults", false);
-
+
Colors in Nimbus are derived from a core set of
primary colors. There are also
diff --git a/jdk/src/share/classes/javax/swing/plaf/package.html b/jdk/src/share/classes/javax/swing/plaf/package.html
index fdd354d8c0a..4e1745e4457 100644
--- a/jdk/src/share/classes/javax/swing/plaf/package.html
+++ b/jdk/src/share/classes/javax/swing/plaf/package.html
@@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
-
+
diff --git a/jdk/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html b/jdk/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html
index dfb99f4ef50..ad84defba08 100644
--- a/jdk/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html
+++ b/jdk/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html
@@ -2,7 +2,7 @@
Synth File Format
-