Class RadianceThemingCortex.GlobalScope

java.lang.Object

org.pushingpixels.radiance.theming.api.RadianceThemingCortex.GlobalScope

Enclosing class:

RadianceThemingCortex

public static final class RadianceThemingCortex.GlobalScope
extends Object

APIs in this scope apply to the global state of the application.

Field Summary

Fields

Modifier and Type	Field	Description
private static RadianceThemingSlices.ButtonOrder	buttonBarButtonOrder
private static RadianceThemingSlices.HorizontalGravity	buttonBarGravity
private static RadianceSkin	currentSkin	The current Radiance skin.
private static RadianceIconPack	iconPack
private static ResourceBundle	labelBundle	Resource bundle for Radiance labels.
private static ClassLoader	labelBundleClassLoader	Class loader for labelBundle.
private static final Set<RadianceThemingSlices.LocaleChangeListener>	localeChangeListeners	List of all listeners on changing locales.
private static final String	RADIANCE_FONT_POLICY_KEY
private static final Set<SkinChangeListener>	skinChangeListeners	List of all listeners on skin changes.

Constructor Summary

Constructors

Constructor	Description
GlobalScope()

Method Summary

Modifier and Type	Method	Description
static void	allowAnimations(RadianceThemingSlices.AnimationFacet animationFacet)	Allows animations of the specified facet on all controls.
static void	allowAnimations(RadianceThemingSlices.AnimationFacet animationFacet, Class<?> clazz)	Allows animations of the specified facet on all controls of specified class.
static void	allowAnimations(RadianceThemingSlices.AnimationFacet animationFacet, Class<?>[] clazz)	Allows animations of the specified facet on all controls of specified classes.
static void	configureTitleContentGravity(RadianceThemingSlices.HorizontalGravity titleTextHorizontalGravity, RadianceThemingSlices.HorizontalGravity titleControlButtonGroupHorizontalGravity, RadianceThemingSlices.TitleIconHorizontalGravity titleIconHorizontalGravity)	Configures title pane content gravity for all decorated application windows.
static void	disallowAnimations(RadianceThemingSlices.AnimationFacet animationFacet)	Disallows animations of the specified facet on all controls.
static void	disallowAnimations(RadianceThemingSlices.AnimationFacet animationFacet, Class<?> clazz)	Disallows animations of the specified facet on all controls of specified class.
static void	disallowAnimations(RadianceThemingSlices.AnimationFacet animationFacet, Class<?>[] clazz)	Disallows animations of the specified facet on all controls of specified classes.
static Map<String,SkinInfo>	getAllSkins()	Returns all available skins.
static Set<BaseTabCloseListener>	getAllTabCloseListeners()	Returns the set of all listeners registered on tab-close events on all tabbed panes.
static BufferedImage	getBlankImage(double scaleFactor, int width, int height)
static RadianceThemingSlices.HorizontalGravity	getButtonBarGravity()	Returns the currently set button bar gravity for all containers that display grouped buttons, such as JOptionPanes, for example.
static RadianceThemingSlices.ButtonOrder	getButtonBarOrder()	Returns the currently set button order for all containers that display grouped buttons, such as JOptionPanes, for example.
static RadianceSkin	getCurrentSkin()	Returns the current global skin.
static FontPolicy	getFontPolicy()	Looks up and retrieves the FontPolicy used by the Radiance family.
static RadianceIconPack	getIconPack()	Looks up and retrieves the RadianceIconPack used by Radiance.
static ResourceBundle	getLabelBundle()	Retrieves the current label bundle.
static ResourceBundle	getLabelBundle(Locale locale)	Retrieves the label bundle for the specified locale.
static ClassLoader	getLabelBundleClassLoader()
static Set<RadianceThemingSlices.LocaleChangeListener>	getLocaleChangeListeners()	Returns all listeners registered on locale change.
static float	getMenuGutterFillAlpha()	Returns the menu gutter fill alpha.
static long	getTimelineDuration()
static RadianceThemingSlices.TitleIconHorizontalGravity	getTitleIconHorizontalGravity()	Returns the gravity for the icon in title panes of all decorated application windows.
static RadianceThemingSlices.HorizontalGravity	getTitleTextHorizontalGravity()	Returns the gravity for the title text in title panes of all decorated application windows.
(package private) static void	initFontDefaults(UIDefaults table)	Looks up the correct control font and sets it for all controls.
private static void	initFontDefaults(UIDefaults table, FontSet fontSet)	Sets Fonts in the given FontSet as defaults for all known component types in the given UIDefaults table.
static boolean	isAnimationAllowed(RadianceThemingSlices.AnimationFacet animationFacet)	Checks whether the specified animation facet is allowed on the specified component.
static void	registerComponentPlugin(RadianceThemingComponentPlugin componentPlugin)	Registers the specified component plugin.
static void	registerLocaleChangeListener(RadianceThemingSlices.LocaleChangeListener localeListener)	Registers a new listener on locale change.
static void	registerSkinChangeListener(SkinChangeListener skinChangeListener)	Registers a new listener on skin change.
static void	registerSkinPlugin(RadianceThemingSkinPlugin skinPlugin)	Registers the specified skin plugin.
static void	registerTabCloseChangeListener(BaseTabCloseListener tabCloseListener)	Registers the specified listener on tab-close events on all tabbed panes.
static void	registerWidget(String widgetClassName, Class<?> supportedClass, boolean isExact)
static void	resetLabelBundle()	Resets the current label bundle.
static void	setAutomaticDragAndDropSupportPresence(Boolean hasAutomaticDragAndDropSupport)	Specifies whether trees should have should have automatic drag and drop support.
static void	setAutomaticScrollPresence(Boolean hasAutomaticScroll)	Specifies whether scroll panes should have auto-scroll support invoked on mouse button click that triggers popups.
static void	setBackgroundAppearanceStrategy(RadianceThemingSlices.BackgroundAppearanceStrategy backgroundAppearanceStrategy)	Specifies when components should draw their background.
static void	setButtonBarGravity(RadianceThemingSlices.HorizontalGravity buttonBarGravity)	Sets the button bar gravity for all containers that display grouped buttons, such as JOptionPanes, for example.
static void	setButtonBarOrder(RadianceThemingSlices.ButtonOrder buttonBarButtonOrder)	Sets the button order for all containers that display grouped buttons, such as JOptionPanes, for example.
static void	setButtonIgnoreMinimumSize(Boolean buttonIgnoreMinimumSize)	Specifies whether buttons should ignore the default (minimum) dimension.
static void	setCapsLockIconVisible(Boolean visible)	Specifies global visibility of the caps lock icon on password fields.
static void	setColorizationFactor(double colorizationFactor)	Specifies colorization amount applied to the background and foreground of the current color tokens and all control.
static void	setComboBoxPopupPlacementStrategy(RadianceThemingSlices.PopupPlacementStrategy comboBoxPopupPlacementStrategy)	Specifies the combobox popup placement strategy.
static void	setComboBoxPrototypeCallback(ComboPopupPrototypeCallback comboPopupPrototypeCallback)	Specifies the combobox popup prototype callback which is used to compute the width of the popups at runtime.
static void	setComboBoxPrototypeDisplayValue(Object comboPopupPrototypeDisplayValue)	Specifies the combobox popup prototype display value which is used to compute the width of the popups at runtime.
static void	setComponentPreviewPainter(PreviewPainter previewPainter)	Specifies global preview painter to be used for showing preview thumbnails.
static void	setExtraWidgetsPresence(Boolean extraWidgetsPresence)	Specifies that extra UI elements (such as menu items in system menu or lock borders) can be shown.
static void	setFocusKind(RadianceThemingSlices.FocusKind focusKind)	Specifies the kind of focus indication to be used on application components.
static void	setFontPolicy(FontPolicy fontPolicy)	Sets the FontPolicy to be used with Radiance family.
static void	setIconFilterStrategies(RadianceThemingSlices.IconFilterStrategy activeIconFilterStrategy, RadianceThemingSlices.IconFilterStrategy enabledIconFilterStrategy, RadianceThemingSlices.IconFilterStrategy disabledIconFilterStrategy)	Specifies how icons on controls such as buttons, toggle buttons, labels, tabs and menu items are themed.
static void	setIconPack(RadianceIconPack iconPack)	Sets the RadianceIconPack to be used with Radiance.
static void	setLabelBundleClassLoader(ClassLoader labelBundleClassLoader)	Sets the class loader for labelBundle.
static void	setLockIconVisible(Boolean visible)	Specifies global visibility of the lock icon on non-editable text components.
static void	setMenuGutterFillAlpha(float menuGutterFillAlpha)	Specifies the menu gutter fill alpha.
static void	setNumberOfPasswordEchoesPerCharacter(int echoCount)	Specifies the number of echo characters for each password character in password fields.
static void	setRunModifiedAnimationOnTabCloseButton(Boolean runModifiedAnimationOnTabCloseButton)	Specifies that only the close button of a marked-as-modified tab component should pulsate.
static void	setSelectTextOnFocus(Boolean selectTextOnFocus)	Specifies whether the contents of text components should be selected on focus gain.
static boolean	setSkin(String skinClassName)	Sets the specified skin.
static boolean	setSkin(RadianceSkin newSkin)	Sets the specified skin.
(package private) static boolean	setSkin(RadianceSkin newSkin, boolean toUpdateWindows)	Sets the specified skin.
static void	setTabCloseButtonsVisible(Boolean tabCloseButtonsVisible)	Configures visibility of close buttons on tabbed pane tabs.
static void	setTabCloseCallback(TabCloseCallback tabCloseCallback)	Configures the callback for deciding on the tab close type on tabbed pane tabs.
static void	setTabContentPaneBorderKind(RadianceThemingSlices.TabContentPaneBorderKind tabContentPaneBorderKind)	Specifies the content pane border kind for tabbed panes.
static void	setTextEditContextMenuPresence(Boolean hasEditContextMenu)	Specifies whether text components should have the edit context menu (with Cut / Copy / Paste / ...
static void	setTimelineDuration(long timelineDuration)
static void	setToolbarButtonCornerRadius(float toolbarButtonCornerRadius)	Specifies corner radius for all toolbar buttons.
static void	setTraceFilename(String traceFilename)	Specifies the trace filename.
static void	setUseDefaultColorChooser()
static void	setWidgetVisible(boolean visible, RadianceThemingSlices.WidgetType... radianceWidgets)	Sets the visibility of the specified widget kind(s).
static void	unregisterLocaleChangeListener(RadianceThemingSlices.LocaleChangeListener localeListener)	Unregisters a listener on locale change.
static void	unregisterSkinChangeListener(SkinChangeListener skinChangeListener)	Unregisters a listener on skin change.
static void	unregisterTabCloseChangeListener(BaseTabCloseListener tabCloseListener)	Unregisters the specified listener on tab-close events on all tabbed panes.
(package private) static void	unsetSkin()

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

RADIANCE_FONT_POLICY_KEY

private static final String RADIANCE_FONT_POLICY_KEY

See Also:

• Constant Field Values

labelBundle

private static ResourceBundle labelBundle

Resource bundle for Radiance labels.

labelBundleClassLoader

private static ClassLoader labelBundleClassLoader

Class loader for labelBundle.

currentSkin

private static RadianceSkin currentSkin

The current Radiance skin.

skinChangeListeners

private static final Set<SkinChangeListener> skinChangeListeners

List of all listeners on skin changes.

localeChangeListeners

private static final Set<RadianceThemingSlices.LocaleChangeListener> localeChangeListeners

List of all listeners on changing locales.

iconPack

private static RadianceIconPack iconPack

buttonBarButtonOrder

private static RadianceThemingSlices.ButtonOrder buttonBarButtonOrder

buttonBarGravity

private static RadianceThemingSlices.HorizontalGravity buttonBarGravity

Constructor Details

GlobalScope

public GlobalScope()

Method Details

setSkin

static boolean setSkin(RadianceSkin newSkin,
 boolean toUpdateWindows)

Sets the specified skin. If the current look-and-feel is not Radiance, this method will create a new Radiance look-and-feel based on the specified skin and set it on UIManager. This method does not require Radiance to be the current look-and-feel.

Parameters:

newSkin - Skin to set.

toUpdateWindows - if true, the SwingUtilities.updateComponentTreeUI(Component) is called on all windows returned by Window.getWindows() API.

Returns:

true if the specified skin has been set successfully, false otherwise.

See Also:

• setSkin(RadianceSkin)

unsetSkin

static void unsetSkin()

setSkin

public static boolean setSkin(RadianceSkin newSkin)

Sets the specified skin. If the current look-and-feel is not Radiance, this method will create a new Radiance look-and-feel based on the specified skin and set it on UIManager. This method does not require Radiance to be the current look-and-feel. Calling this method will call SwingUtilities.updateComponentTreeUI(Component) on all open top-level windows.

Parameters:

newSkin - Skin to set.

Returns:

true if the specified skin has been set successfully, false otherwise.

Throws:

IllegalStateException - When called outside the Event Dispatch Thread.

See Also:

• registerSkinChangeListener(SkinChangeListener)
• unregisterSkinChangeListener(SkinChangeListener)
• setSkin(String)
• RadianceThemingCortex.RootPaneScope.setSkin(JRootPane, RadianceSkin)
• RadianceSkin.isValid()

setSkin

public static boolean setSkin(String skinClassName)

Sets the specified skin. If the current look-and-feel is not Radiance, this method will create a new Radiance look-and-feel based on the specified skin and set it on UIManager. This method does not require Radiance to be the current look-and-feel. Calling this method will call SwingUtilities.updateComponentTreeUI(Component) on all open top-level windows.

Parameters:

skinClassName - Skin to set.

Returns:

true if the specified skin has been set successfully, false otherwise.

Throws:

IllegalStateException - When called outside the Event Dispatch Thread.

See Also:

• setSkin(RadianceSkin)
• registerSkinChangeListener(SkinChangeListener)
• unregisterSkinChangeListener(SkinChangeListener)
• setSkin(RadianceSkin)
• RadianceThemingCortex.RootPaneScope.setSkin(JRootPane, RadianceSkin)
• RadianceSkin.isValid()

getCurrentSkin

public static RadianceSkin getCurrentSkin()

Returns the current global skin. If the current look-and-feel is not Radiance, this method returns null.

Returns:

Current global skin.

initFontDefaults

static void initFontDefaults(UIDefaults table)

Looks up the correct control font and sets it for all controls.

Parameters:

table - The UI defaults table.

initFontDefaults

private static void initFontDefaults(UIDefaults table,
 FontSet fontSet)

Sets Fonts in the given FontSet as defaults for all known component types in the given UIDefaults table.

Parameters:

table - the UIDefaults table used to set fonts

fontSet - describes the set of Fonts to be installed

registerSkinChangeListener

public static void registerSkinChangeListener(SkinChangeListener skinChangeListener)

Registers a new listener on skin change.

Parameters:

skinChangeListener - New listener on skin change.

See Also:

• setSkin(String)
• setSkin(RadianceSkin)
• unregisterSkinChangeListener(SkinChangeListener)

unregisterSkinChangeListener

public static void unregisterSkinChangeListener(SkinChangeListener skinChangeListener)

Unregisters a listener on skin change.

Parameters:

skinChangeListener - The listener to unregister.

See Also:

• setSkin(String)
• setSkin(RadianceSkin)
• registerSkinChangeListener(SkinChangeListener)

getAllSkins

public static Map<String,SkinInfo> getAllSkins()

Returns all available skins.

Returns:

All available skins. Key - skin display name, value - skin information.

registerComponentPlugin

public static void registerComponentPlugin(RadianceThemingComponentPlugin componentPlugin)

Registers the specified component plugin. It is recommended to call this method before setting Radiance as the look-and-feel in your application initialization sequence. If this method is called after Radiance has been set, you will need to call the setSkin(String) or setSkin(RadianceSkin) APIs to reinitialize the Radiance skin.

Parameters:

componentPlugin - Component plugin to register.

registerSkinPlugin

public static void registerSkinPlugin(RadianceThemingSkinPlugin skinPlugin)

Registers the specified skin plugin.

Parameters:

skinPlugin - Skin plugin to register.

registerWidget

public static void registerWidget(String widgetClassName,
 Class<?> supportedClass,
 boolean isExact)

setFontPolicy

public static void setFontPolicy(FontPolicy fontPolicy)

Sets the FontPolicy to be used with Radiance family. If the specified policy is null, the default will be reset. This method does not require Radiance to be the current look-and-feel, and will cause Radiance to be set as the current application look-and-feel.

Parameters:

fontPolicy - The FontPolicy to be used with Radiance family, or null to reset to the default

See Also:

• getFontPolicy()

getFontPolicy

public static FontPolicy getFontPolicy()

Looks up and retrieves the FontPolicy used by the Radiance family. If a FontPolicy has been set, it'll be returned. If no FontPolicy has been set, the default Radiance font policy will be returned.

Returns:

the FontPolicy set for Radiance, or the default Radiance font policy.

See Also:

• setFontPolicy(FontPolicy)

registerTabCloseChangeListener

public static void registerTabCloseChangeListener(BaseTabCloseListener tabCloseListener)

Registers the specified listener on tab-close events on all tabbed panes.

Parameters:

tabCloseListener - Listener to register.

See Also:

• RadianceThemingCortex.ComponentScope.registerTabCloseChangeListener(JTabbedPane, BaseTabCloseListener)
• unregisterTabCloseChangeListener(BaseTabCloseListener)
• getAllTabCloseListeners()

unregisterTabCloseChangeListener

public static void unregisterTabCloseChangeListener(BaseTabCloseListener tabCloseListener)

Unregisters the specified listener on tab-close events on all tabbed panes.

Parameters:

tabCloseListener - Listener to unregister.

See Also:

• RadianceThemingCortex.ComponentScope.unregisterTabCloseChangeListener(JTabbedPane, BaseTabCloseListener)
• registerTabCloseChangeListener(BaseTabCloseListener)
• getAllTabCloseListeners()

getAllTabCloseListeners

public static Set<BaseTabCloseListener> getAllTabCloseListeners()

Returns the set of all listeners registered on tab-close events on all tabbed panes.

Returns:

Set of all listeners registered on tab-close events on all tabbed panes.

See Also:

• registerTabCloseChangeListener(BaseTabCloseListener)
• unregisterTabCloseChangeListener(BaseTabCloseListener)

setIconPack

public static void setIconPack(RadianceIconPack iconPack)

Sets the RadianceIconPack to be used with Radiance.

Parameters:

iconPack - The RadianceIconPack to be used with Radiance.

See Also:

• getIconPack()

getIconPack

public static RadianceIconPack getIconPack()

Looks up and retrieves the RadianceIconPack used by Radiance.

Returns:

the RadianceIconPack set for Radiance.

See Also:

• setIconPack(RadianceIconPack)

allowAnimations

public static void allowAnimations(RadianceThemingSlices.AnimationFacet animationFacet)

Allows animations of the specified facet on all controls. Due to performance considerations, this API can only be used to control renderer-based components (tables, lists, trees) and custom Radiance animations (focus loop, icon glow, etc).

Parameters:

animationFacet - Animation facet to allow.

allowAnimations

public static void allowAnimations(RadianceThemingSlices.AnimationFacet animationFacet,
 Class<?> clazz)

Allows animations of the specified facet on all controls of specified class. Due to performance considerations, this API can only be used to control renderer-based components (tables, lists, trees) and custom Radiance animations (focus loop, icon glow, etc).

Parameters:

animationFacet - Animation facet to allow.

clazz - Control class for allowing the animation facet.

allowAnimations

public static void allowAnimations(RadianceThemingSlices.AnimationFacet animationFacet,
 Class<?>[] clazz)

Allows animations of the specified facet on all controls of specified classes. Due to performance considerations, this API can only be used to control renderer-based components (tables, lists, trees) and custom Radiance animations (focus loop, icon glow, etc).

Parameters:

animationFacet - Animation facet to allow.

clazz - Control classes for allowing the animation facet.

disallowAnimations

public static void disallowAnimations(RadianceThemingSlices.AnimationFacet animationFacet)

Disallows animations of the specified facet on all controls. Due to performance considerations, this API can only be used to control renderer-based components (tables, lists, trees) and custom Radiance animations (focus loop, icon glow, etc).

Parameters:

animationFacet - Animation facet to disallow.

disallowAnimations

public static void disallowAnimations(RadianceThemingSlices.AnimationFacet animationFacet,
 Class<?> clazz)

Disallows animations of the specified facet on all controls of specified class. Due to performance considerations, this API can only be used to control renderer-based components (tables, lists, trees) and custom Radiance animations (focus loop, icon glow, etc).

Parameters:

animationFacet - Animation facet to disallow.

clazz - Control class for disallowing the animation facet.

disallowAnimations

public static void disallowAnimations(RadianceThemingSlices.AnimationFacet animationFacet,
 Class<?>[] clazz)

Disallows animations of the specified facet on all controls of specified classes. Due to performance considerations, this API can only be used to control renderer-based components (tables, lists, trees) and custom Radiance animations (focus loop, icon glow, etc).

Parameters:

animationFacet - Animation facet to disallow.

clazz - Control classes for disallowing the animation facet.

isAnimationAllowed

public static boolean isAnimationAllowed(RadianceThemingSlices.AnimationFacet animationFacet)

Checks whether the specified animation facet is allowed on the specified component.

Parameters:

animationFacet - Animation facet.

Returns:

true if the specified animation facet is allowed globally, false otherwise.

setTimelineDuration

public static void setTimelineDuration(long timelineDuration)

getTimelineDuration

public static long getTimelineDuration()

registerLocaleChangeListener

public static void registerLocaleChangeListener(RadianceThemingSlices.LocaleChangeListener localeListener)

Registers a new listener on locale change.

Parameters:

localeListener - New listener on locale change.

unregisterLocaleChangeListener

public static void unregisterLocaleChangeListener(RadianceThemingSlices.LocaleChangeListener localeListener)

Unregisters a listener on locale change.

Parameters:

localeListener - The listener to unregister.

getLocaleChangeListeners

public static Set<RadianceThemingSlices.LocaleChangeListener> getLocaleChangeListeners()

Returns all listeners registered on locale change.

Returns:

All listeners registered on locale change.

getLabelBundle

public static ResourceBundle getLabelBundle()

Retrieves the current label bundle.

Returns:

The current label bundle.

See Also:

• resetLabelBundle()

getLabelBundle

public static ResourceBundle getLabelBundle(Locale locale)

Retrieves the label bundle for the specified locale.

Parameters:

locale - Locale.

Returns:

The label bundle for the specified locale.

resetLabelBundle

public static void resetLabelBundle()

Resets the current label bundle. Useful when the application changes Locale at runtime.

See Also:

• getLabelBundle()

setLabelBundleClassLoader

public static void setLabelBundleClassLoader(ClassLoader labelBundleClassLoader)

Sets the class loader for labelBundle.

Parameters:

labelBundleClassLoader - Class loader for labelBundle.

getLabelBundleClassLoader

public static ClassLoader getLabelBundleClassLoader()

setIconFilterStrategies

public static void setIconFilterStrategies(RadianceThemingSlices.IconFilterStrategy activeIconFilterStrategy,
 RadianceThemingSlices.IconFilterStrategy enabledIconFilterStrategy,
 RadianceThemingSlices.IconFilterStrategy disabledIconFilterStrategy)

Specifies how icons on controls such as buttons, toggle buttons, labels, tabs and menu items are themed.

Parameters:

activeIconFilterStrategy - Icon filter strategy for controls in active states.

enabledIconFilterStrategy - Icon filter strategy for controls in enabled state.

disabledIconFilterStrategy - Icon filter strategy for controls in disabled states.

See Also:

• RadianceThemingCortex.ComponentScope.setIconFilterStrategies(JComponent, RadianceThemingSlices.IconFilterStrategy, RadianceThemingSlices.IconFilterStrategy, RadianceThemingSlices.IconFilterStrategy)

getButtonBarOrder

public static RadianceThemingSlices.ButtonOrder getButtonBarOrder()

Returns the currently set button order for all containers that display grouped buttons, such as JOptionPanes, for example.

Returns:

The currently set button order for all containers that display grouped buttons.

See Also:

• setButtonBarOrder(RadianceThemingSlices.ButtonOrder)

setButtonBarOrder

public static void setButtonBarOrder(RadianceThemingSlices.ButtonOrder buttonBarButtonOrder)

Sets the button order for all containers that display grouped buttons, such as JOptionPanes, for example. The default order is RadianceThemingSlices.ButtonOrder.PLATFORM.

Parameters:

buttonBarButtonOrder - The new button order for all containers that display grouped buttons. The value cannot be null.

See Also:

• getButtonBarOrder()

getButtonBarGravity

public static RadianceThemingSlices.HorizontalGravity getButtonBarGravity()

Returns the currently set button bar gravity for all containers that display grouped buttons, such as JOptionPanes, for example.

Returns:

The currently set button bar gravity for all containers that display grouped buttons.

See Also:

• setButtonBarGravity(RadianceThemingSlices.HorizontalGravity)

setButtonBarGravity

public static void setButtonBarGravity(RadianceThemingSlices.HorizontalGravity buttonBarGravity)

Sets the button bar gravity for all containers that display grouped buttons, such as JOptionPanes, for example. The default gravity is RadianceThemingSlices.HorizontalGravity.PLATFORM.

Parameters:

buttonBarGravity - The new button alignment for all containers that display grouped buttons. The value cannot be null.

See Also:

• getButtonBarGravity()

configureTitleContentGravity

public static void configureTitleContentGravity(RadianceThemingSlices.HorizontalGravity titleTextHorizontalGravity,
 RadianceThemingSlices.HorizontalGravity titleControlButtonGroupHorizontalGravity,
 RadianceThemingSlices.TitleIconHorizontalGravity titleIconHorizontalGravity)

Configures title pane content gravity for all decorated application windows. This will only apply if you are using JFrame.setDefaultLookAndFeelDecorated(boolean) and / or JDialog.setDefaultLookAndFeelDecorated(boolean) APIs with true. The default gravities are RadianceThemingSlices.HorizontalGravity.SWING_DEFAULT and RadianceThemingSlices.TitleIconHorizontalGravity.SWING_DEFAULT. Note that specific windows can have the horizontal gravity of control button group set to a different value with RadianceThemingCortex.WindowScope.extendContentIntoTitlePane(Window, RadianceThemingSlices.HorizontalGravity, RadianceThemingSlices.VerticalGravity) API.

Parameters:

titleTextHorizontalGravity - Horizontal gravity for the title text. The value cannot be null.

titleControlButtonGroupHorizontalGravity - Horizontal gravity for the control button group. The value cannot be null or RadianceThemingSlices.HorizontalGravity.CENTERED.

titleIconHorizontalGravity - Horizontal gravity for the icon. The value cannot be null.

See Also:

• RadianceThemingCortex.WindowScope.extendContentIntoTitlePane(Window, RadianceThemingSlices.HorizontalGravity, RadianceThemingSlices.VerticalGravity)
• getTitleTextHorizontalGravity()
• RadianceThemingCortex.WindowScope.getTitleControlButtonGroupHorizontalGravity(Window)
• getTitleIconHorizontalGravity()
• JFrame.setDefaultLookAndFeelDecorated(boolean)
• JDialog.setDefaultLookAndFeelDecorated(boolean)

getTitleTextHorizontalGravity

public static RadianceThemingSlices.HorizontalGravity getTitleTextHorizontalGravity()

Returns the gravity for the title text in title panes of all decorated application windows.

Returns:

HorizontalGravity for the title text in title panes of all decorated application windows.

See Also:

• configureTitleContentGravity(RadianceThemingSlices.HorizontalGravity, RadianceThemingSlices.HorizontalGravity, RadianceThemingSlices.TitleIconHorizontalGravity)
• RadianceThemingCortex.WindowScope.getTitleControlButtonGroupHorizontalGravity(Window)
• getTitleIconHorizontalGravity()

getTitleIconHorizontalGravity

public static RadianceThemingSlices.TitleIconHorizontalGravity getTitleIconHorizontalGravity()

Returns the gravity for the icon in title panes of all decorated application windows.

Returns:

Horizontal gravity for the icon in title panes of all decorated application windows.

See Also:

• configureTitleContentGravity(RadianceThemingSlices.HorizontalGravity, RadianceThemingSlices.HorizontalGravity, RadianceThemingSlices.TitleIconHorizontalGravity)
• RadianceThemingCortex.WindowScope.getTitleControlButtonGroupHorizontalGravity(Window)
• getTitleIconHorizontalGravity()

setWidgetVisible

public static void setWidgetVisible(boolean visible,
 RadianceThemingSlices.WidgetType... radianceWidgets)

Sets the visibility of the specified widget kind(s). This call applies to all root panes. This method should not be called from inside the initialization sequence of your window. If the specific widget needs to be visible when the window is shown, wrap the call with SwingUtilities.invokeLater(Runnable).

Parameters:

visible - Visibility indication.

radianceWidgets - Widget types.

setLockIconVisible

public static void setLockIconVisible(Boolean visible)

Specifies global visibility of the lock icon on non-editable text components.

Parameters:

visible - If true, all non-editable text components not explicitly configured with RadianceThemingCortex.ComponentScope.setLockIconVisible(JComponent, Boolean) will show a lock icon. Pass null to reset to the default behavior.

See Also:

• RadianceThemingCortex.ComponentScope.setLockIconVisible(JComponent, Boolean)
• setExtraWidgetsPresence(Boolean)
• RadianceThemingCortex.ComponentOrParentChainScope.setExtraWidgetsPresence(JComponent, Boolean)

setCapsLockIconVisible

public static void setCapsLockIconVisible(Boolean visible)

Specifies global visibility of the caps lock icon on password fields. Note that this functionality may not be supported on all platforms. See Toolkit.getLockingKeyState(int) documentation for more.

Parameters:

visible - If true, all password fields not explicitly configured with RadianceThemingCortex.ComponentScope.setCapsLockIconVisible(JPasswordField, Boolean) will show an indicator icon when they are focused and caps lock is on. Pass null to reset to the default behavior.

See Also:

• RadianceThemingCortex.ComponentScope.setCapsLockIconVisible(JPasswordField, Boolean)
• setExtraWidgetsPresence(Boolean)
• RadianceThemingCortex.ComponentOrParentChainScope.setExtraWidgetsPresence(JComponent, Boolean)

setComponentPreviewPainter

public static void setComponentPreviewPainter(PreviewPainter previewPainter)

Specifies global preview painter to be used for showing preview thumbnails. Default implementation is available in the DefaultPreviewPainter.

Parameters:

previewPainter - Global preview painter. Can be null.

See Also:

• RadianceThemingCortex.ComponentOrParentScope.setComponentPreviewPainter(JComponent, PreviewPainter)

setSelectTextOnFocus

public static void setSelectTextOnFocus(Boolean selectTextOnFocus)

Specifies whether the contents of text components should be selected on focus gain.

Parameters:

selectTextOnFocus - If true, the contents of text components will be selected on focus gain. Pass null to reset to the default behavior.

See Also:

• RadianceThemingCortex.ComponentOrParentChainScope.setSelectTextOnFocus(JComponent, Boolean)

setTextEditContextMenuPresence

public static void setTextEditContextMenuPresence(Boolean hasEditContextMenu)

Specifies whether text components should have the edit context menu (with Cut / Copy / Paste / ... menu items)

Parameters:

hasEditContextMenu - If true, text components will have the edit context menu (with Cut / Copy / Paste / ... menu items). Pass null to reset to the default behavior.

See Also:

• RadianceThemingCortex.ComponentScope.setTextEditContextMenuPresence(JTextComponent, Boolean)

setAutomaticDragAndDropSupportPresence

public static void setAutomaticDragAndDropSupportPresence(Boolean hasAutomaticDragAndDropSupport)

Specifies whether trees should have should have automatic drag and drop support.

Parameters:

hasAutomaticDragAndDropSupport - If true, trees will have automatic drag and drop support. Pass null to reset to the default behavior.

See Also:

• RadianceThemingCortex.ComponentScope.setAutomaticDragAndDropSupportPresence(JTree, Boolean)

setAutomaticScrollPresence

public static void setAutomaticScrollPresence(Boolean hasAutomaticScroll)

Specifies whether scroll panes should have auto-scroll support invoked on mouse button click that triggers popups.

Parameters:

hasAutomaticScroll - If true, scroll panes will have auto-scroll support invoked on mouse button click that triggers popups. Pass null to reset to the default behavior.

See Also:

• RadianceThemingCortex.ComponentScope.setAutomaticScrollPresence(JScrollPane, Boolean)
• setExtraWidgetsPresence(Boolean)
• RadianceThemingCortex.ComponentOrParentChainScope.setExtraWidgetsPresence(JComponent, Boolean)

setButtonIgnoreMinimumSize

public static void setButtonIgnoreMinimumSize(Boolean buttonIgnoreMinimumSize)

Specifies whether buttons should ignore the default (minimum) dimension. Note that RadianceButtonShaper implementations are not required to respect this call. The current implementations of the default PillButtonShaper and ClassicButtonShaper respect this setting.

Parameters:

buttonIgnoreMinimumSize - If true, buttons will ignore the default (minimum) size under button shapers that respect this setting. Pass null to reset to the default behavior.

See Also:

• RadianceThemingCortex.ComponentOrParentScope.setButtonIgnoreMinimumSize(JComponent, Boolean)

setBackgroundAppearanceStrategy

public static void setBackgroundAppearanceStrategy(RadianceThemingSlices.BackgroundAppearanceStrategy backgroundAppearanceStrategy)

Specifies when components should draw their background.

Parameters:

backgroundAppearanceStrategy - Background appearance strategy. Pass null to reset to the default behavior (to ALWAYS)

See Also:

• RadianceThemingCortex.ComponentOrParentScope.setBackgroundAppearanceStrategy(JComponent, RadianceThemingSlices.BackgroundAppearanceStrategy)

setToolbarButtonCornerRadius

public static void setToolbarButtonCornerRadius(float toolbarButtonCornerRadius)

Specifies corner radius for all toolbar buttons.

Parameters:

toolbarButtonCornerRadius - Corner radius for all toolbar buttons.

See Also:

• RadianceThemingCortex.ComponentScope.setToolbarButtonCornerRadius(AbstractButton, float)
• RadianceThemingCortex.ComponentOrParentChainScope.setToolbarButtonCornerRadius(JToolBar, float)

setExtraWidgetsPresence

public static void setExtraWidgetsPresence(Boolean extraWidgetsPresence)

Specifies that extra UI elements (such as menu items in system menu or lock borders) can be shown.

Parameters:

extraWidgetsPresence - If true, extra UI elements (such as menu items in system menu or lock borders) can be shown. Pass null to reset to the default behavior.

See Also:

• RadianceThemingCortex.ComponentOrParentChainScope.setExtraWidgetsPresence(JComponent, Boolean)

setColorizationFactor

public static void setColorizationFactor(double colorizationFactor)

Specifies colorization amount applied to the background and foreground of the current color tokens and all control. By default, when the application does not use any custom colors, all the controls are painted with the colors of the current color tokens / skin. The colors coming from the look-and-feel implement the marker UIResource interface which allows the UI delegates to differentiate between application-specific colors which are not changed, and the LAF-provide colors that are changed on LAF switch.

Calling this method installs the "smart colorization" mode which uses the colors of the current color tokens and the custom background / foreground colors (when installed by application) to colorize the relevant portions of the control. For example, on checkbox the custom background color will be used to colorize the check box itself, while the custom foreground color will be applied to the check box text and the check mark.

Value of 0.0 of colorization amount results in Radiance completely ignoring the custom application background and foreground colors set on the components - no colorization. Values closer to 1.0 result in almost full usage of the custom application background and foreground colors set on the components. Note that in order to maintain the gradients (fill, border, etc), even value of 1.0 does not result in full custom color being applied to the relevant visuals of the control.

Calling this method applies colorization amount to all components that do not specify a custom value with RadianceThemingCortex.ComponentOrParentChainScope.setColorizationFactor(JComponent, double) calls.

The default colorization amount (when this method is not called at all) is 0.5. This means that applications that install custom background / foreground colors on their UI controls will see them colorized with 50% "strength", even without calling this method.

Parameters:

colorizationFactor - Colorization factor to apply to the component and its nested children.

See Also:

• RadianceThemingCortex.ComponentOrParentChainScope.setColorizationFactor(JComponent, double)

setTabCloseButtonsVisible

public static void setTabCloseButtonsVisible(Boolean tabCloseButtonsVisible)

Configures visibility of close buttons on tabbed pane tabs.

Parameters:

tabCloseButtonsVisible - If true, tabs in tabbed panes will show close buttons.

See Also:

• RadianceThemingCortex.ComponentScope.setTabCloseButtonVisible(JComponent, Boolean)
• RadianceThemingCortex.ComponentScope.setTabCloseButtonsVisible(JTabbedPane, Boolean)

setTabCloseCallback

public static void setTabCloseCallback(TabCloseCallback tabCloseCallback)

Configures the callback for deciding on the tab close type on tabbed pane tabs. Note that this is only relevant for tabs configured with RadianceThemingCortex.ComponentScope.setTabCloseButtonVisible(JComponent, Boolean), RadianceThemingCortex.ComponentScope.setTabCloseButtonsVisible(JTabbedPane, Boolean) and setTabCloseButtonsVisible(Boolean) APIs.

Parameters:

tabCloseCallback - Callback for deciding on the tab close type on tabbed pane tabs.

See Also:

• RadianceThemingCortex.ComponentScope.setTabCloseCallback(JComponent, TabCloseCallback)
• RadianceThemingCortex.ComponentScope.setTabCloseCallback(JTabbedPane, TabCloseCallback)

setRunModifiedAnimationOnTabCloseButton

public static void setRunModifiedAnimationOnTabCloseButton(Boolean runModifiedAnimationOnTabCloseButton)

Specifies that only the close button of a marked-as-modified tab component should pulsate. By default, the animation on modified tabs is on the entire tab rectangle. Note that this is only relevant for tabs configured with RadianceThemingCortex.ComponentScope.setTabContentsModified(JComponent, Boolean)

Parameters:

runModifiedAnimationOnTabCloseButton - If true, the marked-as-modified animation will run only on the tab close button.

See Also:

• RadianceThemingCortex.ComponentScope.setRunModifiedAnimationOnTabCloseButton(JTabbedPane, Boolean)
• RadianceThemingCortex.ComponentScope.setRunModifiedAnimationOnTabCloseButton(JComponent, Boolean)

setTabContentPaneBorderKind

public static void setTabContentPaneBorderKind(RadianceThemingSlices.TabContentPaneBorderKind tabContentPaneBorderKind)

Specifies the content pane border kind for tabbed panes.

Parameters:

tabContentPaneBorderKind - Content pane border kind for tabbed panes.

See Also:

• RadianceThemingCortex.ComponentScope.setTabContentPaneBorderKind(JTabbedPane, RadianceThemingSlices.TabContentPaneBorderKind)

setNumberOfPasswordEchoesPerCharacter

public static void setNumberOfPasswordEchoesPerCharacter(int echoCount)

Specifies the number of echo characters for each password character in password fields.

Parameters:

echoCount - Number of echo characters for each password character in password fields.

See Also:

• RadianceThemingCortex.ComponentScope.setNumberOfPasswordEchoesPerCharacter(JPasswordField, int)

setMenuGutterFillAlpha

public static void setMenuGutterFillAlpha(float menuGutterFillAlpha)

Specifies the menu gutter fill alpha. Menu gutter is the part of the menu where checkmarks and icons are painted. The current / default menu gutter fill alpha can be obtained by calling getMenuGutterFillAlpha().

Parameters:

menuGutterFillAlpha - Menu gutter fill alpha.

See Also:

• getMenuGutterFillAlpha()

getMenuGutterFillAlpha

public static float getMenuGutterFillAlpha()

Returns the menu gutter fill alpha. Menu gutter is the part of the menu where checkmarks and icons are painted.

Returns:

Menu gutter fill alpha.

See Also:

• setMenuGutterFillAlpha(float)

setTraceFilename

public static void setTraceFilename(String traceFilename)

Specifies the trace filename. The trace file will contain output of the memory analyser which can be used to pinpoint the memory leaks.

Parameters:

traceFilename - Filename for tracing the memory allocations.

setFocusKind

public static void setFocusKind(RadianceThemingSlices.FocusKind focusKind)

Specifies the kind of focus indication to be used on application components.

Parameters:

focusKind - Kind of focus indication to be used on application components.

See Also:

• RadianceThemingCortex.ComponentOrParentChainScope.setFocusKind(JComponent, RadianceThemingSlices.FocusKind)

setComboBoxPrototypeCallback

public static void setComboBoxPrototypeCallback(ComboPopupPrototypeCallback comboPopupPrototypeCallback)

Specifies the combobox popup prototype callback which is used to compute the width of the popups at runtime.

Parameters:

comboPopupPrototypeCallback - Popup prototype callback which is used to compute the width of the popups at runtime.

See Also:

• RadianceThemingCortex.ComponentScope.setComboBoxPrototypeCallback(JComboBox, ComboPopupPrototypeCallback)

setComboBoxPrototypeDisplayValue

public static void setComboBoxPrototypeDisplayValue(Object comboPopupPrototypeDisplayValue)

Specifies the combobox popup prototype display value which is used to compute the width of the popups at runtime.

Parameters:

comboPopupPrototypeDisplayValue - Popup prototype display value which is used to compute the width of the popups at runtime.

See Also:

• RadianceThemingCortex.ComponentScope.setComboBoxPrototypeDisplayValue(JComboBox, Object)
• setComboBoxPrototypeCallback(ComboPopupPrototypeCallback)

setComboBoxPopupPlacementStrategy

public static void setComboBoxPopupPlacementStrategy(RadianceThemingSlices.PopupPlacementStrategy comboBoxPopupPlacementStrategy)

Specifies the combobox popup placement strategy. Pass null to reset to the default placement strategy. Note that the combo arrow changes in accordance with the combo popup placement strategy.

Parameters:

comboBoxPopupPlacementStrategy - Placement strategy for combobox popups.

See Also:

• RadianceThemingCortex.ComponentScope.setComboBoxPopupPlacementStrategy(JComboBox, RadianceThemingSlices.PopupPlacementStrategy)

getBlankImage

public static BufferedImage getBlankImage(double scaleFactor,
 int width,
 int height)

setUseDefaultColorChooser

public static void setUseDefaultColorChooser()