Interface FlatSystemProperties
-
public interface FlatSystemPropertiesDefines/documents own system properties used in FlatLaf.
-
-
Field Summary
Fields Modifier and Type Field Description static StringANIMATIONSpecifies whether animations are enabled.static StringMENUBAR_EMBEDDEDSpecifies whether the menu bar is embedded into the window title pane if window decorations are enabled.static StringNATIVE_LIBRARY_PATHSpecifies a directory in which the native FlatLaf libraries have been extracted.static StringUI_SCALESpecifies a custom scale factor used to scale the UI.static StringUI_SCALE_ALLOW_SCALE_DOWNSpecifies whether values smaller than 100% are allowed for the user scale factor (seeUIScale.getUserScaleFactor()).static StringUI_SCALE_ENABLEDSpecifies whether user scaling mode is enabled.static StringUPDATE_UI_ON_SYSTEM_FONT_CHANGESpecifies whether FlatLaf updates the UI when the system font changes.static StringUSE_JETBRAINS_CUSTOM_DECORATIONSSpecifies whether JetBrains Runtime custom window decorations should be used when creatingJFrameorJDialog.static StringUSE_TEXT_Y_CORRECTIONSpecifies whether vertical text position is corrected when UI is scaled on HiDPI screens.static StringUSE_UBUNTU_FONTSpecifies whether Ubuntu font should be used on Ubuntu Linux.static StringUSE_WINDOW_DECORATIONSSpecifies whether native window decorations should be used when creatingJFrameorJDialog.
-
Method Summary
Static Methods Modifier and Type Method Description static booleangetBoolean(String key, boolean defaultValue)Checks whether a system property is set and returnstrueif its value is"true"(case-insensitive), otherwise it returnsfalse.static BooleangetBooleanStrict(String key, Boolean defaultValue)Checks whether a system property is set and returnsBoolean.TRUEif its value is"true"(case-insensitive) or returnsBoolean.FALSEif its value is"false"(case-insensitive).
-
-
-
Field Detail
-
UI_SCALE
static final String UI_SCALE
Specifies a custom scale factor used to scale the UI.If Java runtime scales (Java 9 or later), this scale factor is applied on top of the Java system scale factor. Java 8 does not scale and this scale factor replaces the user scale factor that FlatLaf computes based on the font. To replace the Java 9+ system scale factor, use system property "sun.java2d.uiScale", which has the same syntax as this one.
Since FlatLaf 1.1.2: Scale factors less than 100% are allowed.
Allowed Values e.g.
1.5,1.5x,150%or144dpi(96dpi is 100%)- See Also:
- Constant Field Values
-
UI_SCALE_ENABLED
static final String UI_SCALE_ENABLED
Specifies whether user scaling mode is enabled.Allowed Values
falseandtrue
Defaulttrue- See Also:
- Constant Field Values
-
UI_SCALE_ALLOW_SCALE_DOWN
static final String UI_SCALE_ALLOW_SCALE_DOWN
Specifies whether values smaller than 100% are allowed for the user scale factor (seeUIScale.getUserScaleFactor()).Allowed Values
falseandtrue
Defaultfalse- Since:
- 1.1.2
- See Also:
- Constant Field Values
-
USE_UBUNTU_FONT
static final String USE_UBUNTU_FONT
Specifies whether Ubuntu font should be used on Ubuntu Linux. By default, if not running in a JetBrains Runtime, the Liberation Sans font is used because there are rendering issues (in Java) with Ubuntu fonts.Allowed Values
falseandtrue
Defaultfalse- See Also:
- Constant Field Values
-
USE_WINDOW_DECORATIONS
static final String USE_WINDOW_DECORATIONS
Specifies whether native window decorations should be used when creatingJFrameorJDialog.Setting this to
trueforces using native window decorations even if they are not enabled by the application.
Setting this tofalsedisables using native window decorations.This system property has higher priority than client property
FlatClientProperties.USE_WINDOW_DECORATIONSand UI defaultTitlePane.useWindowDecorations.(requires Window 10/11)
Allowed Values
falseandtrue
Default none- See Also:
- Constant Field Values
-
USE_JETBRAINS_CUSTOM_DECORATIONS
static final String USE_JETBRAINS_CUSTOM_DECORATIONS
Specifies whether JetBrains Runtime custom window decorations should be used when creatingJFrameorJDialog. Requires that the application runs in a JetBrains Runtime (based on OpenJDK).Setting this to
falsedisables using JetBrains Runtime custom window decorations. Then FlatLaf native window decorations are used.(requires Window 10/11)
Allowed Values
falseandtrue
Defaultfalse(since v2; wastruein v1)- See Also:
- Constant Field Values
-
MENUBAR_EMBEDDED
static final String MENUBAR_EMBEDDED
Specifies whether the menu bar is embedded into the window title pane if window decorations are enabled.Setting this to
trueforces embedding.
Setting this tofalsedisables embedding.This system property has higher priority than client property
FlatClientProperties.MENU_BAR_EMBEDDEDand UI defaultTitlePane.menuBarEmbedded.(requires Window 10/11)
Allowed Values
falseandtrue
Default none- See Also:
- Constant Field Values
-
ANIMATION
static final String ANIMATION
Specifies whether animations are enabled.Allowed Values
falseandtrue
Defaulttrue- See Also:
- Constant Field Values
-
USE_TEXT_Y_CORRECTION
static final String USE_TEXT_Y_CORRECTION
Specifies whether vertical text position is corrected when UI is scaled on HiDPI screens.Allowed Values
falseandtrue
Defaulttrue- See Also:
- Constant Field Values
-
UPDATE_UI_ON_SYSTEM_FONT_CHANGE
static final String UPDATE_UI_ON_SYSTEM_FONT_CHANGE
Specifies whether FlatLaf updates the UI when the system font changes. Iftrue,SwingUtilities.updateComponentTreeUI(java.awt.Component)gets invoked for all windows if the system font has changed. This is the similar to when switching to another look and feel (theme). Applications that do not work correctly when switching look and feel, should disable this option to avoid corrupted UI.Allowed Values
falseandtrue
Defaulttrue- Since:
- 2.5
- See Also:
- Constant Field Values
-
NATIVE_LIBRARY_PATH
static final String NATIVE_LIBRARY_PATH
Specifies a directory in which the native FlatLaf libraries have been extracted. The path can be absolute or relative to current application working directory. This can be used to avoid extraction of the native libraries to the temporary directory at runtime.If the value is
"system", thenSystem.loadLibrary(String)is used to load the native library. Searches for the native library in classloader of caller (usingClassLoader.findLibrary(String)) and in paths specified in system propertiessun.boot.library.pathandjava.library.path. (supported since FlatLaf 2.6)If the native library can not loaded from the given path (or via
System.loadLibrary(String)), then the embedded native library is extracted to the temporary directory and loaded from there.- Since:
- 2
- See Also:
- Constant Field Values
-
-
Method Detail
-
getBoolean
static boolean getBoolean(String key, boolean defaultValue)
Checks whether a system property is set and returnstrueif its value is"true"(case-insensitive), otherwise it returnsfalse. If the system property is not set,defaultValueis returned.
-
-