AWT Threading Issues

@@ -121,7 +121,7 @@ Prior to 1.4, the helper threads were never terminated.

Starting with 1.4, the behavior has changed as a result of the fix for - + 4030718. With the current implementation, AWT terminates all its helper threads allowing the application to exit cleanly when the following three conditions are true: @@ -154,11 +154,11 @@

Other packages can create displayable components for internal needs and never make them undisplayable. See - + 4515058, - + 4671025, and - + 4465537.
Both Microsoft Windows and X11 allow an application to send native events to windows that belong to another application. With this @@ -192,5 +192,6 @@ The Java™ Virtual Machine Specification guarantees that the JVM doesn't exit until this thread terminates. +

AWT Desktop Properties

The following refers to standard AWT desktop properties that @@ -274,5 +274,6 @@ This property should be used when there is no need in listening mouse events fired as a result of activity with extra mouse button. By default this property is set to {@code true}. +

The AWT Focus Subsystem

@@ -101,7 +102,7 @@ -

Overview of KeyboardFocusManager

The focus model is centralized around a single class, KeyboardFocusManager, that provides a set of APIs for client code to @@ -213,7 +214,7 @@ -

KeyboardFocusManager and Browser Contexts

Some browsers partition applets in different code bases into separate contexts, and establish walls between these contexts. Each thread and @@ -229,7 +230,7 @@ -

KeyEventDispatcher and KeyEventPostProcessor

While the user's KeyEvents should generally be delivered to the focus owner, there are rare cases where this is not desirable. An input @@ -272,7 +273,7 @@ that capacity. -

FocusEvent and WindowEvent

The AWT defines the following six event types central to the focus model in two different java.awt.event classes: @@ -296,7 +297,7 @@ -

Event Delivery

If the focus is not in java application and the user clicks on a focusable child Componenta of an inactive Frame b, the following events @@ -347,7 +348,7 @@ -

Opposite Components and Windows

Each event includes information about the "opposite" Component or Window involved in the focus or activation change. For example, for a @@ -371,7 +372,7 @@ top-level Window. -

Temporary FocusEvents

FOCUS_GAINED and FOCUS_LOST events are marked as either temporary or permanent. @@ -416,7 +417,7 @@ instead as a hook for lightweight Component libraries, such as Swing. -

Focus Traversal

Each Component defines its own Set of focus traversal keys for a given focus traversal operation. Components support separate Sets of keys @@ -491,7 +492,7 @@ -

FocusTraversalPolicy

A FocusTraversalPolicy defines the order in which Components within @@ -653,7 +654,7 @@ DefaultFocusTraversalPolicy by default. -

Focus Traversal Policy Providers

A Container that isn't a focus cycle root has an option to provide a FocusTraversalPolicy of its own. To do so, one needs to set Container's focus @@ -740,7 +741,7 @@ -

Programmatic Traversal

In addition to user-initiated focus traversal, client code can initiate a focus traversal operation programmatically. To client code, @@ -811,7 +812,7 @@ -

Focusability

A focusable Component can become the focus owner ("focusability") and participates in keyboard focus traversal ("focus traversability") with @@ -825,7 +826,7 @@ -

Focusable Windows

To support palette windows and input methods, client code can prevent a Window from becoming the focused Window. By transitivity, this @@ -877,7 +878,7 @@ focus owner will be cleared and the focused Window will remain unchanged. -

Requesting Focus

A Component can request that it become the focus owner by calling @@ -949,7 +950,7 @@ See Temporary FocusEvents -

Focus and PropertyChangeListener

Client code can listen to changes in context-wide focus state, or to changes in focus-related state in Components, via @@ -1020,7 +1021,7 @@ A Window is always a focus cycle root; this property cannot change.

Focus and VetoableChangeListener

The KeyboardFocusManager also supports VetoableChangeListeners for the following properties: @@ -1089,7 +1090,7 @@ -

Z-Order

On some native windowing systems, the Z-order of a Window can affect its focused or active (if applicable) state. On Microsoft Windows, the @@ -1169,7 +1170,7 @@ -

Replacing DefaultKeyboardFocusManager

