The Quaqua Look and Feel supports the system properties listed below. You may notice, that the list also contains some properties defined in Apple's Release Notes for their Java Virtual Machines. These properties are listed here, because they directly affect the appearance and behaviour of the Quaqua Look and Feel.
Note 1: In addition to the system properties shown here, you can also preset all of Quaqua's General and Debug UIManager Properties using System Properties.
Note 2: In restricted environments
(e.g. Applet's) you can set System Properties using the QuaquaManager.setProperty()
method.
This will only work with properties which have a Quaqua.
prefix
though.
Property |
Default Value | Notes |
---|---|---|
Quaqua |
auto |
Chooses a design for the look and feel. Set this to You should use this property for testing purposes only. For production use, it is not recommended, to set a different design than the one used by the operating system. |
Quaqua |
false |
Most of Quaqua's components are translucent in order to render focus rings and JTabbedPane's properly. Set this to |
Quaqua |
false |
On Mac OS X, only text components request focus when the user clicks on them. Set this to |
Quaqua |
auto |
Starting from Mac OS X 10.3 Panther, selected items in JList's, JTable's and JTree's are rendered with a dark background color. Change this property, if your application expects, that selections are always drawn with a bright background colour, and you don't want to invest the time for fixing your application. Supported values are:
|
Quaqua |
regular |
Use this property to change the default size style of all components. Supported values are:
Note: Since Quaqua does not (yet) implement all component UI's, you may not get consistent results with the small size style. |
Quaqua |
3,3,3,3 |
Specifies the margin ( Set the insets to a smaller value, if your
layouts grow too big, and you don't want to invest the time for fine
tuning the visual margin of individual components using the client
property |
Quaqua |
false |
Enforces the visual margin around components. Set this to true to work around NetBeans Matisse issue #74522. |
Quaqua |
false |
Set this to true, to prevent Quaqua from loading its JNI library on its own. |
Quaqua.JNI |
false |
Set this to true, to prevent Quaqua from loading its JNI library on its own. |
Property | Default Value | Notes |
---|---|---|
|
false |
Set this to true, if you don't need drag and drop support in JTable. Quaqua currently uses the mouse handler from the Basic look and feel, because it does not implement yet drag and drop for JTable. (Hopefully) in a future version, Quaqua will implement drag and drop handling on its own. |
Property | Default Value | Notes |
---|---|---|
|
true |
Makes JFileChooser's automatically validate the contents of a directory,
when the user clicks at it. Set this to false , if you experience
performance problems, e.g. when using JFileChooser's to choose files
from large directories (> 1000 entries) over a slow network connection. |
|
true |
Displays a file preview using Apple's QuickLook API. Set this to false , if you experience
crashes with QuickLook. |
|
auto |
Chooses a default layout policy for tabbed panes. Set this to
|
|
auto |
Chooses a design for tabbed panes. Set this to |
|
true |
If set to true, text components automatically select all text, when the user presses the tabulator key to set the focus on the field. This affects JTextField, JPasswordField and JFormattedTextField. |
apple.laf |
false |
Puts Swing menus in the Mac OS X menu bar. Note that JMenuBars in JDialogs are not moved to the Mac OS X menu bar. |
apple.awt |
false |
Displays JFrame's with the “textured” Aqua window appearance. |
apple.awt |
true |
Most native Mac OS X windows have a resize control in the bottom-right corner. By default, Java application windows that use the Quaqua look and feel show this control, but there may be circumstances where you want it to be hidden. This property is used to decide if the grow box is shown or not. |