Class Options


  • public final class Options
    extends Object
    Provides access to several optional properties for the JGoodies L&Fs, either by a key to the UIDefaults table or via a method or both.
    • Method Detail

      • getUseSystemFonts

        public static boolean getUseSystemFonts()
        Returns whether a hint is set in the UIManager that indicates, that a look&feel may use the native system fonts.
        Returns:
        true if the UIManager indicates that system fonts shall be used
        See Also:
        setUseSystemFonts(boolean)
      • setUseSystemFonts

        public static void setUseSystemFonts​(boolean useSystemFonts)
        Sets a value in the UIManager to indicate, that a look&feel may use the native system fonts.
        Parameters:
        useSystemFonts - true to enable system fonts in the UIManager
        See Also:
        getUseSystemFonts()
      • getDefaultIconSize

        public static Dimension getDefaultIconSize()
        Returns the default icon size that is used in menus, menu items and toolbars. Menu items that have no icon set are aligned using the default icon dimensions.
        Returns:
        the dimension of the default icon
        See Also:
        setDefaultIconSize(Dimension)
      • setDefaultIconSize

        public static void setDefaultIconSize​(Dimension defaultIconSize)
        Sets the default icon size.
        Parameters:
        defaultIconSize - the default icon size to set
        See Also:
        getDefaultIconSize()
      • getGlobalFontSizeHints

        public static FontSizeHints getGlobalFontSizeHints()
        Returns the global FontSizeHints that can be overriden by a look-specific setting.
        Returns:
        the gobally used FontSizeHints object
        See Also:
        setGlobalFontSizeHints(FontSizeHints)
      • setGlobalFontSizeHints

        public static void setGlobalFontSizeHints​(FontSizeHints hints)
        Sets the global FontSizeHints.
        Parameters:
        hints - the FontSizeHints object to be used globally
        See Also:
        getGlobalFontSizeHints()
      • getUseNarrowButtons

        public static boolean getUseNarrowButtons()
        Checks and answers if we shall use narrow button margins of 4 pixels. Sun's L&F implementations use a much wider button margin of 14 pixels, which leads to good button minimum width in the typical case.

        Using narrow button margins can potentially cause compatibility issues, so this feature must be switched on programmatically.

        If you use narrow margin, you should take care of minimum button width, either by the layout management or appropriate ButtonUI minimum widths.

        Returns:
        true if all buttons shall use narrow margins
        See Also:
        setUseNarrowButtons(boolean)
      • setUseNarrowButtons

        public static void setUseNarrowButtons​(boolean b)
        Sets if we use narrow or standard button margins.
        Parameters:
        b - true to use narrow button margins globally
        See Also:
        getUseNarrowButtons()
      • isTabIconsEnabled

        public static boolean isTabIconsEnabled()
        Checks and answers if we shall use icons in JTabbedPanes. By default, tab icons are enabled. If the user has set a system property, we log a message about the choosen style.
        Returns:
        true if icons in tabbed panes are enabled, false if disabled
        See Also:
        setTabIconsEnabled(boolean)
      • setTabIconsEnabled

        public static void setTabIconsEnabled​(boolean b)
        Enables or disables the use of icons in JTabbedPanes.
        Parameters:
        b - true to enable icons in tabbed panes, false to disable them
        See Also:
        isTabIconsEnabled()
      • isPopupDropShadowActive

        public static boolean isPopupDropShadowActive()
        Checks and answers whether popup drop shadows are active. This feature shall be inactive with toolkits that use native drop shadows, such as Aqua on the Mac OS X. It is also inactive if the ShadowPopup cannot snapshot the desktop background (due to security and AWT exceptions). Otherwise the feature's enablement state is returned.

        Currently only the Mac OS X is detected as platform where the toolkit uses native drop shadows.

        Returns:
        true if drop shadows are active, false if inactive
        See Also:
        isPopupDropShadowEnabled(), setPopupDropShadowEnabled(boolean)
      • isPopupDropShadowEnabled

        public static boolean isPopupDropShadowEnabled()
        Checks and answers whether the optional drop shadows for PopupMenus are enabled or disabled.
        Returns:
        true if drop shadows are enabled, false if disabled
        See Also:
        isPopupDropShadowActive(), setPopupDropShadowEnabled(boolean)
      • setPopupDropShadowEnabled

        public static void setPopupDropShadowEnabled​(boolean b)
        Enables or disables drop shadows in PopupMenus. Note that drop shadows are always inactive on platforms that provide native drop shadows such as the Mac OS X.

        It is recommended to enable this feature only on platforms that accelerate translucency and snapshots with the hardware.

        Parameters:
        b - true to enable drop shadows, false to disable them
        See Also:
        isPopupDropShadowActive(), isPopupDropShadowEnabled()
      • putLookAndFeelReplacement

        public static void putLookAndFeelReplacement​(String original,
                                                     String replacement)
        Puts a replacement name for a given LookAndFeel class name in the list of all look and feel replacements.
        Parameters:
        original - the name of the look-and-feel to replace
        replacement - the name of the replacement look-and-feel
        See Also:
        removeLookAndFeelReplacement(String), getReplacementClassNameFor(String)
      • getCrossPlatformLookAndFeelClassName

        public static String getCrossPlatformLookAndFeelClassName()
        Returns the class name for a cross-platform LookAndFeel.
        Returns:
        the name of a cross platform look-and-feel class
        See Also:
        getSystemLookAndFeelClassName()
      • getSystemLookAndFeelClassName

        public static String getSystemLookAndFeelClassName()
        Returns the class name for a system specific LookAndFeel.
        Returns:
        the name of the system look-and-feel class
        See Also:
        getCrossPlatformLookAndFeelClassName()