< prev index next >

src/java.desktop/share/classes/java/awt/doc-files/DesktopProperties.html

Print this page
rev 55470 : 8225372: accessibility errors in tables in java.desktop files
Reviewed-by: aivanov
   1 <!doctype html>
   2 <html lang="en">
   3 <head>
   4   <meta charset="utf-8"/>
   5   <title>AWT Desktop Properties</title>
   6 </head>
   7 <!--
   8  Copyright (c) 2005, 2018, Oracle and/or its affiliates. All rights reserved.
   9  DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  10 
  11  This code is free software; you can redistribute it and/or modify it
  12  under the terms of the GNU General Public License version 2 only, as
  13  published by the Free Software Foundation.  Oracle designates this
  14  particular file as subject to the "Classpath" exception as provided
  15  by Oracle in the LICENSE file that accompanied this code.
  16 
  17  This code is distributed in the hope that it will be useful, but WITHOUT
  18  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  19  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  20  version 2 for more details (a copy is included in the LICENSE file that
  21  accompanied this code).
  22 
  23  You should have received a copy of the GNU General Public License version
  24  2 along with this work; if not, write to the Free Software Foundation,
  25  Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  26 
  27  Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  28  or visit www.oracle.com if you need additional information or have any


  40 <p>
  41 Each desktop property is named by a unique string, which
  42 is the "name" of that property.
  43 <p>
  44 Desktop properties supported by the AWT but not documented
  45 elsewhere - typically because there is no suitable
  46 method or class - are documented here.
  47 <p>
  48 Desktop properties documented elsewhere are those which are
  49 tightly coupled with a method or class which documents them.
  50 <p>
  51 Since desktop properties abstract an underlying platform
  52 setting, they may not be available in environments that do
  53 not support them. In the event that a desktop property is
  54 unavailable for any reason, the implementation will return
  55 <code>null</code>.
  56 <p>
  57 The following table summarizes the desktop properties documented
  58 here, and their value types.
  59 <br><br>
  60 <table>
  61 <tr bgcolor="#ccccff">
  62 <th>Property Name</th>
  63 <th>Value Type</th>
  64 <th>Summary Description</th>

  65 </tr>


  66 <tr>
  67 <td><A href="#awt.font.desktophints">awt.font.desktophints</A></td>
  68 <td>{@link java.util.Map java.util.Map}</td>
  69 <td>Font smoothing (text antialiasing) settings.</td>
  70 </tr>
  71 <tr>
  72 <td><A href="#sun.awt.enableExtraMouseButtons">sun.awt.enableExtraMouseButtons</A></td>
  73 <td>{@link java.lang.Boolean java.lang.Boolean}</td>
  74 <td>Controls if mouse events from extra buttons are to be generated or not</td>
  75 </tr>

  76 </table>
  77 
  78 <h2>Desktop Font Rendering Hints</h2>
  79 <b>Desktop Property: <a id="awt.font.desktophints">"awt.font.desktophints"</A></b>
  80 <p>
  81 Modern desktops support various forms of text antialiasing (font smoothing).
  82 <p>
  83 These are applied by platform-specific heavyweight components.
  84 However an application may want to render text using the same text
  85 antialiasing on a drawing surface or lightweight (non-platform) component using
  86 <a href="../Graphics2D.html"> <code>Graphics2D</code></a> methods.
  87 This is particularly important when creating
  88 <a href="../../../javax/swing/JComponent.html"> Swing components</a> which
  89 are required to appear consistent with native desktop components or other
  90 Swing components.
  91 
  92 <h3>Basic Usage</h3>
  93 The standard desktop property named
  94 <b>"awt.font.desktophints"</b>
  95 can be used to obtain the rendering hints that best match the desktop settings.


   1 <!doctype html>
   2 <html lang="en">
   3 <head>
   4   <meta charset="utf-8"/>
   5   <title>AWT Desktop Properties</title>
   6 </head>
   7 <!--
   8  Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved.
   9  DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  10 
  11  This code is free software; you can redistribute it and/or modify it
  12  under the terms of the GNU General Public License version 2 only, as
  13  published by the Free Software Foundation.  Oracle designates this
  14  particular file as subject to the "Classpath" exception as provided
  15  by Oracle in the LICENSE file that accompanied this code.
  16 
  17  This code is distributed in the hope that it will be useful, but WITHOUT
  18  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  19  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  20  version 2 for more details (a copy is included in the LICENSE file that
  21  accompanied this code).
  22 
  23  You should have received a copy of the GNU General Public License version
  24  2 along with this work; if not, write to the Free Software Foundation,
  25  Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  26 
  27  Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  28  or visit www.oracle.com if you need additional information or have any


  40 <p>
  41 Each desktop property is named by a unique string, which
  42 is the "name" of that property.
  43 <p>
  44 Desktop properties supported by the AWT but not documented
  45 elsewhere - typically because there is no suitable
  46 method or class - are documented here.
  47 <p>
  48 Desktop properties documented elsewhere are those which are
  49 tightly coupled with a method or class which documents them.
  50 <p>
  51 Since desktop properties abstract an underlying platform
  52 setting, they may not be available in environments that do
  53 not support them. In the event that a desktop property is
  54 unavailable for any reason, the implementation will return
  55 <code>null</code>.
  56 <p>
  57 The following table summarizes the desktop properties documented
  58 here, and their value types.
  59 <br><br>
  60 <table border=1>
  61 <thead>
  62 <tr>
  63 <th scope="col">Property Name</th>
  64 <th scope="col">Value Type</th>
  65 <th scope="col">Summary Description</th>
  66 </tr>
  67 </thead>
  68 <tbody>
  69 <tr>
  70 <th scope="row"><A href="#awt.font.desktophints">awt.font.desktophints</A></th>
  71 <td>{@link java.util.Map java.util.Map}</td>
  72 <td>Font smoothing (text antialiasing) settings.</td>
  73 </tr>
  74 <tr>
  75 <th scope="row"><A href="#sun.awt.enableExtraMouseButtons">sun.awt.enableExtraMouseButtons</A></th>
  76 <td>{@link java.lang.Boolean java.lang.Boolean}</td>
  77 <td>Controls if mouse events from extra buttons are to be generated or not</td>
  78 </tr>
  79 </tbody>
  80 </table>
  81 
  82 <h2>Desktop Font Rendering Hints</h2>
  83 <b>Desktop Property: <a id="awt.font.desktophints">"awt.font.desktophints"</A></b>
  84 <p>
  85 Modern desktops support various forms of text antialiasing (font smoothing).
  86 <p>
  87 These are applied by platform-specific heavyweight components.
  88 However an application may want to render text using the same text
  89 antialiasing on a drawing surface or lightweight (non-platform) component using
  90 <a href="../Graphics2D.html"> <code>Graphics2D</code></a> methods.
  91 This is particularly important when creating
  92 <a href="../../../javax/swing/JComponent.html"> Swing components</a> which
  93 are required to appear consistent with native desktop components or other
  94 Swing components.
  95 
  96 <h3>Basic Usage</h3>
  97 The standard desktop property named
  98 <b>"awt.font.desktophints"</b>
  99 can be used to obtain the rendering hints that best match the desktop settings.


< prev index next >