archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-09-17 09:34:38 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8199150: Accessibility issues in java.desktop

Browse source 
8150156: Update bugs.sun.com references to bugs.java.com

Reviewed-by: prr
This commit is contained in:
Sergey Bylokhov 2018-05-31 09:52:32 -07:00
parent 414dd381fc
commit b7dbfb2e28
20 changed files with 199 additions and 191 deletions
Download patch file Download diff file Expand all files Collapse all files

5
src/java.desktop/share/classes/javax/imageio/metadata/doc-files/bmp_metadata.html
View file

@ -5,7 +5,7 @@
<title>BMP Metadata Format Specification</title>
</head>
<!--
Copyright (c) 2003, 2017, Oracle and/or its affiliates. All rights reserved.
Copyright (c) 2003, 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
@ -30,6 +30,7 @@ questions.
-->
<body>
<main role="main">
<h1>BMP Metadata Format Specification</h1>
The XML schema for the native image metadata format is as follows:
@ -160,5 +161,5 @@ The XML schema for the native image metadata format is as follows:
</pre>
@since 1.5
</main>
</body>

4
src/java.desktop/share/classes/javax/imageio/metadata/doc-files/gif_metadata.html
View file

@ -30,7 +30,7 @@ questions.
-->
<body>
<main role="main">
<h1>GIF Metadata Format Specification</h1>
<a id="gif_stream_metadata_format"></a>
<h2>GIF Stream Metadata Format Specification</h2>
@ -434,6 +434,6 @@ advanced only on user input.
"TRUE")</td>
</tr>
</table>
</main>
</body>
</html>

6
src/java.desktop/share/classes/javax/imageio/metadata/doc-files/jpeg_metadata.html
View file

@ -5,7 +5,7 @@
<title>JPEG Metadata Format Specification and Usage Notes</title>
</head>
<!--
Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
Copyright (c) 2000, 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
@ -30,7 +30,7 @@ questions.
-->
<body>
<main role="main">
<h1>JPEG Metadata Format Specification and Usage Notes</h1>
<p>
@ -1159,6 +1159,6 @@ format, performs a <code>reset</code> followed by a merge of the new tree.
&lt;!-- All elements are as defined above for image metadata --&gt;
]&gt;
</pre>
</main>
</body>
</html>

6
src/java.desktop/share/classes/javax/imageio/metadata/doc-files/png_metadata.html
View file

@ -5,7 +5,7 @@
<title>PNG Metadata Format Specification</title>
</head>
<!--
Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
Copyright (c) 2000, 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
@ -30,7 +30,7 @@ questions.
-->
<body>
<main role="main">
<h1>PNG Metadata Format Specification</h1>
<p>
@ -561,6 +561,6 @@ written, or to determine the order of the chunks in a file being read.
&lt;!-- Data type: String --&gt;
]&gt;
</pre>
</main>
</body>
</html>

6
src/java.desktop/share/classes/javax/imageio/metadata/doc-files/standard_metadata.html
View file

@ -5,7 +5,7 @@
<title>Standard Metadata Format Specification</title>
</head>
<!--
Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
Copyright (c) 2000, 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
@ -30,7 +30,7 @@ questions.
-->
<body>
<main role="main">
<h1>Standard (Plug-in Neutral) Metadata Format Specification</h1>
<p> The plug-in neutral "javax_imageio_1.0" format consists
@ -394,6 +394,6 @@ following DTD:
&lt;!-- Data type: Integer --&gt;
]&gt;
</pre>
</main>
</body>
</html>

54
src/java.desktop/share/classes/javax/imageio/metadata/doc-files/tiff_metadata.html
View file

@ -5,7 +5,7 @@
<title>TIFF Metadata Format Specification and Usage Notes</title>
</head>
<!--
Copyright (c) 2015, 2017, Oracle and/or its affiliates. All rights reserved.
Copyright (c) 2015, 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
@ -30,7 +30,7 @@ questions.
-->
<body>
<main role="main">
<h1>TIFF Metadata Format Specification and Usage Notes</h1>
<a href="#Reading">Reading Images</a>
@ -69,24 +69,24 @@ questions.
<a href="#StreamMetadata">Native Stream Metadata Format</a><br/>
<a href="#ImageMetadata">Native Image Metadata Format</a>
<h3><a id="Reading">Reading Images</a></h3>
<h2><a id="Reading">Reading Images</a></h2>
TIFF images are read by an <a href="../../ImageReader.html">ImageReader</a>
which may be controlled by its public interface as well as via a supplied
<a href="../../plugins/tiff/TIFFImageReadParam.html">TIFFImageReadParam</a>.
<!-- <h4>Supported Image Types</h4> -->
<!-- <h3>Supported Image Types</h3> -->
<!-- Table? -->
<h4><a id="ColorConversionRead">Color Conversion</a></h4>
<h3><a id="ColorConversionRead">Color Conversion</a></h3>
<p>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.</p>
<h4><a id="ColorSpacesRead">Color Spaces</a></h4>
<h3><a id="ColorSpacesRead">Color Spaces</a></h3>
The raw color space assigned by default, i.e., in the absence of a
user-supplied <a href="../../ImageTypeSpecifier.html">ImageTypeSpecifier</a>,
@ -154,7 +154,7 @@ foregoing, then an <code>ImageTypeSpecifier</code> should be
supplied to the reader and should be derived from a color space which is correct
for the data in question.</p>
<h4><a id="ICCProfilesRead">ICC Profiles</a></h4>
<h3><a id="ICCProfilesRead">ICC Profiles</a></h3>
If an ICC profile is contained in the image metadata
(<a href="../../plugins/tiff/BaselineTIFFTagSet.html">
@ -196,7 +196,7 @@ space will be included in the
more than one type, the first one will be based on the ICC profile and the
second on the inferred color space.</p>
<h4><a id="MetadataIssuesRead">Metadata Issues</a></h4>
<h3><a id="MetadataIssuesRead">Metadata Issues</a></h3>
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 may simplify gaining access to metadata values. An instance of
object returned by the TIFF reader using the
<code>TIFFDirectory.createFromMetadata</code> method.</p>
<h5><a id="MapNativeStandard"></a>
Mapping of TIFF Native Image Metadata to the Standard Metadata Format</h5>
<h4><a id="MapNativeStandard"></a>
Mapping of TIFF Native Image Metadata to the Standard Metadata Format</h4>
The derivation of standard metadata format
<a href="standard_metadata.html">javax_imageio_1.0</a>
@ -349,12 +349,12 @@ unassociated alpha =&gt; "nonpremultiplied".</td>
</tr>
</table>
<h4><a id="ExifRead">Reading Exif Images</a></h4>
<h3><a id="ExifRead">Reading Exif Images</a></h3>
The TIFF reader may be used to read an uncompressed Exif image or the
contents of the <code>APP1</code> marker segment of a compressed Exif image.
<h5><a id="ExifReadTIFF">Reading Uncompressed Exif Images</a></h5>
<h4><a id="ExifReadTIFF">Reading Uncompressed Exif Images</a></h4>
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 @@ Note that the Exif thumbnail is treated as a separate page in the TIFF
stream and not as a thumbnail, i.e.,
<code>tiffReader.hasThumbnails(0)</code> will return <code>false</code>.
<h5><a id="ExifReadJPEG">Reading Compressed Exif Images</a></h5>
<h4><a id="ExifReadJPEG">Reading Compressed Exif Images</a></h4>
A compressed Exif image is a 3-band ISO/IEC 10918-1 baseline DCT JPEG stream
with an inserted <code>APP1</code> marker segment. The parameters of the marker
@ -453,7 +453,7 @@ images. Calling <code>tiffReader.read(0,&nbsp;readParam)</code> will throw
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.
<h3><a id="Writing">Writing Images</a></h3>
<h2><a id="Writing">Writing Images</a></h2>
TIFF images are written by a <a href="../../ImageWriter.html">ImageWriter</a> which may be
controlled by its public interface as well as via a supplied
@ -477,11 +477,11 @@ compression is being used and strips are being written, the number of
rows per strip is rounded to a multiple of 8 times the maximum MCU over
both dimensions.</p>
<!-- <h4>Supported Image Types</h4> -->
<!-- <h3>Supported Image Types</h3> -->
<!-- Table? -->
<h4><a id="Compression">Compression</a></h4>
<h3><a id="Compression">Compression</a></h3>
The compression type may be set via the <code>setCompressionType()</code> method of
the <code>ImageWriteParam</code> after setting the compression mode to
@ -576,14 +576,14 @@ to derive the Deflate compression level. For JPEG the floating point
quality value is passed directly to the JPEG writer plug-in which
interprets it in the usual way.</p>
<h4><a id="ColorConversionWrite">Color Conversion</a></h4>
<h3><a id="ColorConversionWrite">Color Conversion</a></h3>
<p>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.</p>
<h4><a id="ICCProfilesWrite">ICC Profiles</a></h4>
<h3><a id="ICCProfilesWrite">ICC Profiles</a></h3>
An <code>ICC Profile</code> field will be written if either:
<ul>
@ -600,7 +600,7 @@ to the <code>ImageTypeSpecifier</code> of the image being written.
</li>
</ul>
<h4><a id="MetadataIssuesWrite">Metadata Issues</a></h4>
<h3><a id="MetadataIssuesWrite">Metadata Issues</a></h3>
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 @@ field to be written a <code>TIFFField</code> may be added to the
<code>IIOMetadata</code> object so obtained may then be passed to the TIFF
writer.</p>
<h5><a id="MapStandardNative"></a>
Mapping of the Standard Metadata Format to TIFF Native Image Metadata</h5>
<h4><a id="MapStandardNative"></a>
Mapping of the Standard Metadata Format to TIFF Native Image Metadata</h4>
The derivation of <a href="#ImageMetadata">TIFF native image metadata</a>
elements from the standard metadata format
@ -829,12 +829,12 @@ TIFF Fields, e.g., "Software", then the field is added with content
</tr>
</table>
<h4><a id="ExifWrite">Writing Exif Images</a></h4>
<h3><a id="ExifWrite">Writing Exif Images</a></h3>
The TIFF writer may be used to write an uncompressed Exif image or the
contents of the <code>APP1</code> marker segment of a compressed Exif image.
<h5><a id="ExifWriteTIFF">Writing Uncompressed Exif Images</a></h5>
<h4><a id="ExifWriteTIFF">Writing Uncompressed Exif Images</a></h4>
When writing a sequence of images each image is normally recorded as
{IFD,&nbsp;IFD Value,&nbsp;Image Data}. The Exif specification requires
@ -901,7 +901,7 @@ written:
}
</code></pre>
<h5><a id="ExifWriteJPEG">Writing Compressed Exif Images</a></h5>
<h4><a id="ExifWriteJPEG">Writing Compressed Exif Images</a></h4>
The structure of the embedded TIFF stream in the <code>APP1</code> segment of a
compressed Exif image is identical to the <a href="#ExifStructure">
@ -1008,7 +1008,7 @@ The <code>"unknown"</code> node created above would be appended to the
and written to the JPEG stream when the primary image is written using
the JPEG writer.
<h3><a id="StreamMetadata">Stream Metadata</a></h3>
<h2><a id="StreamMetadata">Stream Metadata</a></h2>
The DTD for the TIFF native stream metadata format is as follows:
@ -1025,7 +1025,7 @@ The DTD for the TIFF native stream metadata format is as follows:
]&gt;
</pre>
<h3><a id="ImageMetadata">Image Metadata</a></h3>
<h2><a id="ImageMetadata">Image Metadata</a></h2>
The DTD for the TIFF native image metadata format is as follows:
@ -1174,6 +1174,6 @@ The DTD for the TIFF native image metadata format is as follows:
</pre>
@since 9
</main>
</body>
</html>

5
src/java.desktop/share/classes/javax/imageio/metadata/doc-files/wbmp_metadata.html
View file

@ -5,7 +5,7 @@
<title>WBMP Metadata Format Specification</title>
</head>
<!--
Copyright (c) 2003, 2017, Oracle and/or its affiliates. All rights reserved.
Copyright (c) 2003, 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
@ -30,6 +30,7 @@ questions.
-->
<body>
<main role="main">
<h1>WBMP Metadata Format Specification</h1>
The XML schema for the native image metadata format is as follows:
@ -62,5 +63,5 @@ The XML schema for the native image metadata format is as follows:
</pre>
@since 1.5
</main>
</body>

5
src/java.desktop/share/classes/javax/swing/JTree.java
View file

@ -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
@ -46,7 +46,6 @@ import sun.swing.SwingUtilities2.Section;
import static sun.swing.SwingUtilities2.Section.*;
/**
* <a id="jtree_description"></a>
* A control that displays a set of hierarchical data as an outline.
* You can find task-oriented documentation and examples of using trees in
* <a href="http://docs.oracle.com/javase/tutorial/uiswing/components/tree.html">How to Use Trees</a>,
@ -3778,7 +3777,7 @@ public class JTree extends JComponent implements Scrollable, Accessible
* <code>TreeModel</code> changes.
* <p>
* For more information on what expanded state means, see the
* <a href=#jtree_description>JTree description</a> above.
* {@link JTree JTree description} above.
*
* @return the instance of {@code TreeModelHandler}
*/

8
src/java.desktop/share/classes/javax/swing/plaf/basic/BasicTextUI.java
View file

@ -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 @@ public abstract class BasicTextUI extends TextUI implements ViewFactory {
* To prevent this from happening twice, this method is
* reimplemented to simply paint.
* <p>
* <em>NOTE:</em> NOTE: Superclass is also not thread-safe in its
* <em>NOTE:</em> 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 @@ public abstract class BasicTextUI extends TextUI implements ViewFactory {
* text component (i.e. the root of the hierarchy) that
* can be traversed to determine how the model is being
* represented spatially.
* <p style="color:red;">
* <b>NOTE:</b>The View hierarchy can
* <p>
* <strong>Warning:</strong> 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.

6
src/java.desktop/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html
View file

@ -5,7 +5,7 @@
<title>Using the Multiplexing Look and Feel</title>
</head>
<!--
Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
Copyright (c) 1998, 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
@ -30,7 +30,7 @@
-->
<body>
<main role="main">
<h1>Using the Multiplexing Look and Feel</h1>
<blockquote>
@ -497,6 +497,6 @@ if you use this kind of statement, be careful, because the suppliers
of auxiliary look and feels will most likely have developed and
tested against our Multiplexing look and feel.
</p>
</main>
</body>
</html>

5
src/java.desktop/share/classes/javax/swing/plaf/nimbus/doc-files/properties.html
View file

@ -5,7 +5,7 @@
<title>Nimbus colors</title>
</head>
<!--
Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved.
Copyright (c) 2005, 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
@ -30,6 +30,7 @@
-->
<body>
<main role="main">
<h1 id="primaryColors">Primary Colors</h1>
<table summary="Nimbus primary colors">
<tr><th>Key</th><th>Value</th><th>Preview</th></tr>
@ -229,6 +230,6 @@
<td width="100" bgcolor="#8e8f91">&nbsp;</td>
</tr>
</table>
</main>
</body>
</html>

98
src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/componentProperties.html
View file

@ -5,7 +5,7 @@
<title>Component Specific Properties</title>
</head>
<!--
Copyright (c) 2003, 2017, Oracle and/or its affiliates. All rights reserved.
Copyright (c) 2003, 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
@ -29,8 +29,9 @@ or visit www.oracle.com if you need additional information or have any
questions.
-->
<body bgcolor="white">
<h3>Component Specific Properties</h3>
<body>
<main role="main">
<h1>Component Specific Properties</h1>
<p> The look, and to some degree the feel of Synth
can be customized by way of component specific properties.
These properties are accessed from <a
@ -43,7 +44,7 @@ questions.
unspecified: typically a <code>ClassCastException</code> is
thrown, but it is implementation specific.
</p>
<h4>ArrowButton</h4>
<h2>ArrowButton</h2>
<p> 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 @@ JComboBox, JScrollBar and JSplitPane (for the buttons on the divider).
In addition to the <a
href="#buttonProperties">Button properties</a>, ArrowButton supports
the following properties: </p>
<h5>ArrowButton Specific Properties</h5>
<h3>ArrowButton Specific Properties</h3>
<table border="1" summary="ArrowButton specific properties">
<thead><tr>
<th>Property</th>
@ -70,11 +71,11 @@ the following properties: </p>
</tbody>
</table>
<br>
<h4><a id="JButton">JButton</a></h4>
<h2><a id="JButton">JButton</a></h2>
<p> JButton paints text using the TEXT_FOREGROUND ColorType. In addition
to the <a href="#buttonProperties">Button properties</a>, JButton
supports the following property: </p>
<h5>JButton Specific Properties</h5>
<h3>JButton Specific Properties</h3>
<table border="1" summary="JButton specific properties">
<thead><tr>
<th>Property</th>
@ -93,11 +94,11 @@ button that is receiving focus. </td>
</tbody>
</table>
<br>
<h4><a id="JCheckBox">JCheckBox</a></h4>
<h2><a id="JCheckBox">JCheckBox</a></h2>
<p> JCheckBox paints text using the TEXT_FOREGROUND ColorType. In
addition to the <a href="#buttonProperties">Button properties</a>,
JCheckBox supports the following property: </p>
<h5>JCheckBox Specific Properties</h5>
<h3>JCheckBox Specific Properties</h3>
<table border="1" summary="JCheckBox specific properties">
<thead><tr>
<th>Property</th>
@ -115,7 +116,7 @@ JCheckBox supports the following property: </p>
</tbody>
</table>
<br>
<h4><a id="JComboBox">JComboBox</a></h4>
<h2><a id="JComboBox">JComboBox</a></h2>
<p> JComboBox is a composite component that consists of the following
child Components: </p>
<table border="1" summary="JComboBox child components">
@ -164,7 +165,7 @@ the renderer is a UIResource. </td>
</tbody>
</table>
<h5>JComboBox Specific Properties</h5>
<h3>JComboBox Specific Properties</h3>
<table border="1" summary="JComboBox specific properties">
<thead><tr>
<th>Property</th>
@ -183,8 +184,8 @@ with the keyboard. </td>
</tbody>
</table>
<br>
<h4>JFileChooser</h4>
<h5>JFileChooser Specific Properties</h5>
<h2>JFileChooser</h2>
<h3>JFileChooser Specific Properties</h3>
<table cellpadding="2" cellspacing="2" border="1" summary="JFileChooser specific properties"
style="width: 100%; text-align: left;">
<tbody>
@ -343,8 +344,8 @@ of the file chooser.<br>
</tbody>
</table>
<br>
<h4><a id="JInternalFrame"></a>JInternalFrame</h4>
<h5>JInternalFrame Specific Properties</h5>
<h2><a id="JInternalFrame"></a>JInternalFrame</h2>
<h3>JInternalFrame Specific Properties</h3>
<table cellpadding="2" cellspacing="2" border="1" summary="JInternalFrame specific properties"
style="text-align: left; width: 100%;">
<tbody>
@ -373,11 +374,11 @@ the system menu will be shown.<br>
</tbody>
</table>
<br>
<h4><a id="JInternalFrameTitlePane"></a>JInternalFrameTitlePane</h4>
<h2><a id="JInternalFrameTitlePane"></a>JInternalFrameTitlePane</h2>
<p>JInternalFrameTitlePane is the control bar located at the top of the
internal frame similar to that found in a frame.<br>
</p>
<h5>JInternalFrameTitlePane Specific Properties</h5>
<h3>JInternalFrameTitlePane Specific Properties</h3>
<table cellpadding="2" cellspacing="2" border="1" summary="JInternalFrameTitlePane specific properties"
style="text-align: left; width: 100%;">
<tbody>
@ -473,10 +474,10 @@ abililty to close the internal frame.
</tbody>
</table>
<br>
<h4><a id="JList">JList</a></h4>
<h2><a id="JList">JList</a></h2>
<p> JList's sets the name of the renderer to List.renderer. JList
supports the following properties: </p>
<h5>JList Specific Properties</h5>
<h3>JList Specific Properties</h3>
<table border="1" summary="JList specific properties">
<thead><tr>
<th>Property</th>
@ -512,7 +513,7 @@ is not invoked. </td>
</tbody>
</table>
<br>
<h4><a id="menuProperties">Menu Properties</a></h4>
<h2><a id="menuProperties">Menu Properties</a></h2>
<p> 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 @@ RadioButtonMenuItem. </p>
</tbody>
</table>
<br>
<h4><a id="JOptionPane">JOptionPane</a></h4>
<h2><a id="JOptionPane">JOptionPane</a></h2>
<p> 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. </p>
<h5>JOptionPane Specific Properties</h5>
<h3>JOptionPane Specific Properties</h3>
<table border="1" summary="JOptionPane specific properties">
<thead><tr>
<th>Property</th>
@ -713,10 +714,10 @@ it follows the other buttons. </td>
</tbody>
</table>
<br>
<h4><a id="JProgressBar"></a>JProgressBar<br>
</h4>
<h5>JProgressBar Specific Properties<br>
</h5>
<h2><a id="JProgressBar"></a>JProgressBar<br>
</h2>
<h3>JProgressBar Specific Properties<br>
</h3>
<table cellpadding="2" cellspacing="2" border="1" summary="JProgressBar specific properties"
style="text-align: left; width: 100%;">
<tbody>
@ -753,11 +754,11 @@ the bouncing box per frame when the progress bar is indeterminate.<br>
</tr>
</tbody>
</table>
<h4><a id="JRadioButton">JRadioButton</a></h4>
<h2><a id="JRadioButton">JRadioButton</a></h2>
<p> JRadioButton paints text using the TEXT_FOREGROUND ColorType. In
addition to the <a href="#buttonProperties">Button properties</a>,
JRadioButton supports the following property: </p>
<h5>JRadioButton Specific Properties</h5>
<h3>JRadioButton Specific Properties</h3>
<table border="1" summary="JRadioButton specific properties">
<thead><tr>
<th>Property</th>
@ -775,7 +776,7 @@ JRadioButton supports the following property: </p>
</tbody>
</table>
<br>
<h4><a id="JScrollBar">JScrollBar</a></h4>
<h2><a id="JScrollBar">JScrollBar</a></h2>
<p> JScrollBar is a composite component that consists of the following
child Components: </p>
<table border="1" summary="JScrollBar child components">
@ -793,7 +794,7 @@ child Components: </p>
</tbody>
</table>
<h5>JScrollBar Specific Properties</h5>
<h3>JScrollBar Specific Properties</h3>
<table border="1" summary="JScrollBar specific properties">
<thead><tr>
<th>Property</th>
@ -845,7 +846,7 @@ will be made equal. </td>
</tbody>
</table>
<br>
<h4><a id="Separator">Separators</a></h4>
<h2><a id="Separator">Separators</a></h2>
<p> All of the separator classes, JSeparator, JPopupMenu.Separator and
JToolBar.Separator use the same property: </p>
<table border="1" summary="Separator classes common properties">
@ -887,7 +888,7 @@ preferred size will include the Insets. </td>
</tbody>
</table>
<br>
<h4><a id="JScrollPane">JScrollPane</a></h4>
<h2><a id="JScrollPane">JScrollPane</a></h2>
<p>
JScrollPane is unique in that it provides a method for setting
the Border around the JViewport with JViewport throwing an
@ -900,7 +901,7 @@ preferred size will include the Insets. </td>
<code>paintViewportBorder</code> is called to paint the
<code>Viewport</code>s border.
</p>
<h5>JScrollPane Specific Properties</h5>
<h3>JScrollPane Specific Properties</h3>
<table border="1" summary="JScrollPane specific properties">
<thead><tr>
<th>Property</th>
@ -918,13 +919,13 @@ preferred size will include the Insets. </td>
</tbody>
</table>
<br>
<h4><a id="JSplitPane">JSplitPane</a></h4>
<h2><a id="JSplitPane">JSplitPane</a></h2>
<p> 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. </p>
<h5>JSplitPane Specific Properties</h5>
<h3>JSplitPane Specific Properties</h3>
<table border="1" summary="JSplitPane specific properties">
<thead><tr>
<th>Property</th>
@ -967,8 +968,8 @@ setOneTouchExpandable. </td>
</tbody>
</table>
<br>
<h4><a id="JSlider"></a>JSlider</h4>
<h5>JSlider Specific Properties</h5>
<h2><a id="JSlider"></a>JSlider</h2>
<h3>JSlider Specific Properties</h3>
<table cellpadding="2" cellspacing="2" border="1" summary="JSlider specific properties"
style="text-align: left; width: 100%;">
<tbody>
@ -1027,8 +1028,8 @@ of the slider.<br>
</tbody>
</table>
<br>
<h4><a id="JTabbedPane"></a>JTabbedPane</h4>
<h5>JTabbedPane Specific Properties</h5>
<h2><a id="JTabbedPane"></a>JTabbedPane</h2>
<h3>JTabbedPane Specific Properties</h3>
<table cellpadding="2" cellspacing="2" border="1" summary="JTabbedPane specific properties"
style="text-align: left; width: 100%;">
<tbody>
@ -1089,10 +1090,10 @@ selected tab.<br>
</tbody>
</table>
<br>
<h4><a id="JTable">JTable</a></h4>
<h2><a id="JTable">JTable</a></h2>
<p> JTable sets the name of the renderer to Table.cellRenderer.
JTable supports the following properties: </p>
<h5>JTable Specific Properties</h5>
<h3>JTable Specific Properties</h3>
<table border="1" summary="JTable specific properties">
<thead><tr>
<th>Property</th>
@ -1134,10 +1135,10 @@ renderer will only succeed if it is a Synth Border. </td>
</tbody>
</table>
<br>
<h4><a id="JTree">JTree</a></h4>
<h2><a id="JTree">JTree</a></h2>
<p> JTree sets the name of the renderer to Tree.renderer, the name of
the editor is Tree.cellEditor.</p>
<h5>JTree Specific Properties</h5>
<h3>JTree Specific Properties</h3>
<table border="1" summary="JTree specific properties">
<thead><tr>
<th>Property</th>
@ -1217,11 +1218,11 @@ and <a href="synthFileFormat.html#e.graphicsUtils">binding it</a> to the tree.</
</tr>
</tbody>
</table>
<h4><a id="JToggleButton">JToggleButton</a></h4>
<h2><a id="JToggleButton">JToggleButton</a></h2>
<p> JToggleButton paints text using the TEXT_FOREGROUND ColorType. In
addition to the <a href="#buttonProperties">Button properties</a>,
JToggleButton supports the following property: </p>
<h5>JToggleButton Specific Properties</h5>
<h3>JToggleButton Specific Properties</h3>
<table border="1" summary="JToggleButton specific properties">
<thead><tr>
<th>Property</th>
@ -1239,7 +1240,7 @@ JToggleButton supports the following property: </p>
</tbody>
</table>
<br>
<h4><a id="buttonProperties">Button Properties</a></h4>
<h2><a id="buttonProperties">Button Properties</a></h2>
<p> Each of the Button classes (JButton, JCheckBox, JRadioButton,
JToggleButton and SynthArrowButton) support a similar set of properties.
These properties are: </p>
@ -1292,8 +1293,8 @@ the button is in a pressed state and does not have a pressed icon. </td>
<p> <code>Prefix</code> is one of: Button, CheckBox, RadioButton or
JToggleButton.<br>
</p>
<h4><a id="textProperties"></a>Text Properties<br>
</h4>
<h2><a id="textProperties"></a>Text Properties<br>
</h2>
<table cellpadding="2" cellspacing="2" border="1" summary="Text properties"
style="text-align: left; width: 100%;">
<tbody>
@ -1341,5 +1342,6 @@ the blink rate fo the caret.<br>
<p><code>Prefix</code> is one of: EditorPane, FormattedTextField,
PasswordField, TextArea, TextField or TextPane.<br>
</p>
</main>
</body>
</html>

37
src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html
View file

@ -4,7 +4,7 @@
<meta charset="utf-8"/>
<title>Synth File Format</title>
<!--
Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
Copyright (c) 1998, 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
@ -45,7 +45,8 @@ div.example {
</head>
<body>
<h2><a id="file">File Format</a></h2>
<main role="main">
<h1><a id="file">File Format</a></h1>
<p>
Synth's file format (<a href="synth.dtd">dtd</a>)
allows for specifying all the pieces
@ -98,7 +99,7 @@ div.example {
Parsing will fail only if a necessary attribute is not
specified, or of the wrong type.
<h3>The synth element</h3>
<h2>The synth element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.synth">synth</a> ((<a href="#ee.beansPersistance">%beansPersistance;</a>) | <a href="#e.style">style</a> | <a href="#e.bind">bind</a> | <a href="#e.font">font</a> | <a href="#e.color">color</a> |
@ -118,7 +119,7 @@ div.example {
</p>
<h3>The style element</h3>
<h2>The style element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.style">style</a> (<a href="#e.property">property</a> | <a href="#e.defaultsProperty">defaultsProperty</a> | <a href="#e.state">state</a> | <a href="#e.font">font</a> | <a href="#e.graphicsUtils">graphicsUtils</a> |
@ -172,7 +173,7 @@ div.example {
</pre>
</div>
<h3>The state element</h3>
<h2>The state element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.state">state</a> (<a href="#e.color">color</a> | <a href="#e.font">font</a> | <a href="#e.painter">painter</a> | <a href="#e.imagePainter">imagePainter</a> | (<a href="#ee.beansPersistance">%beansPersistance;</a>) |
@ -248,7 +249,7 @@ div.example {
chosen, otherwise if the state is SELECTED, but not does not
contain PRESSED, state <code>two</code> will be used.
<h3>The font element</h3>
<h2>The font element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.font">font</a> EMPTY>
@ -317,7 +318,7 @@ div.example {
</p>
<h3>The color element</h3>
<h2>The color element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.color">color</a> EMPTY>
@ -394,7 +395,7 @@ div.example {
</pre>
</div>
<h3>The property element</h3>
<h2>The property element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.property">property</a> EMPTY>
@ -516,7 +517,7 @@ div.example {
<code>UIManager.get("Table.focusCellForeground")</code>.
</p>
<h3>The graphicsUtils element</h3>
<h2>The graphicsUtils element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.graphicsUtils">graphicsUtils</a> EMPTY>
@ -548,7 +549,7 @@ div.example {
</pre>
</div>
<h3>The insets element</h3>
<h2>The insets element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.insets">insets</a> EMPTY>
@ -592,7 +593,7 @@ div.example {
</pre>
</div>
<h3>The bind element</h3>
<h2>The bind element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.bind">bind</a> EMPTY>
@ -701,7 +702,7 @@ div.example {
</pre>
</div>
<h3>The painter element</h3>
<h2>The painter element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.painter">painter</a> EMPTY>
@ -815,7 +816,7 @@ div.example {
handle it.
</p>
<h3>The imagePainter element</h3>
<h2>The imagePainter element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.imagePainter">imagePainter</a> EMPTY>
@ -911,7 +912,7 @@ div.example {
understand how identical painters are handled.
<h3>The imageIcon element</h3>
<h2>The imageIcon element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.imageIcon">imageIcon</a> EMPTY>
@ -945,7 +946,7 @@ div.example {
</pre>
</div>
<h3>The opaque element</h3>
<h2>The opaque element</h2>
<div class="dtd-fragment">
<pre class="dtd-fragment">
&lt;!ELEMENT <a id="e.opaque">opaque</a> EMPTY>
@ -976,7 +977,7 @@ div.example {
</pre>
</div>
<h3><a id="ee.beansPersistance">The beansPersistance entity</a></h3>
<h2><a id="ee.beansPersistance">The beansPersistance entity</a></h2>
<p>
Beans persistance can be used to embed any Object. This is
typically used for embedding your own Painters, but can be used
@ -986,7 +987,7 @@ div.example {
for details on beans persistance.
<h3>Backing Style</h3>
<h2>Backing Style</h2>
<p>
In creating a Synth file it's good practice to create a backing
style that is used by all components. This will make sure that
@ -1008,6 +1009,6 @@ div.example {
&lt;/synth>
</pre>
</div>
</main>
</body>
</html>

4
src/java.desktop/share/classes/javax/swing/text/JTextComponent.java
View file

@ -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
@ -171,7 +171,7 @@ import sun.swing.SwingAccessor;
* <td>input methods
* <td>(generated here)
* <tr>
* <th scope="row" headers="stage">2.
* <th scope="row">2.
* <td>focus manager
* <td>
* </tr>

52
src/java.desktop/share/classes/javax/swing/text/html/HTMLDocument.java
View file

@ -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
@ -112,7 +112,7 @@ import static sun.swing.SwingUtilities2.IMPLIED_CR;
* &lt;title&gt;An example HTMLDocument&lt;/title&gt;
* &lt;style type="text/css"&gt;
* div { background-color: silver; }
* ul { color: red; }
* ul { color: blue; }
* &lt;/style&gt;
* &lt;/head&gt;
* &lt;body&gt;
@ -204,7 +204,7 @@ import static sun.swing.SwingUtilities2.IMPLIED_CR;
* <!--insertAfterStart-->
* <td style="white-space:nowrap">
* <div style="background-color: silver;">
* <ul style="color: red;">
* <ul style="color: blue;">
* <li>List Item</li>
* </ul>
* <p>Paragraph 1</p>
@ -216,14 +216,14 @@ import static sun.swing.SwingUtilities2.IMPLIED_CR;
* <div style="background-color: silver;">
* <p>Paragraph 1</p>
* <p>Paragraph 2</p>
* <ul style="color: red;">
* <ul style="color: blue;">
* <li>List Item</li>
* </ul>
* </div>
* </td>
* <!--insertBeforeStart-->
* <td style="white-space:nowrap">
* <ul style="color: red;">
* <ul style="color: blue;">
* <li>List Item</li>
* </ul>
* <div style="background-color: silver;">
@ -237,21 +237,21 @@ import static sun.swing.SwingUtilities2.IMPLIED_CR;
* <p>Paragraph 1</p>
* <p>Paragraph 2</p>
* </div>
* <ul style="color: red;">
* <ul style="color: blue;">
* <li>List Item</li>
* </ul>
* </td>
* <!--setInnerHTML-->
* <td style="white-space:nowrap">
* <div style="background-color: silver;">
* <ul style="color: red;">
* <ul style="color: blue;">
* <li>List Item</li>
* </ul>
* </div>
* </td>
* <!--setOuterHTML-->
* <td style="white-space:nowrap">
* <ul style="color: red;">
* <ul style="color: blue;">
* <li>List Item</li>
* </ul>
* </td>
@ -1001,16 +1001,16 @@ public class HTMLDocument extends DefaultStyledDocument {
*
* <p>Invoking <code>setInnerHTML(elem, "&lt;ul&gt;&lt;li&gt;")</code>
* results in the following structure (new elements are <span
* style="color: red;">in red</span>).</p>
* style="color: blue;">in blue</span>).</p>
*
* <pre>
* &lt;body&gt;
* |
* <b>&lt;div&gt;</b>
* \
* <span style="color: red;">&lt;ul&gt;</span>
* <span style="color: blue;">&lt;ul&gt;</span>
* \
* <span style="color: red;">&lt;li&gt;</span>
* <span style="color: blue;">&lt;li&gt;</span>
* </pre>
*
* <p>Parameter <code>elem</code> must not be a leaf element,
@ -1085,14 +1085,14 @@ public class HTMLDocument extends DefaultStyledDocument {
*
* <p>Invoking <code>setOuterHTML(elem, "&lt;ul&gt;&lt;li&gt;")</code>
* results in the following structure (new elements are <span
* style="color: red;">in red</span>).</p>
* style="color: blue;">in blue</span>).</p>
*
* <pre>
* &lt;body&gt;
* |
* <span style="color: red;">&lt;ul&gt;</span>
* <span style="color: blue;">&lt;ul&gt;</span>
* \
* <span style="color: red;">&lt;li&gt;</span>
* <span style="color: blue;">&lt;li&gt;</span>
* </pre>
*
* <p>If either <code>elem</code> or <code>htmlText</code>
@ -1158,16 +1158,16 @@ public class HTMLDocument extends DefaultStyledDocument {
*
* <p>Invoking <code>insertAfterStart(elem,
* "&lt;ul&gt;&lt;li&gt;")</code> results in the following structure
* (new elements are <span style="color: red;">in red</span>).</p>
* (new elements are <span style="color: blue;">in blue</span>).</p>
*
* <pre>
* &lt;body&gt;
* |
* <b>&lt;div&gt;</b>
* / | \
* <span style="color: red;">&lt;ul&gt;</span> &lt;p&gt; &lt;p&gt;
* <span style="color: blue;">&lt;ul&gt;</span> &lt;p&gt; &lt;p&gt;
* /
* <span style="color: red;">&lt;li&gt;</span>
* <span style="color: blue;">&lt;li&gt;</span>
* </pre>
*
* <p>Unlike the <code>insertBeforeStart</code> method, new
@ -1231,16 +1231,16 @@ public class HTMLDocument extends DefaultStyledDocument {
*
* <p>Invoking <code>insertBeforeEnd(elem, "&lt;ul&gt;&lt;li&gt;")</code>
* results in the following structure (new elements are <span
* style="color: red;">in red</span>).</p>
* style="color: blue;">in blue</span>).</p>
*
* <pre>
* &lt;body&gt;
* |
* <b>&lt;div&gt;</b>
* / | \
* &lt;p&gt; &lt;p&gt; <span style="color: red;">&lt;ul&gt;</span>
* &lt;p&gt; &lt;p&gt; <span style="color: blue;">&lt;ul&gt;</span>
* \
* <span style="color: red;">&lt;li&gt;</span>
* <span style="color: blue;">&lt;li&gt;</span>
* </pre>
*
* <p>Unlike the <code>insertAfterEnd</code> method, new elements
@ -1301,14 +1301,14 @@ public class HTMLDocument extends DefaultStyledDocument {
*
* <p>Invoking <code>insertBeforeStart(elem,
* "&lt;ul&gt;&lt;li&gt;")</code> results in the following structure
* (new elements are <span style="color: red;">in red</span>).</p>
* (new elements are <span style="color: blue;">in blue</span>).</p>
*
* <pre>
* &lt;body&gt;
* / \
* <span style="color: red;">&lt;ul&gt;</span> <b>&lt;div&gt;</b>
* <span style="color: blue;">&lt;ul&gt;</span> <b>&lt;div&gt;</b>
* / / \
* <span style="color: red;">&lt;li&gt;</span> &lt;p&gt; &lt;p&gt;
* <span style="color: blue;">&lt;li&gt;</span> &lt;p&gt; &lt;p&gt;
* </pre>
*
* <p>Unlike the <code>insertAfterStart</code> method, new
@ -1362,14 +1362,14 @@ public class HTMLDocument extends DefaultStyledDocument {
*
* <p>Invoking <code>insertAfterEnd(elem, "&lt;ul&gt;&lt;li&gt;")</code>
* results in the following structure (new elements are <span
* style="color: red;">in red</span>).</p>
* style="color: blue;">in blue</span>).</p>
*
* <pre>
* &lt;body&gt;
* / \
* <b>&lt;div&gt;</b> <span style="color: red;">&lt;ul&gt;</span>
* <b>&lt;div&gt;</b> <span style="color: blue;">&lt;ul&gt;</span>
* / \ \
* &lt;p&gt; &lt;p&gt; <span style="color: red;">&lt;li&gt;</span>
* &lt;p&gt; &lt;p&gt; <span style="color: blue;">&lt;li&gt;</span>
* </pre>
*
* <p>Unlike the <code>insertBeforeEnd</code> method, new elements