< prev index next >

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

Print this page




  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
  29  questions.
  30 -->
  31 
  32 <body>
  33 <main role="main">

  34 <h1>AWT Desktop Properties</h1>
  35 
  36 The following refers to standard AWT desktop properties that
  37 may be obtained via the
  38 <a href="../Toolkit.html#getDesktopProperty(java.lang.String)">
  39 <code>Toolkit.getDesktopProperty</code></a> method.
  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


 260 and {@code Robot.mouseRelease()} methods and, if the mouse has more then three buttons,
 261 it is also legal to use masks for existing extended mouse buttons.
 262 That way, if there are more then three buttons on the mouse then it is allowed to
 263 use button masks corresponding to the buttons
 264 in the range from 1 up to {@link java.awt.MouseInfo#getNumberOfButtons() getNumberOfButtons()}
 265 </ul>
 266 <br>
 267 If the property is set to {@code false} then
 268 <ul>
 269 <li> it is legal to create {@code MouseEvent} objects with standard buttons
 270 only: {@code NOBUTTON}, {@code BUTTON1}, {@code BUTTON2} and
 271 {@code BUTTON3}
 272 <li> it is legal to use standard button masks only:
 273 {@code InputEvent.BUTTON1_DOWN_MASK}, {@code InputEvent.BUTTON2_DOWN_MASK},
 274 {@code InputEvent.BUTTON3_DOWN_MASK}
 275 </ul>
 276 
 277 This property should be used when there is no need in listening mouse events fired as a result of
 278 activity with extra mouse button.
 279 By default this property is set to {@code true}.

 280 </main>
 281 </body>
 282 </html>


  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
  29  questions.
  30 -->
  31 
  32 <body>
  33 <main role="main">
  34 <div class="contentContainer">
  35 <h1>AWT Desktop Properties</h1>
  36 
  37 The following refers to standard AWT desktop properties that
  38 may be obtained via the
  39 <a href="../Toolkit.html#getDesktopProperty(java.lang.String)">
  40 <code>Toolkit.getDesktopProperty</code></a> method.
  41 <p>
  42 Each desktop property is named by a unique string, which
  43 is the "name" of that property.
  44 <p>
  45 Desktop properties supported by the AWT but not documented
  46 elsewhere - typically because there is no suitable
  47 method or class - are documented here.
  48 <p>
  49 Desktop properties documented elsewhere are those which are
  50 tightly coupled with a method or class which documents them.
  51 <p>
  52 Since desktop properties abstract an underlying platform
  53 setting, they may not be available in environments that do
  54 not support them. In the event that a desktop property is


 261 and {@code Robot.mouseRelease()} methods and, if the mouse has more then three buttons,
 262 it is also legal to use masks for existing extended mouse buttons.
 263 That way, if there are more then three buttons on the mouse then it is allowed to
 264 use button masks corresponding to the buttons
 265 in the range from 1 up to {@link java.awt.MouseInfo#getNumberOfButtons() getNumberOfButtons()}
 266 </ul>
 267 <br>
 268 If the property is set to {@code false} then
 269 <ul>
 270 <li> it is legal to create {@code MouseEvent} objects with standard buttons
 271 only: {@code NOBUTTON}, {@code BUTTON1}, {@code BUTTON2} and
 272 {@code BUTTON3}
 273 <li> it is legal to use standard button masks only:
 274 {@code InputEvent.BUTTON1_DOWN_MASK}, {@code InputEvent.BUTTON2_DOWN_MASK},
 275 {@code InputEvent.BUTTON3_DOWN_MASK}
 276 </ul>
 277 
 278 This property should be used when there is no need in listening mouse events fired as a result of
 279 activity with extra mouse button.
 280 By default this property is set to {@code true}.
 281 </div>
 282 </main>
 283 </body>
 284 </html>
< prev index next >