KeyboardFocusManagers are pluggable at the browser context level. Client code can subclass KeyboardFocusManager or @@ -1325,7 +1326,7 @@ -

Incompatibilities with Previous Releases

Cross-platform changes:

The default focus traversability for all Components is now @@ -1361,6 +1362,6 @@ change requests in all cases. Previously, requests were granted for heavyweights, but denied for lightweights.

- +

The AWT Modality

@@ -50,7 +50,7 @@ -

Definitions

Document - a window without an owner that, together with @@ -92,7 +92,7 @@

Modality types

There are four supported modality types : @@ -156,7 +156,7 @@

Show/hide blocking

Showing the window or modeless dialog: "F"
@@ -261,7 +261,7 @@ are performed for each of them in the order they were initially shown. -

Modal exclusion

There are two modal exclusion types introduced as of JDK 6 @@ -287,7 +287,7 @@ -

Related AWT features

Always-On-Top
@@ -331,7 +331,7 @@ unchanged. -

Security

A special AWTPermission, "toolkitModality", @@ -344,7 +344,7 @@ blocked by a browser's or JWS's modal dialog. -

Platform support

Two java.awt.Toolkit methods allow you to check whether @@ -363,7 +363,7 @@ -

Compatibility

The default modality type is application-modal. It is used by the API @@ -374,7 +374,7 @@ applets and applications launched from Java Web Start. -

Examples

@@ -458,5 +458,5 @@

- +

BMP Metadata Format Specification

The XML schema for the native image metadata format is as follows: @@ -160,5 +161,5 @@ @since 1.5 - +

GIF Metadata Format Specification

GIF Stream Metadata Format Specification

@@ -434,6 +434,6 @@ "TRUE") - +

JPEG Metadata Format Specification and Usage Notes

@@ -1159,6 +1159,6 @@  ]> - +

PNG Metadata Format Specification

@@ -561,6 +561,6 @@  ]> - +

Standard (Plug-in Neutral) Metadata Format Specification

The plug-in neutral "javax_imageio_1.0" format consists @@ -394,6 +394,6 @@  ]> - +

TIFF Metadata Format Specification and Usage Notes

Reading Images @@ -69,24 +69,24 @@ Native Stream Metadata Format
Native Image Metadata Format -

Reading Images

TIFF images are read by an ImageReader which may be controlled by its public interface as well as via a supplied TIFFImageReadParam. - + -

Color Conversion

If the source image data have photometric type CIE L*a*b* or YCbCr, and the destination color space type is RGB, then the source image data will be automatically converted to RGB using an internal color converter.

Color Spaces

The raw color space assigned by default, i.e., in the absence of a user-supplied ImageTypeSpecifier, @@ -154,7 +154,7 @@ supplied to the reader and should be derived from a color space which is correct for the data in question.

ICC Profiles

