java.lang.Object
org.pushingpixels.substance.internal.contrib.jgoodies.looks.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.
  • Field Details

  • Method Details

    • 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

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

      public static void setDefaultIconSize(Dimension defaultIconSize)
      Sets the default icon size.
      Parameters:
      defaultIconSize - the default icon size to set
      See Also:
    • 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

      public static void setGlobalFontSizeHints(FontSizeHints hints)
      Sets the global FontSizeHints.
      Parameters:
      hints - the FontSizeHints object to be used globally
      See Also:
    • 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

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

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

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

      public static void removeLookAndFeelReplacement(String original)
      Removes a replacement name for a given LookAndFeel class name from the list of all look and feel replacements.
      Parameters:
      original - the name of the look-and-feel that has been replaced
      See Also:
    • initializeDefaultReplacements

      public static void initializeDefaultReplacements()
      Initializes some default class name replacements, that replace Sun's Java look and feel, and Sun's Windows look and feel by the appropriate JGoodies replacements.
      See Also:
    • getReplacementClassNameFor

      public static String getReplacementClassNameFor(String className)
      Returns the class name that can be used to replace the specified LookAndFeel class name.
      Parameters:
      className - the name of the look-and-feel class
      Returns:
      the name of the suggested replacement class
      See Also:
    • 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

      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: