8184219: Fix accessibility of tables in the java.desktop module

Reviewed-by: jjg
This commit is contained in:
Sergey Bylokhov 2017-10-20 15:39:50 -07:00
parent 5852f663bf
commit 49c29ca974
39 changed files with 1597 additions and 1554 deletions

View file

@ -117,24 +117,30 @@ public interface AppletContext {
* <table class="striped">
* <caption>Target arguments and their descriptions</caption>
* <thead>
* <tr><th>Target Argument</th>
* <th>Description</th></tr>
* <tr>
* <th scope="col">Target Argument
* <th scope="col">Description
* </thead>
* <tbody>
* <tr><td>{@code "_self"} <td>Show in the window and frame that
* contain the applet.</tr>
* <tr><td>{@code "_parent"}<td>Show in the applet's parent frame. If
* the applet's frame has no parent frame,
* acts the same as "_self".</tr>
* <tr><td>{@code "_top"} <td>Show in the top-level frame of the applet's
* window. If the applet's frame is the
* top-level frame, acts the same as "_self".</tr>
* <tr><td>{@code "_blank"} <td>Show in a new, unnamed
* top-level window.</tr>
* <tr><td><i>name</i><td>Show in the frame or window named <i>name</i>. If
* a target named <i>name</i> does not already exist, a
* new top-level window with the specified name is created,
* and the document is shown there.</tr>
* <tr>
* <th scope="row">{@code "_self"}
* <td>Show in the window and frame that contain the applet.
* <tr>
* <th scope="row">{@code "_parent"}
* <td>Show in the applet's parent frame. If the applet's frame has no
* parent frame, acts the same as "_self".
* <tr>
* <th scope="row">{@code "_top"}
* <td>Show in the top-level frame of the applet's window. If the
* applet's frame is the top-level frame, acts the same as "_self".
* <tr>
* <th scope="row">{@code "_blank"}
* <td>Show in a new, unnamed top-level window.
* <tr>
* <th scope="row"><i>name</i>
* <td>Show in the frame or window named <i>name</i>. If a target named
* <i>name</i> does not already exist, a new top-level window with the
* specified name is created, and the document is shown there.
* </tbody>
* </table>
* <p>

View file

@ -94,25 +94,23 @@ public class AWTKeyStroke implements Serializable {
* <table class="striped">
* <caption>AWTKeyStroke default values</caption>
* <thead>
* <tr><th>Property</th><th>Default Value</th></tr>
* <tr>
* <th scope="col">Property
* <th scope="col">Default Value
* </thead>
* <tbody>
* <tr>
* <td>Key Char</td>
* <td>{@code KeyEvent.CHAR_UNDEFINED}</td>
* </tr>
* <tr>
* <td>Key Code</td>
* <td>{@code KeyEvent.VK_UNDEFINED}</td>
* </tr>
* <tr>
* <td>Modifiers</td>
* <td>none</td>
* </tr>
* <tr>
* <td>On key release?</td>
* <td>{@code false}</td>
* </tr>
* <tr>
* <th scope="row">Key Char
* <td>{@code KeyEvent.CHAR_UNDEFINED}
* <tr>
* <th scope="row">Key Code
* <td>{@code KeyEvent.VK_UNDEFINED}
* <tr>
* <th scope="row">Modifiers
* <td>none
* <tr>
* <th scope="row">On key release?
* <td>{@code false}
* </tbody>
* </table>
*

View file

@ -48,144 +48,116 @@ import java.security.BasicPermission;
* <caption>AWTPermission target names, descriptions, and associated risks
* </caption>
* <thead>
* <tr>
* <th>Permission Target Name</th>
* <th>What the Permission Allows</th>
* <th>Risks of Allowing this Permission</th>
* </tr>
* <tr>
* <th scope="col">Permission Target Name
* <th scope="col">What the Permission Allows
* <th scope="col">Risks of Allowing this Permission
* </thead>
* <tbody>
* <tr>
* <td>accessClipboard</td>
* <td>Posting and retrieval of information to and from the AWT clipboard</td>
* <td>This would allow malfeasant code to share
* potentially sensitive or confidential information.</td>
* </tr>
*
* <tr>
* <td>accessEventQueue</td>
* <td>Access to the AWT event queue</td>
* <td>After retrieving the AWT event queue,
* malicious code may peek at and even remove existing events
* from its event queue, as well as post bogus events which may purposefully
* cause the application or applet to misbehave in an insecure manner.</td>
* </tr>
*
* <tr>
* <td>accessSystemTray</td>
* <td>Access to the AWT SystemTray instance</td>
* <td>This would allow malicious code to add tray icons to the system tray.
* First, such an icon may look like the icon of some known application
* (such as a firewall or anti-virus) and order a user to do something unsafe
* (with help of balloon messages). Second, the system tray may be glutted with
* tray icons so that no one could add a tray icon anymore.</td>
* </tr>
*
* <tr>
* <td>createRobot</td>
* <td>Create java.awt.Robot objects</td>
* <td>The java.awt.Robot object allows code to generate native-level
* mouse and keyboard events as well as read the screen. It could allow
* malicious code to control the system, run other programs, read the
* display, and deny mouse and keyboard access to the user.</td>
* </tr>
*
* <tr>
* <td>fullScreenExclusive</td>
* <td>Enter full-screen exclusive mode</td>
* <td>Entering full-screen exclusive mode allows direct access to
* low-level graphics card memory. This could be used to spoof the
* system, since the program is in direct control of rendering. Depending on
* the implementation, the security warning may not be shown for the windows
* used to enter the full-screen exclusive mode (assuming that the {@code
* fullScreenExclusive} permission has been granted to this application). Note
* that this behavior does not mean that the {@code
* showWindowWithoutWarningBanner} permission will be automatically granted to
* the application which has the {@code fullScreenExclusive} permission:
* non-full-screen windows will continue to be shown with the security
* warning.</td>
* </tr>
*
* <tr>
* <td>listenToAllAWTEvents</td>
* <td>Listen to all AWT events, system-wide</td>
* <td>After adding an AWT event listener,
* malicious code may scan all AWT events dispatched in the system,
* allowing it to read all user input (such as passwords). Each
* AWT event listener is called from within the context of that
* event queue's EventDispatchThread, so if the accessEventQueue
* permission is also enabled, malicious code could modify the
* contents of AWT event queues system-wide, causing the application
* or applet to misbehave in an insecure manner.</td>
* </tr>
*
* <tr>
* <td>readDisplayPixels</td>
* <td>Readback of pixels from the display screen</td>
* <td>Interfaces such as the java.awt.Composite interface or the
* java.awt.Robot class allow arbitrary code to examine pixels on the
* display enable malicious code to snoop on the activities of the user.</td>
* </tr>
*
* <tr>
* <td>replaceKeyboardFocusManager</td>
* <td>Sets the {@code KeyboardFocusManager} for
* a particular thread.
* <td>When {@code SecurityManager} is installed, the invoking
* thread must be granted this permission in order to replace
* the current {@code KeyboardFocusManager}. If permission
* is not granted, a {@code SecurityException} will be thrown.
* </tr>
*
* <tr>
* <td>setAppletStub</td>
* <td>Setting the stub which implements Applet container services</td>
* <td>Malicious code could set an applet's stub and result in unexpected
* behavior or denial of service to an applet.</td>
* </tr>
*
* <tr>
* <td>setWindowAlwaysOnTop</td>
* <td>Setting always-on-top property of the window: {@link Window#setAlwaysOnTop}</td>
* <td>The malicious window might make itself look and behave like a real full desktop, so that
* information entered by the unsuspecting user is captured and subsequently misused </td>
* </tr>
*
* <tr>
* <td>showWindowWithoutWarningBanner</td>
* <td>Display of a window without also displaying a banner warning
* that the window was created by an applet</td>
* <td>Without this warning,
* an applet may pop up windows without the user knowing that they
* belong to an applet. Since users may make security-sensitive
* decisions based on whether or not the window belongs to an applet
* (entering a username and password into a dialog box, for example),
* disabling this warning banner may allow applets to trick the user
* into entering such information.</td>
* </tr>
*
* <tr>
* <td>toolkitModality</td>
* <td>Creating {@link Dialog.ModalityType#TOOLKIT_MODAL TOOLKIT_MODAL} dialogs
* and setting the {@link Dialog.ModalExclusionType#TOOLKIT_EXCLUDE
* TOOLKIT_EXCLUDE} window property.</td>
* <td>When a toolkit-modal dialog is shown from an applet, it blocks all other
* applets in the browser. When launching applications from Java Web Start,
* its windows (such as the security dialog) may also be blocked by toolkit-modal
* dialogs, shown from these applications.</td>
* </tr>
*
* <tr>
* <td>watchMousePointer</td>
* <td>Getting the information about the mouse pointer position at any
* time</td>
* <td>Constantly watching the mouse pointer,
* an applet can make guesses about what the user is doing, i.e. moving
* the mouse to the lower left corner of the screen most likely means that
* the user is about to launch an application. If a virtual keypad is used
* so that keyboard is emulated using the mouse, an applet may guess what
* is being typed.</td>
* </tr>
* <tr>
* <th scope="row">accessClipboard
* <td>Posting and retrieval of information to and from the AWT clipboard
* <td>This would allow malfeasant code to share potentially sensitive or
* confidential information.
* <tr>
* <th scope="row">accessEventQueue
* <td>Access to the AWT event queue
* <td>After retrieving the AWT event queue, malicious code may peek at and
* even remove existing events from its event queue, as well as post bogus
* events which may purposefully cause the application or applet to
* misbehave in an insecure manner.
* <tr>
* <th scope="row">accessSystemTray
* <td>Access to the AWT SystemTray instance
* <td>This would allow malicious code to add tray icons to the system tray.
* First, such an icon may look like the icon of some known application
* (such as a firewall or anti-virus) and order a user to do something
* unsafe (with help of balloon messages). Second, the system tray may be
* glutted with tray icons so that no one could add a tray icon anymore.
* <tr>
* <th scope="row">createRobot
* <td>Create java.awt.Robot objects
* <td>The java.awt.Robot object allows code to generate native-level mouse
* and keyboard events as well as read the screen. It could allow malicious
* code to control the system, run other programs, read the display, and
* deny mouse and keyboard access to the user.
* <tr>
* <th scope="row">fullScreenExclusive
* <td>Enter full-screen exclusive mode
* <td>Entering full-screen exclusive mode allows direct access to low-level
* graphics card memory. This could be used to spoof the system, since the
* program is in direct control of rendering. Depending on the
* implementation, the security warning may not be shown for the windows
* used to enter the full-screen exclusive mode (assuming that the
* {@code fullScreenExclusive} permission has been granted to this
* application). Note that this behavior does not mean that the
* {@code showWindowWithoutWarningBanner} permission will be automatically
* granted to the application which has the {@code fullScreenExclusive}
* permission: non-full-screen windows will continue to be shown with the
* security warning.
* <tr>
* <th scope="row">listenToAllAWTEvents
* <td>Listen to all AWT events, system-wide
* <td>After adding an AWT event listener, malicious code may scan all AWT
* events dispatched in the system, allowing it to read all user input (such
* as passwords). Each AWT event listener is called from within the context
* of that event queue's EventDispatchThread, so if the accessEventQueue
* permission is also enabled, malicious code could modify the contents of
* AWT event queues system-wide, causing the application or applet to
* misbehave in an insecure manner.
* <tr>
* <th scope="row">readDisplayPixels
* <td>Readback of pixels from the display screen
* <td>Interfaces such as the java.awt.Composite interface or the
* java.awt.Robot class allow arbitrary code to examine pixels on the
* display enable malicious code to snoop on the activities of the user.
* <tr>
* <th scope="row">replaceKeyboardFocusManager
* <td>Sets the {@code KeyboardFocusManager} for a particular thread.
* <td>When {@code SecurityManager} is installed, the invoking thread must
* be granted this permission in order to replace the current
* {@code KeyboardFocusManager}. If permission is not granted, a
* {@code SecurityException} will be thrown.
* <tr>
* <th scope="row">setAppletStub
* <td>Setting the stub which implements Applet container services
* <td>Malicious code could set an applet's stub and result in unexpected
* behavior or denial of service to an applet.
* <tr>
* <th scope="row">setWindowAlwaysOnTop
* <td>Setting always-on-top property of the window:
* {@link Window#setAlwaysOnTop}
* <td>The malicious window might make itself look and behave like a real
* full desktop, so that information entered by the unsuspecting user is
* captured and subsequently misused
* <tr>
* <th scope="row">showWindowWithoutWarningBanner
* <td>Display of a window without also displaying a banner warning that the
* window was created by an applet
* <td>Without this warning, an applet may pop up windows without the user
* knowing that they belong to an applet. Since users may make
* security-sensitive decisions based on whether or not the window belongs
* to an applet (entering a username and password into a dialog box, for
* example), disabling this warning banner may allow applets to trick the
* user into entering such information.
* <tr>
* <th scope="row">toolkitModality
* <td>Creating {@link Dialog.ModalityType#TOOLKIT_MODAL TOOLKIT_MODAL}
* dialogs and setting the
* {@link Dialog.ModalExclusionType#TOOLKIT_EXCLUDE TOOLKIT_EXCLUDE} window
* property.
* <td>When a toolkit-modal dialog is shown from an applet, it blocks all
* other applets in the browser. When launching applications from Java Web
* Start, its windows (such as the security dialog) may also be blocked by
* toolkit-modal dialogs, shown from these applications.
* <tr>
* <th scope="row">watchMousePointer
* <td>Getting the information about the mouse pointer position at any time
* <td>Constantly watching the mouse pointer, an applet can make guesses
* about what the user is doing, i.e. moving the mouse to the lower left
* corner of the screen most likely means that the user is about to launch
* an application. If a virtual keypad is used so that keyboard is emulated
* using the mouse, an applet may guess what is being typed.
* </tbody>
* </table>
*
@ -195,11 +167,9 @@ import java.security.BasicPermission;
* @see java.security.PermissionCollection
* @see java.lang.SecurityManager
*
*
* @author Marianne Mueller
* @author Roland Schemers
*/
public final class AWTPermission extends BasicPermission {
/** use serialVersionUID from the Java 2 platform for interoperability */

View file

@ -72,22 +72,40 @@ import sun.java2d.SunCompositeContext;
* The following factors are used in the description of the blending
* equation in the Porter and Duff paper:
*
* <blockquote>
* <table class="borderless">
* <table class="striped">
* <caption style="display:none">Factors</caption>
* <tr><th style="text-align:left">Factor&nbsp;&nbsp;<th style="text-align:left">Definition
* <tr><td><em>A<sub>s</sub></em><td>the alpha component of the source pixel
* <tr><td><em>C<sub>s</sub></em><td>a color component of the source pixel in premultiplied form
* <tr><td><em>A<sub>d</sub></em><td>the alpha component of the destination pixel
* <tr><td><em>C<sub>d</sub></em><td>a color component of the destination pixel in premultiplied form
* <tr><td><em>F<sub>s</sub></em><td>the fraction of the source pixel that contributes to the output
* <tr><td><em>F<sub>d</sub></em><td>the fraction of the destination pixel that contributes
* to the output
* <tr><td><em>A<sub>r</sub></em><td>the alpha component of the result
* <tr><td><em>C<sub>r</sub></em><td>a color component of the result in premultiplied form
* <thead>
* <tr>
* <th scope="col">Factor
* <th scope="col">Definition
* </thead>
* <tbody>
* <tr>
* <th scope="row"><em>A<sub>s</sub></em>
* <td>the alpha component of the source pixel
* <tr>
* <th scope="row"><em>C<sub>s</sub></em>
* <td>a color component of the source pixel in premultiplied form
* <tr>
* <th scope="row"><em>A<sub>d</sub></em>
* <td>the alpha component of the destination pixel
* <tr>
* <th scope="row"><em>C<sub>d</sub></em>
* <td>a color component of the destination pixel in premultiplied form
* <tr>
* <th scope="row"><em>F<sub>s</sub></em>
* <td>the fraction of the source pixel that contributes to the output
* <tr>
* <th scope="row"><em>F<sub>d</sub></em>
* <td>the fraction of the destination pixel that contributes to the output
* <tr>
* <th scope="row"><em>A<sub>r</sub></em>
* <td>the alpha component of the result
* <tr>
* <th scope="row"><em>C<sub>r</sub></em>
* <td>a color component of the result in premultiplied form
* </tbody>
* </table>
* </blockquote>
*
* <p>
* Using these factors, Porter and Duff define 12 ways of choosing
* the blending factors <em>F<sub>s</sub></em> and <em>F<sub>d</sub></em> to
@ -113,19 +131,37 @@ import sun.java2d.SunCompositeContext;
* The following factors will be used to discuss our extensions to
* the blending equation in the Porter and Duff paper:
*
* <blockquote>
* <table class="borderless">
* <table class="striped">
* <caption style="display:none">Factors</caption>
* <tr><th style="text-align:left">Factor&nbsp;&nbsp;<th style="text-align:left">Definition
* <tr><td><em>C<sub>sr</sub></em> <td>one of the raw color components of the source pixel
* <tr><td><em>C<sub>dr</sub></em> <td>one of the raw color components of the destination pixel
* <tr><td><em>A<sub>ac</sub></em> <td>the "extra" alpha component from the AlphaComposite instance
* <tr><td><em>A<sub>sr</sub></em> <td>the raw alpha component of the source pixel
* <tr><td><em>A<sub>dr</sub></em><td>the raw alpha component of the destination pixel
* <tr><td><em>A<sub>df</sub></em> <td>the final alpha component stored in the destination
* <tr><td><em>C<sub>df</sub></em> <td>the final raw color component stored in the destination
* <thead>
* <tr>
* <th scope="col">Factor
* <th scope="col">Definition
* </thead>
* <tbody>
* <tr>
* <th scope="row"><em>C<sub>sr</sub></em>
* <td>one of the raw color components of the source pixel
* <tr>
* <th scope="row"><em>C<sub>dr</sub></em>
* <td>one of the raw color components of the destination pixel
* <tr>
* <th scope="row"><em>A<sub>ac</sub></em>
* <td>the "extra" alpha component from the AlphaComposite instance
* <tr>
* <th scope="row"><em>A<sub>sr</sub></em>
* <td>the raw alpha component of the source pixel
* <tr>
* <th scope="row"><em>A<sub>dr</sub></em>
* <td>the raw alpha component of the destination pixel
* <tr>
* <th scope="row"><em>A<sub>df</sub></em>
* <td>the final alpha component stored in the destination
* <tr>
* <th scope="row"><em>C<sub>df</sub></em>
* <td>the final raw color component stored in the destination
* </tbody>
* </table>
*</blockquote>
*
* <h3>Preparing Inputs</h3>
*

View file

@ -7247,28 +7247,24 @@ public abstract class Component implements ImageObserver, MenuContainer,
* <caption>Recommended default values for a Component's focus traversal
* keys</caption>
* <thead>
* <tr>
* <th>Identifier</th>
* <th>Meaning</th>
* <th>Default</th>
* </tr>
* <tr>
* <th scope="col">Identifier
* <th scope="col">Meaning
* <th scope="col">Default
* </thead>
* <tbody>
* <tr>
* <td>KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS</td>
* <td>Normal forward keyboard traversal</td>
* <td>TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED</td>
* </tr>
* <tr>
* <td>KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS</td>
* <td>Normal reverse keyboard traversal</td>
* <td>SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED</td>
* </tr>
* <tr>
* <td>KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS</td>
* <td>Go up one focus traversal cycle</td>
* <td>none</td>
* </tr>
* <tr>
* <th scope="row">KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
* <td>Normal forward keyboard traversal
* <td>TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED
* <tr>
* <th scope="row">KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
* <td>Normal reverse keyboard traversal
* <td>SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED
* <tr>
* <th scope="row">KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
* <td>Go up one focus traversal cycle
* <td>none
* </tbody>
* </table>
*

View file

@ -3069,33 +3069,28 @@ public class Container extends Component {
* <caption>Recommended default values for a Container's focus traversal
* keys</caption>
* <thead>
* <tr>
* <th>Identifier</th>
* <th>Meaning</th>
* <th>Default</th>
* </tr>
* <tr>
* <th scope="col">Identifier
* <th scope="col">Meaning
* <th scope="col">Default
* </thead>
* <tbody>
* <tr>
* <td>KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS</td>
* <td>Normal forward keyboard traversal</td>
* <td>TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED</td>
* </tr>
* <tr>
* <td>KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS</td>
* <td>Normal reverse keyboard traversal</td>
* <td>SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED</td>
* </tr>
* <tr>
* <td>KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS</td>
* <td>Go up one focus traversal cycle</td>
* <td>none</td>
* </tr>
* <tr>
* <td>KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS</td>
* <td>Go down one focus traversal cycle</td>
* <td>none</td>
* </tr>
* <tr>
* <th scope="row">KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS
* <td>Normal forward keyboard traversal
* <td>TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED
* <tr>
* <th scope="row">KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS
* <td>Normal reverse keyboard traversal
* <td>SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED
* <tr>
* <th scope="row">KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
* <td>Go up one focus traversal cycle
* <td>none
* <tr>
* <th scope="row">KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS
* <td>Go down one focus traversal cycle
* <td>none
* </tbody>
* </table>
*

View file

@ -680,33 +680,28 @@ public class EventQueue {
* <table class="striped">
* <caption>Event types, source types, and dispatch methods</caption>
* <thead>
* <tr>
* <th>Event Type</th>
* <th>Source Type</th>
* <th>Dispatched To</th>
* </tr>
* <tr>
* <th scope="col">Event Type
* <th scope="col">Source Type
* <th scope="col">Dispatched To
* </thead>
* <tbody>
* <tr>
* <td>ActiveEvent</td>
* <td>Any</td>
* <td>event.dispatch()</td>
* </tr>
* <tr>
* <td>Other</td>
* <td>Component</td>
* <td>source.dispatchEvent(AWTEvent)</td>
* </tr>
* <tr>
* <td>Other</td>
* <td>MenuComponent</td>
* <td>source.dispatchEvent(AWTEvent)</td>
* </tr>
* <tr>
* <td>Other</td>
* <td>Other</td>
* <td>No action (ignored)</td>
* </tr>
* <tr>
* <th scope="row">ActiveEvent
* <td>Any
* <td>event.dispatch()
* <tr>
* <th scope="row">Other
* <td>Component
* <td>source.dispatchEvent(AWTEvent)
* <tr>
* <th scope="row">Other
* <td>MenuComponent
* <td>source.dispatchEvent(AWTEvent)
* <tr>
* <th scope="row">Other
* <td>Other
* <td>No action (ignored)
* </tbody>
* </table>
*

View file

@ -1042,35 +1042,30 @@ public abstract class KeyboardFocusManager
* <table class="striped">
* <caption>Recommended default values for focus traversal keys</caption>
* <thead>
* <tr>
* <th>Identifier</th>
* <th>Meaning</th>
* <th>Default</th>
* </tr>
* <tr>
* <th scope="col">Identifier
* <th scope="col">Meaning
* <th scope="col">Default
* </thead>
* <tbody>
* <tr>
* <td>{@code KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS}</td>
* <td>Normal forward keyboard traversal</td>
* <td>{@code TAB} on {@code KEY_PRESSED},
* {@code CTRL-TAB} on {@code KEY_PRESSED}</td>
* </tr>
* <tr>
* <td>{@code KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS}</td>
* <td>Normal reverse keyboard traversal</td>
* <td>{@code SHIFT-TAB} on {@code KEY_PRESSED},
* {@code CTRL-SHIFT-TAB} on {@code KEY_PRESSED}</td>
* </tr>
* <tr>
* <td>{@code KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS}</td>
* <td>Go up one focus traversal cycle</td>
* <td>none</td>
* </tr>
* <tr>
* <td>{@code KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS}</td>
* <td>Go down one focus traversal cycle</td>
* <td>none</td>
* </tr>
* <tr>
* <th scope="row">{@code KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS}
* <td>Normal forward keyboard traversal
* <td>{@code TAB} on {@code KEY_PRESSED}, {@code CTRL-TAB} on
* {@code KEY_PRESSED}
* <tr>
* <th scope="row">{@code KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS}
* <td>Normal reverse keyboard traversal
* <td>{@code SHIFT-TAB} on {@code KEY_PRESSED}, {@code CTRL-SHIFT-TAB}
* on {@code KEY_PRESSED}
* <tr>
* <th scope="row">{@code KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS}
* <td>Go up one focus traversal cycle
* <td>none
* <tr>
* <th scope="row">{@code KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS}
* <td>Go down one focus traversal cycle
* <td>none
* </tbody>
* </table>
*

View file

@ -299,58 +299,44 @@ public class Scrollbar extends Component implements Adjustable, Accessible {
* <table class="striped">
* <caption>Scrollbar default properties</caption>
* <thead>
* <tr>
* <th>Property</th>
* <th>Description</th>
* <th>Default Value</th>
* </tr>
* <tr>
* <th scope="col">Property
* <th scope="col">Description
* <th scope="col">Default Value
* </thead>
* <tbody>
* <tr>
* <td>orientation</td>
* <td>indicates whether the scroll bar is vertical
* <br>or horizontal</td>
* <td>{@code Scrollbar.VERTICAL}</td>
* </tr>
* <tr>
* <td>value</td>
* <td>value which controls the location
* <br>of the scroll bar's bubble</td>
* <td>0</td>
* </tr>
* <tr>
* <td>visible amount</td>
* <td>visible amount of the scroll bar's range,
* <br>typically represented by the size of the
* <br>scroll bar's bubble</td>
* <td>10</td>
* </tr>
* <tr>
* <td>minimum</td>
* <td>minimum value of the scroll bar</td>
* <td>0</td>
* </tr>
* <tr>
* <td>maximum</td>
* <td>maximum value of the scroll bar</td>
* <td>100</td>
* </tr>
* <tr>
* <td>unit increment</td>
* <td>amount the value changes when the
* <br>Line Up or Line Down key is pressed,
* <br>or when the end arrows of the scrollbar
* <br>are clicked </td>
* <td>1</td>
* </tr>
* <tr>
* <td>block increment</td>
* <td>amount the value changes when the
* <br>Page Up or Page Down key is pressed,
* <br>or when the scrollbar track is clicked
* <br>on either side of the bubble </td>
* <td>10</td>
* </tr>
* <tr>
* <th scope="row">orientation
* <td>indicates whether the scroll bar is vertical or horizontal
* <td>{@code Scrollbar.VERTICAL}
* <tr>
* <th scope="row">value
* <td>value which controls the location of the scroll bar's bubble
* <td>0
* <tr>
* <th scope="row">visible amount
* <td>visible amount of the scroll bar's range, typically represented
* by the size of the scroll bar's bubble
* <td>10
* <tr>
* <th scope="row">minimum
* <td>minimum value of the scroll bar
* <td>0
* <tr>
* <th scope="row">maximum
* <td>maximum value of the scroll bar
* <td>100
* <tr>
* <th scope="row">unit increment
* <td>amount the value changes when the Line Up or Line Down key is
* pressed, or when the end arrows of the scrollbar are clicked
* <td>1
* <tr>
* <th scope="row">block increment
* <td>amount the value changes when the Page Up or Page Down key is
* pressed, or when the scrollbar track is clicked<br>on either side of
* the bubble
* <td>10
* </tbody>
* </table>
*

View file

@ -371,28 +371,26 @@ public class SystemTray {
* <table class="striped">
* <caption>SystemTray properties</caption>
* <thead>
* <tr>
* <th>Property</th>
* <th>Description</th>
* </tr>
* <tr>
* <th scope="col">Property
* <th scope="col">Description
* </thead>
* <tbody>
* <tr>
* <td>{@code trayIcons}</td>
* <td>The {@code SystemTray}'s array of {@code TrayIcon} objects.
* The array is accessed via the {@link #getTrayIcons} method.<br>
* This property is changed when a tray icon is added to (or removed
* from) the system tray.<br> For example, this property is changed
* when the system tray becomes unavailable on the desktop<br>
* and the tray icons are automatically removed.</td>
* </tr>
* <tr>
* <td>{@code systemTray}</td>
* <td>This property contains {@code SystemTray} instance when the system tray
* is available or {@code null} otherwise.<br> This property is changed
* when the system tray becomes available or unavailable on the desktop.<br>
* The property is accessed by the {@link #getSystemTray} method.</td>
* </tr>
* <tr>
* <th scope="row">{@code trayIcons}
* <td>The {@code SystemTray}'s array of {@code TrayIcon} objects. The
* array is accessed via the {@link #getTrayIcons} method. This property
* is changed when a tray icon is added to (or removed from) the system
* tray. For example, this property is changed when the system tray
* becomes unavailable on the desktop and the tray icons are
* automatically removed.
* <tr>
* <th scope="row">{@code systemTray}
* <td>This property contains {@code SystemTray} instance when the
* system tray is available or {@code null} otherwise. This property is
* changed when the system tray becomes available or unavailable on the
* desktop. The property is accessed by the {@link #getSystemTray}
* method.
* </tbody>
* </table>
* <p>

View file

@ -108,39 +108,36 @@ import jdk.internal.misc.SharedSecrets;
*
* <table class="plain">
* <caption>NumericShaper constants precedence</caption>
* <thead>
* <tr>
* <th class="TableHeadingColor">Unicode Range</th>
* <th class="TableHeadingColor">{@code NumericShaper} Constants</th>
* <th class="TableHeadingColor">Precedence</th>
* </tr>
* </thead>
* <tbody>
* <tr>
* <td rowspan="2">Arabic</td>
* <td>{@link NumericShaper#ARABIC NumericShaper.ARABIC}<br>
* {@link NumericShaper#EASTERN_ARABIC NumericShaper.EASTERN_ARABIC}</td>
* <td>{@link NumericShaper#EASTERN_ARABIC NumericShaper.EASTERN_ARABIC}</td>
* </tr>
* <tr>
* <td>{@link NumericShaper.Range#ARABIC}<br>
* {@link NumericShaper.Range#EASTERN_ARABIC}</td>
* <td>{@link NumericShaper.Range#EASTERN_ARABIC}</td>
* </tr>
* </tbody>
* <tbody>
* <tr>
* <td>Tai Tham</td>
* <td>{@link NumericShaper.Range#TAI_THAM_HORA}<br>
* {@link NumericShaper.Range#TAI_THAM_THAM}</td>
* <td>{@link NumericShaper.Range#TAI_THAM_THAM}</td>
* </tr>
* </tbody>
* <thead>
* <tr>
* <th scope="col">Unicode Range
* <th scope="col">{@code NumericShaper} Constants
* <th scope="col">Precedence
* </thead>
* <tbody>
* <tr>
* <th scope="row" rowspan="2">Arabic
* <td>{@link NumericShaper#ARABIC NumericShaper.ARABIC}
* <br>
* {@link NumericShaper#EASTERN_ARABIC NumericShaper.EASTERN_ARABIC}
* <td>{@link NumericShaper#EASTERN_ARABIC NumericShaper.EASTERN_ARABIC}
* </tr>
* <tr>
* <th scope="row">{@link NumericShaper.Range#ARABIC}
* <br>
* {@link NumericShaper.Range#EASTERN_ARABIC}
* <td>{@link NumericShaper.Range#EASTERN_ARABIC}
* <tr>
* <th scope="row">Tai Tham
* <td>{@link NumericShaper.Range#TAI_THAM_HORA}
* <br>
* {@link NumericShaper.Range#TAI_THAM_THAM}
* <td>{@link NumericShaper.Range#TAI_THAM_THAM}
* </tbody>
* </table>
*
* @since 1.4
*/
public final class NumericShaper implements java.io.Serializable {
// For access from java.text.Bidi

View file

@ -96,159 +96,141 @@ import jdk.internal.misc.SharedSecrets;
* </UL>
*
* <h4>Summary of attributes</h4>
* <table style="float:center;width:95%" class="striped">
* <caption>Key, value type, principal constants, and
* default value behavior of all TextAttributes</caption>
*
* <table style="width:95%;margin: 0px auto" class="striped">
* <caption>Key, value type, principal constants, and default value behavior of
* all TextAttributes</caption>
* <thead>
* <tr>
* <th valign="TOP" style="text-align:center">Key</th>
* <th valign="TOP" style="text-align:center">Value Type</th>
* <th valign="TOP" style="text-align:center">Principal Constants</th>
* <th valign="TOP" style="text-align:center">Default Value</th>
* </tr>
* <tr>
* <th scope="col">Key
* <th scope="col">Value Type
* <th scope="col">Principal Constants
* <th scope="col">Default Value
* </thead>
* <tbody>
* <tr>
* <td valign="TOP">{@link #FAMILY}</td>
* <td valign="TOP">String</td>
* <td valign="TOP">See Font {@link java.awt.Font#DIALOG DIALOG},
* {@link java.awt.Font#DIALOG_INPUT DIALOG_INPUT},<br> {@link java.awt.Font#SERIF SERIF},
* {@link java.awt.Font#SANS_SERIF SANS_SERIF}, and {@link java.awt.Font#MONOSPACED MONOSPACED}.
* </td>
* <td valign="TOP">"Default" (use platform default)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #WEIGHT}</td>
* <td valign="TOP">Number</td>
* <td valign="TOP">WEIGHT_REGULAR, WEIGHT_BOLD</td>
* <td valign="TOP">WEIGHT_REGULAR</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #WIDTH}</td>
* <td valign="TOP">Number</td>
* <td valign="TOP">WIDTH_CONDENSED, WIDTH_REGULAR,<br>WIDTH_EXTENDED</td>
* <td valign="TOP">WIDTH_REGULAR</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #POSTURE}</td>
* <td valign="TOP">Number</td>
* <td valign="TOP">POSTURE_REGULAR, POSTURE_OBLIQUE</td>
* <td valign="TOP">POSTURE_REGULAR</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #SIZE}</td>
* <td valign="TOP">Number</td>
* <td valign="TOP">none</td>
* <td valign="TOP">12.0</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #TRANSFORM}</td>
* <td valign="TOP">{@link TransformAttribute}</td>
* <td valign="TOP">See TransformAttribute {@link TransformAttribute#IDENTITY IDENTITY}</td>
* <td valign="TOP">TransformAttribute.IDENTITY</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #SUPERSCRIPT}</td>
* <td valign="TOP">Integer</td>
* <td valign="TOP">SUPERSCRIPT_SUPER, SUPERSCRIPT_SUB</td>
* <td valign="TOP">0 (use the standard glyphs and metrics)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #FONT}</td>
* <td valign="TOP">{@link java.awt.Font}</td>
* <td valign="TOP">none</td>
* <td valign="TOP">null (do not override font resolution)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #CHAR_REPLACEMENT}</td>
* <td valign="TOP">{@link GraphicAttribute}</td>
* <td valign="TOP">none</td>
* <td valign="TOP">null (draw text using font glyphs)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #FOREGROUND}</td>
* <td valign="TOP">{@link java.awt.Paint}</td>
* <td valign="TOP">none</td>
* <td valign="TOP">null (use current graphics paint)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #BACKGROUND}</td>
* <td valign="TOP">{@link java.awt.Paint}</td>
* <td valign="TOP">none</td>
* <td valign="TOP">null (do not render background)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #UNDERLINE}</td>
* <td valign="TOP">Integer</td>
* <td valign="TOP">UNDERLINE_ON</td>
* <td valign="TOP">-1 (do not render underline)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #STRIKETHROUGH}</td>
* <td valign="TOP">Boolean</td>
* <td valign="TOP">STRIKETHROUGH_ON</td>
* <td valign="TOP">false (do not render strikethrough)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #RUN_DIRECTION}</td>
* <td valign="TOP">Boolean</td>
* <td valign="TOP">RUN_DIRECTION_LTR<br>RUN_DIRECTION_RTL</td>
* <td valign="TOP">null (use {@link java.text.Bidi} standard default)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #BIDI_EMBEDDING}</td>
* <td valign="TOP">Integer</td>
* <td valign="TOP">none</td>
* <td valign="TOP">0 (use base line direction)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #JUSTIFICATION}</td>
* <td valign="TOP">Number</td>
* <td valign="TOP">JUSTIFICATION_FULL</td>
* <td valign="TOP">JUSTIFICATION_FULL</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #INPUT_METHOD_HIGHLIGHT}</td>
* <td valign="TOP">{@link java.awt.im.InputMethodHighlight},<br>{@link java.text.Annotation}</td>
* <td valign="TOP">(see class)</td>
* <td valign="TOP">null (do not apply input highlighting)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #INPUT_METHOD_UNDERLINE}</td>
* <td valign="TOP">Integer</td>
* <td valign="TOP">UNDERLINE_LOW_ONE_PIXEL,<br>UNDERLINE_LOW_TWO_PIXEL</td>
* <td valign="TOP">-1 (do not render underline)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #SWAP_COLORS}</td>
* <td valign="TOP">Boolean</td>
* <td valign="TOP">SWAP_COLORS_ON</td>
* <td valign="TOP">false (do not swap colors)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #NUMERIC_SHAPING}</td>
* <td valign="TOP">{@link java.awt.font.NumericShaper}</td>
* <td valign="TOP">none</td>
* <td valign="TOP">null (do not shape digits)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #KERNING}</td>
* <td valign="TOP">Integer</td>
* <td valign="TOP">KERNING_ON</td>
* <td valign="TOP">0 (do not request kerning)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #LIGATURES}</td>
* <td valign="TOP">Integer</td>
* <td valign="TOP">LIGATURES_ON</td>
* <td valign="TOP">0 (do not form optional ligatures)</td>
* </tr>
* <tr>
* <td valign="TOP">{@link #TRACKING}</td>
* <td valign="TOP">Number</td>
* <td valign="TOP">TRACKING_LOOSE, TRACKING_TIGHT</td>
* <td valign="TOP">0 (do not add tracking)</td>
* </tr>
* <tr>
* <th scope="row">{@link #FAMILY}
* <td>String
* <td>See Font {@link java.awt.Font#DIALOG DIALOG},
* {@link java.awt.Font#DIALOG_INPUT DIALOG_INPUT},
* <br>
* {@link java.awt.Font#SERIF SERIF},
* {@link java.awt.Font#SANS_SERIF SANS_SERIF}, and
* {@link java.awt.Font#MONOSPACED MONOSPACED}.
* <td>"Default" (use platform default)
* <tr>
* <th scope="row">{@link #WEIGHT}
* <td>Number
* <td>WEIGHT_REGULAR, WEIGHT_BOLD
* <td>WEIGHT_REGULAR
* <tr>
* <th scope="row">{@link #WIDTH}
* <td>Number
* <td>WIDTH_CONDENSED, WIDTH_REGULAR,<br>WIDTH_EXTENDED
* <td>WIDTH_REGULAR
* <tr>
* <th scope="row">{@link #POSTURE}
* <td>Number
* <td>POSTURE_REGULAR, POSTURE_OBLIQUE
* <td>POSTURE_REGULAR
* <tr>
* <th scope="row">{@link #SIZE}
* <td>Number
* <td>none
* <td>12.0
* <tr>
* <th scope="row">{@link #TRANSFORM}
* <td>{@link TransformAttribute}
* <td>See TransformAttribute {@link TransformAttribute#IDENTITY IDENTITY}
* <td>TransformAttribute.IDENTITY
* <tr>
* <th scope="row">{@link #SUPERSCRIPT}
* <td>Integer
* <td>SUPERSCRIPT_SUPER, SUPERSCRIPT_SUB
* <td>0 (use the standard glyphs and metrics)
* <tr>
* <th scope="row">{@link #FONT}
* <td>{@link java.awt.Font}
* <td>none
* <td>null (do not override font resolution)
* <tr>
* <th scope="row">{@link #CHAR_REPLACEMENT}
* <td>{@link GraphicAttribute}
* <td>none
* <td>null (draw text using font glyphs)
* <tr>
* <th scope="row">{@link #FOREGROUND}
* <td>{@link java.awt.Paint}
* <td>none
* <td>null (use current graphics paint)
* <tr>
* <th scope="row">{@link #BACKGROUND}
* <td>{@link java.awt.Paint}
* <td>none
* <td>null (do not render background)
* <tr>
* <th scope="row">{@link #UNDERLINE}
* <td>Integer
* <td>UNDERLINE_ON
* <td>-1 (do not render underline)
* <tr>
* <th scope="row">{@link #STRIKETHROUGH}
* <td>Boolean
* <td>STRIKETHROUGH_ON
* <td>false (do not render strikethrough)
* <tr>
* <th scope="row">{@link #RUN_DIRECTION}
* <td>Boolean
* <td>RUN_DIRECTION_LTR<br>RUN_DIRECTION_RTL
* <td>null (use {@link java.text.Bidi} standard default)
* <tr>
* <th scope="row">{@link #BIDI_EMBEDDING}
* <td>Integer
* <td>none
* <td>0 (use base line direction)
* <tr>
* <th scope="row">{@link #JUSTIFICATION}
* <td>Number
* <td>JUSTIFICATION_FULL
* <td>JUSTIFICATION_FULL
* <tr>
* <th scope="row">{@link #INPUT_METHOD_HIGHLIGHT}
* <td>{@link java.awt.im.InputMethodHighlight},
* <br>
* {@link java.text.Annotation}
* <td>(see class)
* <td>null (do not apply input highlighting)
* <tr>
* <th scope="row">{@link #INPUT_METHOD_UNDERLINE}
* <td>Integer
* <td>UNDERLINE_LOW_ONE_PIXEL,<br>UNDERLINE_LOW_TWO_PIXEL
* <td>-1 (do not render underline)
* <tr>
* <th scope="row">{@link #SWAP_COLORS}
* <td>Boolean
* <td>SWAP_COLORS_ON
* <td>false (do not swap colors)
* <tr>
* <th scope="row">{@link #NUMERIC_SHAPING}
* <td>{@link java.awt.font.NumericShaper}
* <td>none
* <td>null (do not shape digits)
* <tr>
* <th scope="row">{@link #KERNING}
* <td>Integer
* <td>KERNING_ON
* <td>0 (do not request kerning)
* <tr>
* <th scope="row">{@link #LIGATURES}
* <td>Integer
* <td>LIGATURES_ON
* <td>0 (do not form optional ligatures)
* <tr>
* <th scope="row">{@link #TRACKING}
* <td>Number
* <td>TRACKING_LOOSE, TRACKING_TIGHT
* <td>0 (do not add tracking)
* </tr>
* </tbody>
* </table>
*