If an ICC profile is contained in the image metadata ( @@ -196,7 +196,7 @@ more than one type, the first one will be based on the ICC profile and the second on the inferred color space.

Metadata Issues

By default all recognized fields in the TIFF image file directory (IFD) are loaded into the native image metadata object. Which fields are loaded may be @@ -226,8 +226,8 @@ object returned by the TIFF reader using the TIFFDirectory.createFromMetadata method.

-Mapping of TIFF Native Image Metadata to the Standard Metadata Format

+Mapping of TIFF Native Image Metadata to the Standard Metadata Format

The derivation of standard metadata format javax_imageio_1.0 @@ -349,12 +349,12 @@ -

Reading Exif Images

The TIFF reader may be used to read an uncompressed Exif image or the contents of the APP1 marker segment of a compressed Exif image. -

Reading Uncompressed Exif Images

An uncompressed Exif image is a one- or two-page uncompressed TIFF image with a specific ordering of its IFD and image data content. Each pixel @@ -386,7 +386,7 @@ stream and not as a thumbnail, i.e., tiffReader.hasThumbnails(0) will return false. -

Reading Compressed Exif Images

A compressed Exif image is a 3-band ISO/IEC 10918-1 baseline DCT JPEG stream with an inserted APP1 marker segment. The parameters of the marker @@ -453,7 +453,7 @@ an exception as the primary image in the embedded TIFF stream is always empty; the primary image should be obtained using the JPEG reader itself. -

Writing Images

TIFF images are written by a ImageWriter which may be controlled by its public interface as well as via a supplied @@ -477,11 +477,11 @@ rows per strip is rounded to a multiple of 8 times the maximum MCU over both dimensions.

- + -

Compression

The compression type may be set via the setCompressionType() method of the ImageWriteParam after setting the compression mode to @@ -576,14 +576,14 @@ quality value is passed directly to the JPEG writer plug-in which interprets it in the usual way.

Color Conversion

If the source image data color space type is RGB, and the destination photometric type is CIE L*a*b* or YCbCr, then the source image data will be automatically converted from RGB using an internal color converter.

ICC Profiles

An ICC Profile field will be written if either:

@@ -600,7 +600,7 @@ -

Metadata Issues

Some behavior of the writer is affected by or may affect the contents of the image metadata which may be supplied by the user. @@ -713,8 +713,8 @@ IIOMetadata object so obtained may then be passed to the TIFF writer.

-Mapping of the Standard Metadata Format to TIFF Native Image Metadata

+Mapping of the Standard Metadata Format to TIFF Native Image Metadata

The derivation of TIFF native image metadata elements from the standard metadata format @@ -829,12 +829,12 @@ -

Writing Exif Images

The TIFF writer may be used to write an uncompressed Exif image or the contents of the APP1 marker segment of a compressed Exif image. -

Writing Uncompressed Exif Images

When writing a sequence of images each image is normally recorded as {IFD, IFD Value, Image Data}. The Exif specification requires @@ -901,7 +901,7 @@ } -

Writing Compressed Exif Images

The structure of the embedded TIFF stream in the APP1 segment of a compressed Exif image is identical to the @@ -1008,7 +1008,7 @@ and written to the JPEG stream when the primary image is written using the JPEG writer. -

Stream Metadata

The DTD for the TIFF native stream metadata format is as follows: @@ -1025,7 +1025,7 @@ ]> -

Image Metadata

The DTD for the TIFF native image metadata format is as follows: @@ -1174,6 +1174,6 @@ @since 9 - +

WBMP Metadata Format Specification

The XML schema for the native image metadata format is as follows: @@ -62,5 +63,5 @@ @since 1.5 - +

* For more information on what expanded state means, see the - * JTree description above. + * {@link JTree JTree description} above. * * @return the instance of {@code TreeModelHandler} */ diff -r 2e0c4b2d567b -r 1ba28f0dbc33 src/java.desktop/share/classes/javax/swing/plaf/basic/BasicTextUI.java --- a/src/java.desktop/share/classes/javax/swing/plaf/basic/BasicTextUI.java Thu May 31 09:24:27 2018 -0700 +++ b/src/java.desktop/share/classes/javax/swing/plaf/basic/BasicTextUI.java Thu May 31 09:52:32 2018 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -882,7 +882,7 @@ * To prevent this from happening twice, this method is * reimplemented to simply paint. *

- * NOTE: NOTE: Superclass is also not thread-safe in its + * NOTE: Superclass is also not thread-safe in its * rendering of the background, although that is not an issue with the * default rendering. */ @@ -1283,8 +1283,8 @@ * text component (i.e. the root of the hierarchy) that * can be traversed to determine how the model is being * represented spatially. - *

+ * Warning: The View hierarchy can * be traversed from the root view, and other things * can be done as well. Things done in this way cannot * be protected like simple method calls through the TextUI. diff -r 2e0c4b2d567b -r 1ba28f0dbc33 src/java.desktop/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html --- a/src/java.desktop/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html Thu May 31 09:24:27 2018 -0700 +++ b/src/java.desktop/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html Thu May 31 09:52:32 2018 -0700 @@ -5,7 +5,7 @@ Using the Multiplexing Look and Feel - +

Using the Multiplexing Look and Feel

@@ -497,6 +497,6 @@ of auxiliary look and feels will most likely have developed and tested against our Multiplexing look and feel.
- +

Primary Colors

@@ -229,6 +230,6 @@

