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>
|