Key	Value	Preview

- +

Component Specific Properties

The look, and to some degree the feel of Synth can be customized by way of component specific properties. These properties are accessed from ClassCastException is thrown, but it is implementation specific.

ArrowButton

ArrowButton is a special type of JButton that renders an arrow. ArrowButton is typically not created directly, rather some of the Components will create it to render a button with an arrow. The @@ -52,7 +53,7 @@ In addition to the Button properties, ArrowButton supports the following properties:

ArrowButton Specific Properties

@@ -70,11 +71,11 @@

Property

JButton

JButton paints text using the TEXT_FOREGROUND ColorType. In addition to the Button properties, JButton supports the following property:

JButton Specific Properties

@@ -93,11 +94,11 @@

Property

JCheckBox

JCheckBox paints text using the TEXT_FOREGROUND ColorType. In addition to the Button properties, JCheckBox supports the following property:

JCheckBox Specific Properties

@@ -115,7 +116,7 @@

Property

JComboBox

JComboBox is a composite component that consists of the following child Components:

@@ -164,7 +165,7 @@

JComboBox Specific Properties

@@ -183,8 +184,8 @@

Property

JFileChooser

JFileChooser Specific Properties

JFileChooser

JFileChooser Specific Properties

@@ -343,8 +344,8 @@

JInternalFrame

JInternalFrame Specific Properties

JInternalFrame

JInternalFrame Specific Properties

@@ -373,11 +374,11 @@

JInternalFrameTitlePane

JInternalFrameTitlePane is the control bar located at the top of the internal frame similar to that found in a frame.

JInternalFrameTitlePane Specific Properties

@@ -473,10 +474,10 @@

JList

JList's sets the name of the renderer to List.renderer. JList supports the following properties:

JList Specific Properties

@@ -512,7 +513,7 @@

Property

Menu Properties

The Menu classes (JCheckBoxMenuItem, JMenu, JMenuItem, and JRadioButtonMenuItem) all support the same set of properties and behave similarly. Each component consists of two Regions: the region @@ -597,12 +598,12 @@
-

JOptionPane

JOptionPane is a composite component and may consist of numerous child components, they are: OptionPane.button, OptionPane.label, OptionPane.comboBox, OptionPane.scrollPane, OptionPane.list, OptionPane.textField, OptionPane.iconLabel.

JOptionPane Specific Properties

@@ -713,10 +714,10 @@

Property

JProgressBar
-

JProgressBar Specific Properties
-

JProgressBar
+

JProgressBar Specific Properties
+

@@ -753,11 +754,11 @@

JRadioButton

JRadioButton paints text using the TEXT_FOREGROUND ColorType. In addition to the Button properties, JRadioButton supports the following property:

JRadioButton Specific Properties

@@ -775,7 +776,7 @@

Property

JScrollBar

JScrollBar is a composite component that consists of the following child Components:

@@ -793,7 +794,7 @@

JScrollBar Specific Properties

@@ -845,7 +846,7 @@

Property

Separators

All of the separator classes, JSeparator, JPopupMenu.Separator and JToolBar.Separator use the same property:

@@ -887,7 +888,7 @@

JScrollPane

JScrollPane is unique in that it provides a method for setting the Border around the JViewport with JViewport throwing an @@ -900,7 +901,7 @@ paintViewportBorder is called to paint the Viewports border.

JScrollPane Specific Properties

@@ -918,13 +919,13 @@

Property

JSplitPane

JSplitPane is a composite component that will contain a divider and potentially two buttons, if setOneTouchExpandable(true) has been invoked. The two buttons will be named: SplitPaneDivider.leftOneTouchButton and SplitPaneDivider.rightOneTouchButton.

JSplitPane Specific Properties

@@ -967,8 +968,8 @@

Property

JSlider

JSlider Specific Properties

JSlider

JSlider Specific Properties

@@ -1027,8 +1028,8 @@

JTabbedPane

JTabbedPane Specific Properties

JTabbedPane

JTabbedPane Specific Properties

@@ -1089,10 +1090,10 @@

JTable

JTable sets the name of the renderer to Table.cellRenderer. JTable supports the following properties:

JTable Specific Properties

@@ -1134,10 +1135,10 @@

Property

JTree

JTree sets the name of the renderer to Tree.renderer, the name of the editor is Tree.cellEditor.

JTree Specific Properties

@@ -1217,11 +1218,11 @@

Property

JToggleButton

JToggleButton paints text using the TEXT_FOREGROUND ColorType. In addition to the Button properties, JToggleButton supports the following property:

JToggleButton Specific Properties

@@ -1239,7 +1240,7 @@

Property

Button Properties

Each of the Button classes (JButton, JCheckBox, JRadioButton, JToggleButton and SynthArrowButton) support a similar set of properties. These properties are:

@@ -1292,8 +1293,8 @@

Prefix is one of: Button, CheckBox, RadioButton or JToggleButton.

Text Properties
-

Text Properties
+

@@ -1341,5 +1342,6 @@

Prefix is one of: EditorPane, FormattedTextField, PasswordField, TextArea, TextField or TextPane.

+ diff -r 2e0c4b2d567b -r 1ba28f0dbc33 src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html --- a/src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html Thu May 31 09:24:27 2018 -0700 +++ b/src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html Thu May 31 09:52:32 2018 -0700 @@ -4,7 +4,7 @@ Synth File Format * * * * * * * @@ -1001,16 +1001,16 @@ * *

Invoking setInnerHTML(elem, "<ul><li>") * results in the following structure (new elements are in red).

+ * style="color: blue;">in blue).

* *

      *     <body>
      *       |
      *     <div>
      *         \
-     *         <ul>
+     *         <ul>
      *           \
-     *           <li>
+     *           <li>
      *

* *

Parameter elem must not be a leaf element, @@ -1085,14 +1085,14 @@ * *

Invoking setOuterHTML(elem, "<ul><li>") * results in the following structure (new elements are in red).

+ * style="color: blue;">in blue).

* *

      *    <body>
      *      |
-     *     <ul>
+     *     <ul>
      *       \
-     *       <li>
+     *       <li>
      *

* *

If either elem or htmlText @@ -1158,16 +1158,16 @@ * *

Invoking insertAfterStart(elem, * "<ul><li>") results in the following structure - * (new elements are in red).

+ * (new elements are in blue).

* *

      *        <body>
      *          |
      *        <div>
      *       /  |  \
-     *    <ul> <p> <p>
+     *    <ul> <p> <p>
      *     /
-     *  <li>
+     *  <li>
      *

* *

Unlike the insertBeforeStart method, new @@ -1231,16 +1231,16 @@ * *

Invoking insertBeforeEnd(elem, "<ul><li>") * results in the following structure (new elements are in red).

+ * style="color: blue;">in blue).

* *

      *        <body>
      *          |
      *        <div>
      *       /  |  \
-     *     <p> <p> <ul>
+     *     <p> <p> <ul>
      *               \
-     *               <li>
+     *               <li>
      *

* *

Unlike the insertAfterEnd method, new elements @@ -1301,14 +1301,14 @@ * *

Invoking insertBeforeStart(elem, * "<ul><li>") results in the following structure - * (new elements are in red).

+ * (new elements are in blue).

* *

      *        <body>
      *         /  \
-     *      <ul> <div>
+     *      <ul> <div>
      *       /    /  \
-     *     <li> <p>  <p>
+     *     <li> <p>  <p>
      *

* *

Unlike the insertAfterStart method, new @@ -1362,14 +1362,14 @@ * *

Invoking insertAfterEnd(elem, "<ul><li>") * results in the following structure (new elements are in red).

+ * style="color: blue;">in blue).

* *

      *        <body>
      *         /  \
-     *      <div> <ul>
+     *      <div> <ul>
      *       / \    \
-     *     <p> <p>  <li>
+     *     <p> <p>  <li>
      *

* *

Unlike the insertBeforeEnd method, new elements

- *

List Item

Paragraph 1

Paragraph 2

- *

List Item

- *

List Item

@@ -237,21 +237,21 @@ *

Paragraph 1

Paragraph 2

List Item

- *

List Item

- *

List Item