com.alee.utils

Class SwingUtils

java.lang.Object

com.alee.utils.SwingUtils

public final class SwingUtils
extends Object

This class provides a set of utilities to work with Swing components, their settings and events.

Author:

Mikle Garin

Field Summary

Fields

Modifier and Type	Field and Description
static String	HANDLES_ENABLE_STATE Client property key that identifies that component can handle enabled state changes.
static Color	RENDERING_FIX_COLOR Constant transparent color used for text rendering fix.

Method Summary

Modifier and Type	Method and Description
static void	changeOrientation(Component component) Applies opposite component orientation to the specified component and all of its children.
static List<Container>	collectAllContainers(Container container) Returns list of all sub-containers for this container.
static List<Container>	collectAllContainers(Container container, List<Container> containers) Returns list of all sub-containers for this container.
static Component	compositeRequestFocus(Component component) Performs composite focus request and returns Component that requested focus.
static void	copyOrientation(Component from, Component to) Copies component orientation from one component to another.
static BufferedImage	createComponentSnapshot(Component content) Returns component snapshot image.
static BufferedImage	createComponentSnapshot(Component content, float opacity) Returns component snapshot image.
static BufferedImage	createComponentSnapshot(Component content, int width, int height) Returns component snapshot image of specified size.
static BufferedImage	createComponentSnapshot(Component content, int width, int height, float opacity) Returns component snapshot image of specified size.
static Font[]	createFonts(String[] fontNames) Returns an array of fonts created using specified array of font names.
static Insets	decrease(Insets insets, Insets amount) Returns insets decreased by amount specified in amount.
static void	destroyContainer(Container container) Destroys container by destroying its children structure and removing all listeners.
static List<Component>	disableRecursively(Component component, boolean startFromChildren, boolean excludePanels, Component... excluded) Disables component and all of its children recursively.
static List<Component>	disableRecursively(Component component, boolean startFromChildren, boolean excludePanels, List<Component> excluded) Disables component and all of its children recursively.
static void	enable(List<Component> disabled) Enables specified components.
static void	equalizeComponentsHeight(Component... components) Makes all specified component heights equal.
static void	equalizeComponentsHeight(List<? extends Component> components) Makes all specified component heights equal.
static void	equalizeComponentsHeight(List<String> properties, Component... components) Makes all specified component heights equal.
static void	equalizeComponentsHeight(List<String> properties, List<? extends Component> components) Makes all specified component heights equal.
static void	equalizeComponentsSize(Component... components) Makes all specified component sizes equal.
static void	equalizeComponentsSize(List<? extends Component> components) Makes all specified component sizes equal.
static void	equalizeComponentsSize(List<String> properties, Component... components) Makes all specified component sizes equal.
static void	equalizeComponentsSize(List<String> properties, List<? extends Component> components) Makes all specified component sizes equal.
static void	equalizeComponentsWidth(Component... components) Makes all specified component widths equal.
static void	equalizeComponentsWidth(List<? extends Component> components) Makes all specified component widths equal.
static void	equalizeComponentsWidth(List<String> properties, Component... components) Makes all specified component widths equal.
static void	equalizeComponentsWidth(List<String> properties, List<? extends Component> components) Makes all specified component widths equal.
static List<Component>	findComponentsWithText(String text, Component component) Returns list of all components that visually contains the specified text.
static List<Component>	findComponentsWithText(String text, Component component, List<Component> components) Returns list of all components that visually contains the specified text.
static Component	findFocusableComponent(Container container) Returns first focusable component found in the container.
static void	firePropertyChanged(Component component, String property, Object oldValue, Object newValue) Fires painter property change event.
static long	frameRateDelay(int frameRate) Returns delay in milliseconds for the preferred frame rate.
static KeyStroke	getAccelerator(HotkeyData hotkey) Returns menu item accelerator for the specified hotkey.
static Window	getActiveWindow() Returns active application window.
static Window	getAvailableWindow() Returns first available visible application window.
static Map<Component,Dimension>	getChildPreferredSizes(Container container) Returns map of container child components preferred sizes.
static Container	getContentPane(Component component) Returns content pane for the specified component or null if it doesn't exist.
static Font	getDefaultLabelFont() Returns default label font.
static FontMetrics	getDefaultLabelFontMetrics() Returns default label font metrics.
static <C extends Component> C	getFirst(Container container, Class<C> componentClass) Returns first component placed in the specified container which is instance of specified class type or null if none found.
static <C extends Component> C	getFirst(Container container, Class<C> componentClass, boolean recursive) Returns first component placed in the specified container which is instance of specified class type or null if none found.
static <C extends Container> C	getFirstParent(Component component, Class<C> parentClass) Returns first parent which is instance of specified class type or null if none found.
static <C extends JComponent> C	getFirstParentSupportingDrop(Component component) Returns first parent component which supports drag and drop actions.
static int	getFocusAcceleratorKeyMask() Returns focus accelerator key mask.
static FontMetrics	getFontMetrics(JComponent component, Graphics g) Returns the FontMetrics for the current Font of the passed in Graphics.
static FontMetrics	getFontMetrics(JComponent component, Graphics g, Font font) Returns the FontMetrics for the specified Font.
static String[]	getFontNames() Returns system font names array.
static Font[]	getFonts() Returns system fonts array.
static Component	getGlassPane(Component component) Returns glass pane for the specified component or null if it doesn't exist.
static boolean	getHonorUserBorders(JComponent component) Returns whether UI delegate should honor a user-specified border on this component or not.
static HotkeyData	getHotkeyData(KeyStroke keyStroke) Returns hotkey data extracted from the specified key stroke.
static JLayeredPane	getLayeredPane(Component component) Returns layered pane for the specified component or null if it doesn't exist.
static int	getMnemonicIndex(String text, int mnemonic) Returns index of the first occurrence of mnemonic within string text.
static JScrollPane	getScrollPane(Component component) Returns JSplitPane for the specified Component if it is directly added into one, null otherwise.
static int	getSystemShortcutModifier() Returns system shortcut modifier.
static ButtonGroup	groupButtons(AbstractButton... buttons) Groups specified buttons and returns created button group.
static void	groupButtons(ButtonGroup buttonGroup, AbstractButton... buttons) Groups buttons in the specified button group.
static ButtonGroup	groupButtons(Container container) Groups all buttons inside this container and returns created button group.
static ButtonGroup	groupButtons(Container container, boolean recursive) Groups all buttons inside this container and all sub-containers if requested and returns created button group.
static void	groupButtons(Container container, boolean recursive, ButtonGroup buttonGroup) Groups all buttons inside this container and all sub-containers if requested and returns created button group.
static boolean	hasFocusableComponent(Container container) Returns whether at least one of child components within the specified container is focusable or not.
static boolean	hasFocusOwner(Component component) Returns whether component or any of its children has focus or not.
static String	hotkeyToString(boolean isCtrl, boolean isAlt, boolean isShift, Integer keyCode) Returns readable form for specified hotkey.
static String	hotkeyToString(HotkeyData hotkeyData) Returns readable form of specified hotkey data.
static String	hotkeyToString(KeyEvent keyEvent) Returns readable form of hotkey triggered by specified key event.
static String	hotkeyToString(KeyStroke keyStroke) Returns readable form of specified key stroke.
static Dimension	increase(Dimension dimension, Insets amount) Returns dimension increased by amount specified in amount.
static Insets	increase(Insets insets, Insets amount) Returns insets increased by amount specified in amount.
static int	indexOf(Container container, Component child) Returns component index within the specified parent container.
static boolean	isAlt(InputEvent event) Returns whether ALT modifier is triggered by the specified event or not.
static boolean	isAlt(int modifiers) Returns whether ALT modifier is triggered by the specified modifiers or not.
static boolean	isCtrl(InputEvent event) Returns whether CTRL modifier is triggered by the specified event or not.
static boolean	isCtrl(int modifiers) Returns whether CTRL modifier is triggered by the specified modifiers or not.
static boolean	isDoubleClick(MouseEvent e) Returns whether or not event represents most common double click event.
static boolean	isDoubleClick(MouseEvent e, boolean repeatable) Returns whether or not event represents most common double click event.
static boolean	isEmpty(Insets insets) Returns whether or not provided insets are empty.
static boolean	isEmpty(JTextComponent component) Returns whether or not specified JTextComponent content is empty.
static boolean	isEqualOrChild(Component component, Component child) Returns whether the first component or any of its children are equal to second component or not.
static boolean	isHandlesEnableState(Component component) Returns whether or not HANDLES_ENABLE_STATE client property is set to true in the specified Component.
static boolean	isHeavyWeightWindow(Window window) Returns whether specified window is a HeavyWeightWindow or not.
static boolean	isLeftMouseButton(MouseEvent e) Returns whether event involves left mouse button or not.
static boolean	isMiddleMouseButton(MouseEvent e) Returns whether event involves middle mouse button or not.
static boolean	isOpaque(Component component) Returns whether or not specified component is opaque.
static boolean	isPopupTrigger(MouseEvent e) Returns whether the specific mouse events triggers popup menu or not.
static boolean	isPreserveBorders(JComponent component) Returns whether UI delegate should preserve current border on this component or not.
static boolean	isRightMouseButton(MouseEvent e) Returns whether event involves right mouse button or not.
static boolean	isShift(InputEvent event) Returns whether SHIFT modifier is triggered by the specified event or not.
static boolean	isShift(int modifiers) Returns whether SHIFT modifier is triggered by the specified modifiers or not.
static boolean	isShortcut(InputEvent event) Returns whether specified event contains shortcut modifier or not.
static boolean	isUIResource(Object value) Returns whether or not specified value is a UI resource.
static Dimension	max(Dimension dimension1, Dimension dimension2) Returns maximum dimension combined from specified ones.
static Insets	max(Insets insets1, Insets insets2) Returns maximum insets combined from the specified ones.
static Dimension	maxNonNull(Dimension dimension1, Dimension dimension2) Returns maximum dimension combined from specified ones.
static Insets	maxNonNull(Insets insets1, Insets insets2) Returns maximum insets combined from the specified ones.
static int	maxPreferredHeight(Component... components) Returns maximum component height.
static Dimension	maxPreferredSize(Component... components) Returns maximum dimension combined from specified components dimensions.
static Dimension	maxPreferredSize(Component component1, Component component2) Returns maximum dimension combined from specified components dimensions.
static int	maxPreferredWidth(Component... components) Returns maximum component width.
static Dimension	min(Dimension dimension1, Dimension dimension2) Returns minimum dimension combined from specified ones.
static Insets	min(Insets insets1, Insets insets2) Returns minimum insets combined from the specified ones.
static Dimension	minNonNull(Dimension dimension1, Dimension dimension2) Returns minimum dimension combined from specified ones.
static Insets	minNonNull(Insets insets1, Insets insets2) Returns minimum insets combined from the specified ones.
static Dimension	minPreferredSize(Component... components) Returns maximum dimension combined from specified components dimensions.
static Dimension	minPreferredSize(Component component1, Component component2) Returns minimum dimension combined from specified components dimensions.
static Rectangle	moveBy(Rectangle rectangle, Point point) Returns Rectangle which location is moved by X and Y from the specified Point .
static void	packColumnWidth(JTable table, int col) Packs table column at the specified index to its preferred width.
static void	packColumnWidth(JTable table, int col, int margin) Packs table column at the specified index to its preferred width.
static void	packColumnWidths(JTable table) Packs all table columns to their preferred width.
static void	packColumnWidths(JTable table, int margin) Packs all table columns to their preferred width.
static void	packRowHeights(JTable table) Packs all table rows to their preferred height.
static void	removeFromParent(Component component, boolean update) Removes Component from its current parent if it has one.
static void	removeHandlesEnableStateMark(JComponent component) Removes HANDLES_ENABLE_STATE client property from the specified JComponent.
static void	restoreTextAntialias(Graphics2D g2d, Map hints) Restores text antialiasing hints into specified graphics context
static void	restoreTextAntialias(Graphics g, Map hints) Restores text antialiasing hints into specified graphics context
static void	setBackgroundRecursively(Component component, Color bg) Sets background color of component and all of its children.
static void	setBackgroundRecursively(Component component, Color bg, boolean childrenOnly) Sets background color of component and all of its children.
static void	setDoubleBufferedRecursively(Component component, boolean doubleBuffered) Sets double buffered state of component and all of its children.
static void	setDoubleBufferedRecursively(Component component, boolean doubleBuffered, boolean childrenOnly) Sets double buffered state of component and all of its children.
static void	setEnabledRecursively(Component component, boolean enabled) Sets enabled state of component and all of its children.
static void	setEnabledRecursively(Component component, boolean enabled, boolean startFromChildren) Sets enabled state of component and all of its children.
static void	setFocusableRecursively(JComponent component, boolean focusable) Sets focusable state of component and all of its children.
static void	setFocusableRecursively(JComponent component, boolean focusable, boolean childrenOnly) Sets focusable state of component and all of its children.
static void	setFontRecursively(JComponent component, Font font) Sets font of component and all of its children.
static void	setFontRecursively(JComponent component, Font font, boolean childrenOnly) Sets font of component and all of its children.
static void	setForegroundRecursively(JComponent component, Color foreground) Sets foreground color of component and all of its children.
static void	setForegroundRecursively(JComponent component, Color foreground, boolean childrenOnly) Sets foreground color of component and all of its children.
static void	setHandlesEnableStateMark(JComponent component) Adds HANDLES_ENABLE_STATE client property into the specified JComponent.
static void	setHonorUserBorders(JComponent component, boolean honor) Sets whether UI delegate should honor a user-specified border on this component or not.
static void	setOpaqueRecursively(Component component, boolean opaque) Sets opaque state of component and all of its children.
static void	setOpaqueRecursively(Component component, boolean opaque, boolean childrenOnly) Sets opaque state of component and all of its children.
static Map	setupTextAntialias(Graphics g) Installs text antialiasing hints into specified graphics context.
static Map	setupTextAntialias(Graphics2D g2d) Installs text antialiasing hints into specified graphics context.
static Map	setupTextAntialias(Graphics2D g2d, TextRasterization rasterization) Installs text antialiasing hints into specified graphics context.
static Map	setupTextAntialias(Graphics g, TextRasterization rasterization) Installs text antialiasing hints into specified graphics context.
static Dimension	shrink(Dimension dimension, Insets insets) Returns dimension shrunk by provided insets.
static Rectangle	shrink(Rectangle rectangle, Insets insets) Returns Rectangle shrunk by provided Insets.
static Dimension	stretch(Dimension dimension, Insets insets) Returns dimension stretched by provided insets.
static int	stringWidth(FontMetrics fontMetrics, String string) Returns the width of the passed in String.
static Insets	toRTL(Insets insets) Returns insets converted into RTL orientation.
static void	update(Component component) Performs full component view update.
static void	updateGlobalOrientation(ComponentOrientation orientation) Sets specified component orientation for all existing components.

Methods inherited from class java.lang.Object

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

Field Detail

HANDLES_ENABLE_STATE

@NotNull
public static final String HANDLES_ENABLE_STATE

Client property key that identifies that component can handle enabled state changes.

See Also:

Constant Field Values

RENDERING_FIX_COLOR

@NotNull
public static final Color RENDERING_FIX_COLOR

Constant transparent color used for text rendering fix.

Method Detail

isOpaque

public static boolean isOpaque(@NotNull
                               Component component)

Returns whether or not specified component is opaque.

Parameters:

component - component to check opacity for

Returns:

true if specified component is opaque, false otherwise

update

public static void update(Component component)

Performs full component view update.

Parameters:

component - component to update

removeFromParent

public static void removeFromParent(@Nullable
                                    Component component,
                                    boolean update)

Removes Component from its current parent if it has one.

Parameters:

component - Component to remove from its parent

update - whether or not should update parent Container layout and size

isEmpty

public static boolean isEmpty(@NotNull
                              JTextComponent component)

Returns whether or not specified JTextComponent content is empty.

Parameters:

component - JTextComponent to check

Returns:

true if specified JTextComponent content is empty, false otherwise

isEmpty

public static boolean isEmpty(@Nullable
                              Insets insets)

Returns whether or not provided insets are empty. null insets are considered as empty as well.

Parameters:

insets - insets to process

Returns:

true if provided insets are empty, false otherwise

isPreserveBorders

public static boolean isPreserveBorders(@NotNull
                                        JComponent component)

Returns whether UI delegate should preserve current border on this component or not.

Parameters:

component - component to process

Returns:

true if UI delegate should preserve current border on this component, false otherwise

isUIResource

public static boolean isUIResource(@Nullable
                                   Object value)

Returns whether or not specified value is a UI resource.

Parameters:

value - value Object to process

Returns:

true if specified value is a UI resource, false otherwise

getHonorUserBorders

public static boolean getHonorUserBorders(@NotNull
                                          JComponent component)

Returns whether UI delegate should honor a user-specified border on this component or not.

Parameters:

component - component to process

Returns:

true if UI delegate should honor a user-specified border on this component, false otherwise

setHonorUserBorders

public static void setHonorUserBorders(@NotNull
                                       JComponent component,
                                       boolean honor)

Sets whether UI delegate should honor a user-specified border on this component or not.

Parameters:

component - component to set property for

honor - whether UI delegate should honor a user-specified border on this component or not

isLeftMouseButton

public static boolean isLeftMouseButton(@NotNull
                                        MouseEvent e)

Returns whether event involves left mouse button or not.

Parameters:

e - mouse event

Returns:

true if event involves left mouse button, false otherwise

isMiddleMouseButton

public static boolean isMiddleMouseButton(@NotNull
                                          MouseEvent e)

Returns whether event involves middle mouse button or not.

Parameters:

e - mouse event

Returns:

true if event involves middle mouse button, false otherwise

isRightMouseButton

public static boolean isRightMouseButton(@NotNull
                                         MouseEvent e)

Returns whether event involves right mouse button or not.

Parameters:

e - mouse event

Returns:

true if event involves right mouse button, false otherwise

isDoubleClick

public static boolean isDoubleClick(@NotNull
                                    MouseEvent e)

Returns whether or not event represents most common double click event.

Parameters:

e - mouse event

Returns:

true if event represents most common double click event, false otherwise

isDoubleClick

public static boolean isDoubleClick(@NotNull
                                    MouseEvent e,
                                    boolean repeatable)

Returns whether or not event represents most common double click event.

Parameters:

e - mouse event

repeatable - whether or not double click condition can be accepted more than once within a single click sequence

Returns:

true if event represents most common double click event, false otherwise

packRowHeights

public static void packRowHeights(@NotNull
                                  JTable table)

Packs all table rows to their preferred height.

Parameters:

table - table to process

packColumnWidths

public static void packColumnWidths(@NotNull
                                    JTable table)

Packs all table columns to their preferred width.

Parameters:

table - table to process

packColumnWidths

public static void packColumnWidths(@NotNull
                                    JTable table,
                                    int margin)

Packs all table columns to their preferred width.

Parameters:

table - table to process

margin - column side margin

packColumnWidth

public static void packColumnWidth(@NotNull
                                   JTable table,
                                   int col)

Packs table column at the specified index to its preferred width.

Parameters:

table - table to process

col - column index

packColumnWidth

public static void packColumnWidth(@NotNull
                                   JTable table,
                                   int col,
                                   int margin)

Packs table column at the specified index to its preferred width.

Parameters:

table - table to process

col - column index

margin - column side margin

isPopupTrigger

public static boolean isPopupTrigger(@NotNull
                                     MouseEvent e)

Returns whether the specific mouse events triggers popup menu or not. This method might act differently on different operating systems.

Parameters:

e - mouse event

Returns:

true if the specific mouse events triggers popup menu, false otherwise

destroyContainer

public static void destroyContainer(@NotNull
                                    Container container)

Destroys container by destroying its children structure and removing all listeners.

Parameters:

container - container to destroy

collectAllContainers

@NotNull
public static List<Container> collectAllContainers(@NotNull
                                                            Container container)

Returns list of all sub-containers for this container.

Parameters:

container - container to process

Returns:

list of all sub-containers

collectAllContainers

@NotNull
public static List<Container> collectAllContainers(@NotNull
                                                            Container container,
                                                            @NotNull
                                                            List<Container> containers)

Returns list of all sub-containers for this container.

Parameters:

container - container to process

containers - list to collect sub-containers into

Returns:

list of all sub-containers

groupButtons

@NotNull
public static ButtonGroup groupButtons(@NotNull
                                                Container container)

Groups all buttons inside this container and returns created button group.

Parameters:

container - container to process

Returns:

created button group

groupButtons

@NotNull
public static ButtonGroup groupButtons(@NotNull
                                                Container container,
                                                boolean recursive)

Groups all buttons inside this container and all sub-containers if requested and returns created button group.

Parameters:

container - container to process

recursive - whether to check all sub-containers or not

Returns:

created button group

groupButtons

public static void groupButtons(@NotNull
                                Container container,
                                boolean recursive,
                                @NotNull
                                ButtonGroup buttonGroup)

Groups all buttons inside this container and all sub-containers if requested and returns created button group.

Parameters:

container - container to process

recursive - whether to check all sub-containers or not

buttonGroup - button group

groupButtons

@NotNull
public static ButtonGroup groupButtons(@NotNull
                                                AbstractButton... buttons)

Groups specified buttons and returns created button group.

Parameters:

buttons - buttons to group

Returns:

created button group

groupButtons

public static void groupButtons(@NotNull
                                ButtonGroup buttonGroup,
                                @NotNull
                                AbstractButton... buttons)

Groups buttons in the specified button group.

Parameters:

buttonGroup - button group

buttons - buttons to group

copyOrientation

public static void copyOrientation(@NotNull
                                   Component from,
                                   @NotNull
                                   Component to)

Copies component orientation from one component to another.

Parameters:

from - component to copy orientation from

to - component to copy orientation into

changeOrientation

public static void changeOrientation(@NotNull
                                     Component component)

Applies opposite component orientation to the specified component and all of its children.

Parameters:

component - component to change orientation for

updateGlobalOrientation

public static void updateGlobalOrientation(@NotNull
                                           ComponentOrientation orientation)

Sets specified component orientation for all existing components.

Parameters:

orientation - component orientation to set

isHeavyWeightWindow

public static boolean isHeavyWeightWindow(@Nullable
                                          Window window)

Returns whether specified window is a HeavyWeightWindow or not.

Parameters:

window - window to process

Returns:

true if specified window is a HeavyWeightWindow, false otherwise

getFirstParent

@Nullable
public static <C extends Container> C getFirstParent(@NotNull
                                                               Component component,
                                                               @NotNull
                                                               Class<C> parentClass)

Returns first parent which is instance of specified class type or null if none found.

Type Parameters:

C - parent component class type

Parameters:

component - component to look parent for

parentClass - parent component class

Returns:

first parent which is instance of specified class type or null if none found

getFirst

@Nullable
public static <C extends Component> C getFirst(@NotNull
                                                         Container container,
                                                         @NotNull
                                                         Class<C> componentClass)

Returns first component placed in the specified container which is instance of specified class type or null if none found.

Type Parameters:

C - component class type

Parameters:

container - container to look for component in

componentClass - component class

Returns:

first component placed in the specified container which is instance of specified class type or null if none found

getFirst

@Nullable
public static <C extends Component> C getFirst(@NotNull
                                                         Container container,
                                                         @NotNull
                                                         Class<C> componentClass,
                                                         boolean recursive)

Returns first component placed in the specified container which is instance of specified class type or null if none found.

Type Parameters:

C - component class type

Parameters:

container - container to look for component in

componentClass - component class

recursive - whether to check all sub-containers or not

Returns:

first component placed in the specified container which is instance of specified class type or null if none found

getFirstParentSupportingDrop

@Nullable
public static <C extends JComponent> C getFirstParentSupportingDrop(@NotNull
                                                                              Component component)

Returns first parent component which supports drag and drop actions.

Type Parameters:

C - parent supporting drop component class type

Parameters:

component - component to look parent supporting drop for

Returns:

first parent component which supports drag and drop actions

getAvailableWindow

@Nullable
public static Window getAvailableWindow()

Returns first available visible application window.

Returns:

first available visible application window

getContentPane

@Nullable
public static Container getContentPane(@NotNull
                                                 Component component)

Returns content pane for the specified component or null if it doesn't exist.

Parameters:

component - component to look under

Returns:

content pane for the specified component or null if it doesn't exist

getLayeredPane

@Nullable
public static JLayeredPane getLayeredPane(@NotNull
                                                    Component component)

Returns layered pane for the specified component or null if it doesn't exist.

Parameters:

component - component to look under

Returns:

layered pane for the specified component or null if it doesn't exist

getGlassPane

@Nullable
public static Component getGlassPane(@NotNull
                                               Component component)

Returns glass pane for the specified component or null if it doesn't exist.

Parameters:

component - component to look under

Returns:

glass pane for the specified component or null if it doesn't exist

increase

@NotNull
public static Insets increase(@NotNull
                                       Insets insets,
                                       @Nullable
                                       Insets amount)

Returns insets increased by amount specified in amount.

Parameters:

insets - insets to increased

amount - increase amount

Returns:

insets increased by amount specified in amount

increase

@NotNull
public static Dimension increase(@NotNull
                                          Dimension dimension,
                                          @Nullable
                                          Insets amount)

Returns dimension increased by amount specified in amount.

Parameters:

dimension - dimension to increased

amount - increase amount

Returns:

dimension increased by amount specified in amount

decrease

@NotNull
public static Insets decrease(@NotNull
                                       Insets insets,
                                       @Nullable
                                       Insets amount)

Returns insets decreased by amount specified in amount.

Parameters:

insets - insets to decreased

amount - decrease amount

Returns:

insets decreased by amount specified in amount

max

@Nullable
public static Insets max(@Nullable
                                   Insets insets1,
                                   @Nullable
                                   Insets insets2)

Returns maximum insets combined from the specified ones.

Parameters:

insets1 - first insets

insets2 - second insets

Returns:

maximum insets

maxNonNull

@NotNull
public static Insets maxNonNull(@NotNull
                                         Insets insets1,
                                         @NotNull
                                         Insets insets2)

Returns maximum insets combined from the specified ones.

Parameters:

insets1 - first insets

insets2 - second insets

Returns:

maximum insets

min

@Nullable
public static Insets min(@Nullable
                                   Insets insets1,
                                   @Nullable
                                   Insets insets2)

Returns minimum insets combined from the specified ones.

Parameters:

insets1 - first insets

insets2 - second insets

Returns:

minimum insets

minNonNull

@NotNull
public static Insets minNonNull(@NotNull
                                         Insets insets1,
                                         @NotNull
                                         Insets insets2)

Returns minimum insets combined from the specified ones.

Parameters:

insets1 - first insets

insets2 - second insets

Returns:

minimum insets

maxPreferredSize

@NotNull
public static Dimension maxPreferredSize(@NotNull
                                                  Component component1,
                                                  @NotNull
                                                  Component component2)

Returns maximum dimension combined from specified components dimensions.

Parameters:

component1 - first component

component2 - second component

Returns:

maximum dimension

maxPreferredSize

@NotNull
public static Dimension maxPreferredSize(@NotNull
                                                  Component... components)

Returns maximum dimension combined from specified components dimensions.

Parameters:

components - components

Returns:

maximum dimension

maxPreferredWidth

public static int maxPreferredWidth(@NotNull
                                    Component... components)

Returns maximum component width.

Parameters:

components - components to process

Returns:

maximum component width

maxPreferredHeight

public static int maxPreferredHeight(@NotNull
                                     Component... components)

Returns maximum component height.

Parameters:

components - components to process

Returns:

maximum component height

max

@Nullable
public static Dimension max(@Nullable
                                      Dimension dimension1,
                                      @Nullable
                                      Dimension dimension2)

Returns maximum dimension combined from specified ones.

Parameters:

dimension1 - first dimension

dimension2 - second dimension

Returns:

maximum dimension

maxNonNull

@NotNull
public static Dimension maxNonNull(@Nullable
                                            Dimension dimension1,
                                            @Nullable
                                            Dimension dimension2)

Returns maximum dimension combined from specified ones.

Parameters:

dimension1 - first dimension

dimension2 - second dimension

Returns:

maximum dimension

minPreferredSize

@NotNull
public static Dimension minPreferredSize(@NotNull
                                                  Component component1,
                                                  @NotNull
                                                  Component component2)

Returns minimum dimension combined from specified components dimensions.

Parameters:

component1 - first component

component2 - second component

Returns:

minimum dimension

minPreferredSize

@NotNull
public static Dimension minPreferredSize(@NotNull
                                                  Component... components)

Returns maximum dimension combined from specified components dimensions.

Parameters:

components - components

Returns:

maximum dimension

min

@Nullable
public static Dimension min(@Nullable
                                      Dimension dimension1,
                                      @Nullable
                                      Dimension dimension2)

Returns minimum dimension combined from specified ones.

Parameters:

dimension1 - first dimension

dimension2 - second dimension

Returns:

minimum dimension

minNonNull

@NotNull
public static Dimension minNonNull(@NotNull
                                            Dimension dimension1,
                                            @NotNull
                                            Dimension dimension2)

Returns minimum dimension combined from specified ones.

Parameters:

dimension1 - first dimension

dimension2 - second dimension

Returns:

minimum dimension

shrink

@NotNull
public static Rectangle shrink(@NotNull
                                        Rectangle rectangle,
                                        @Nullable
                                        Insets insets)

Returns Rectangle shrunk by provided Insets.

Parameters:

rectangle - Rectangle to shrink

insets - Insets used to shrink Rectangle

Returns:

Rectangle shrunk by provided Insets

moveBy

@NotNull
public static Rectangle moveBy(@NotNull
                                        Rectangle rectangle,
                                        @Nullable
                                        Point point)

Returns Rectangle which location is moved by X and Y from the specified Point .

Parameters:

rectangle - Rectangle to move

point - Point to retrieve X and Y from

Returns:

Rectangle which location is moved by X and Y from the specified Point

shrink

@NotNull
public static Dimension shrink(@NotNull
                                        Dimension dimension,
                                        @Nullable
                                        Insets insets)

Returns dimension shrunk by provided insets.

Parameters:

dimension - dimension to shrink

insets - insets used to shrink dimension

Returns:

dimension shrunk by provided insets

stretch

@NotNull
public static Dimension stretch(@NotNull
                                         Dimension dimension,
                                         @Nullable
                                         Insets insets)

Returns dimension stretched by provided insets.

Parameters:

dimension - dimension to stretch

insets - insets used to stretch dimension

Returns:

dimension stretched by provided insets

setOpaqueRecursively

public static void setOpaqueRecursively(@NotNull
                                        Component component,
                                        boolean opaque)

Sets opaque state of component and all of its children.

Parameters:

component - component to modify

opaque - whether opaque state or not

setOpaqueRecursively

public static void setOpaqueRecursively(@NotNull
                                        Component component,
                                        boolean opaque,
                                        boolean childrenOnly)

Sets opaque state of component and all of its children.

Parameters:

component - component to modify

opaque - whether opaque state or not

childrenOnly - whether exclude component from changes or not

setDoubleBufferedRecursively

public static void setDoubleBufferedRecursively(@NotNull
                                                Component component,
                                                boolean doubleBuffered)

Sets double buffered state of component and all of its children.

Parameters:

component - component to modify

doubleBuffered - whether use double buffering or not

setDoubleBufferedRecursively

public static void setDoubleBufferedRecursively(@NotNull
                                                Component component,
                                                boolean doubleBuffered,
                                                boolean childrenOnly)

Sets double buffered state of component and all of its children.

Parameters:

component - component to modify

doubleBuffered - whether use double buffering or not

childrenOnly - whether exclude component from changes or not

setHandlesEnableStateMark

public static void setHandlesEnableStateMark(@NotNull
                                             JComponent component)

Adds HANDLES_ENABLE_STATE client property into the specified JComponent.

Parameters:

component - JComponent to set client property for

removeHandlesEnableStateMark

public static void removeHandlesEnableStateMark(@NotNull
                                                JComponent component)

Removes HANDLES_ENABLE_STATE client property from the specified JComponent.

Parameters:

component - JComponent to remove client property from

isHandlesEnableState

public static boolean isHandlesEnableState(@NotNull
                                           Component component)

Returns whether or not HANDLES_ENABLE_STATE client property is set to true in the specified Component.

Parameters:

component - Component to check client property in

Returns:

true if HANDLES_ENABLE_STATE client property is set to true, false otherwise

setEnabledRecursively

public static void setEnabledRecursively(@NotNull
                                         Component component,
                                         boolean enabled)

Sets enabled state of component and all of its children.

Parameters:

component - component to modify

enabled - whether component is enabled or not

setEnabledRecursively

public static void setEnabledRecursively(@NotNull
                                         Component component,
                                         boolean enabled,
                                         boolean startFromChildren)

Sets enabled state of component and all of its children.

Parameters:

component - component to modify

enabled - whether component is enabled or not

startFromChildren - whether exclude component from changes or not

disableRecursively

@NotNull
public static List<Component> disableRecursively(@NotNull
                                                          Component component,
                                                          boolean startFromChildren,
                                                          boolean excludePanels,
                                                          @NotNull
                                                          Component... excluded)

Disables component and all of its children recursively.

Parameters:

component - component to disable

startFromChildren - whether should disable only component children or not

excludePanels - whether should exclude panels from disabling or not

excluded - components to exclude from disabling

Returns:

list of actually disabled components

disableRecursively

@NotNull
public static List<Component> disableRecursively(@NotNull
                                                          Component component,
                                                          boolean startFromChildren,
                                                          boolean excludePanels,
                                                          @NotNull
                                                          List<Component> excluded)

Disables component and all of its children recursively.

Parameters:

component - component to disable

startFromChildren - whether should disable only component children or not

excludePanels - whether should exclude panels from disabling or not

excluded - components to exclude from disabling

Returns:

list of actually disabled components

enable

public static void enable(@NotNull
                          List<Component> disabled)

Enables specified components.

Parameters:

disabled - disabled components list

setFocusableRecursively

public static void setFocusableRecursively(@NotNull
                                           JComponent component,
                                           boolean focusable)

Sets focusable state of component and all of its children.

Parameters:

component - component to modify

focusable - whether component is focusable or not

setFocusableRecursively

public static void setFocusableRecursively(@NotNull
                                           JComponent component,
                                           boolean focusable,
                                           boolean childrenOnly)

Sets focusable state of component and all of its children.

Parameters:

component - component to modify

focusable - whether component is focusable or not

childrenOnly - whether exclude component from changes or not

setBackgroundRecursively

public static void setBackgroundRecursively(@NotNull
                                            Component component,
                                            Color bg)

Sets background color of component and all of its children.

Parameters:

component - component to modify

bg - new background color

setBackgroundRecursively

public static void setBackgroundRecursively(@NotNull
                                            Component component,
                                            Color bg,
                                            boolean childrenOnly)

Sets background color of component and all of its children.

Parameters:

component - component to modify

bg - new background color

childrenOnly - whether exclude component from changes or not

setForegroundRecursively

public static void setForegroundRecursively(@NotNull
                                            JComponent component,
                                            @Nullable
                                            Color foreground)

Sets foreground color of component and all of its children.

Parameters:

component - component to modify

foreground - new foreground color

setForegroundRecursively

public static void setForegroundRecursively(@NotNull
                                            JComponent component,
                                            @Nullable
                                            Color foreground,
                                            boolean childrenOnly)

Sets foreground color of component and all of its children.

Parameters:

component - component to modify

foreground - new foreground color

childrenOnly - whether exclude component from changes or not

setFontRecursively

public static void setFontRecursively(@NotNull
                                      JComponent component,
                                      @Nullable
                                      Font font)

Sets font of component and all of its children.

Parameters:

component - component to modify

font - new font

setFontRecursively

public static void setFontRecursively(@NotNull
                                      JComponent component,
                                      @Nullable
                                      Font font,
                                      boolean childrenOnly)

Sets font of component and all of its children.

Parameters:

component - component to modify

font - new font

childrenOnly - whether exclude component from changes or not

createComponentSnapshot

@NotNull
public static BufferedImage createComponentSnapshot(@NotNull
                                                             Component content)

Returns component snapshot image. Component must be showing to render properly using this method.

Parameters:

content - component for snapshot

Returns:

component snapshot image

createComponentSnapshot

@NotNull
public static BufferedImage createComponentSnapshot(@NotNull
                                                             Component content,
                                                             float opacity)

Returns component snapshot image. Component must be showing to render properly using this method.

Parameters:

content - component for snapshot

opacity - snapshot opacity

Returns:

component snapshot image

createComponentSnapshot

@NotNull
public static BufferedImage createComponentSnapshot(@NotNull
                                                             Component content,
                                                             int width,
                                                             int height)

Returns component snapshot image of specified size. Component must be showing to render properly using this method.

Parameters:

content - component for snapshot

width - snapshot image width

height - snapshot image height

Returns:

component snapshot image

createComponentSnapshot

@NotNull
public static BufferedImage createComponentSnapshot(@NotNull
                                                             Component content,
                                                             int width,
                                                             int height,
                                                             float opacity)

Returns component snapshot image of specified size. Component must be showing to render properly using this method.

Parameters:

content - component for snapshot

width - snapshot image width

height - snapshot image height

opacity - snapshot opacity

Returns:

component snapshot image

getAccelerator

@Nullable
public static KeyStroke getAccelerator(@Nullable
                                                 HotkeyData hotkey)

Returns menu item accelerator for the specified hotkey.

Parameters:

hotkey - hotkey to provide accelerator based on

Returns:

menu item accelerator for the specified hotkey

getFocusAcceleratorKeyMask

public static int getFocusAcceleratorKeyMask()

Returns focus accelerator key mask.

Returns:

focus accelerator key mask

getMnemonicIndex

public static int getMnemonicIndex(String text,
                                   int mnemonic)

Returns index of the first occurrence of mnemonic within string text. Matching algorithm is not case-sensitive.

Parameters:

text - text to search through, may be null

mnemonic - mnemonic to find the character for

Returns:

index into the string if exists, otherwise -1

getActiveWindow

@Nullable
public static Window getActiveWindow()

Returns active application window.

Returns:

active application window

isShortcut

public static boolean isShortcut(@NotNull
                                 InputEvent event)

Returns whether specified event contains shortcut modifier or not.

Parameters:

event - event to process

Returns:

true if specified event contains shortcut modifier, false otherwise

getSystemShortcutModifier

public static int getSystemShortcutModifier()

Returns system shortcut modifier.

Returns:

system shortcut modifier

hotkeyToString

@NotNull
public static String hotkeyToString(@NotNull
                                             KeyEvent keyEvent)

Returns readable form of hotkey triggered by specified key event.

Parameters:

keyEvent - key event to process

Returns:

readable form of hotkey triggered by specified key event

hotkeyToString

@NotNull
public static String hotkeyToString(@NotNull
                                             HotkeyData hotkeyData)

Returns readable form of specified hotkey data.

Parameters:

hotkeyData - hotkey data to process

Returns:

readable form of specified hotkey data

hotkeyToString

@NotNull
public static String hotkeyToString(@NotNull
                                             KeyStroke keyStroke)

Returns readable form of specified key stroke.

Parameters:

keyStroke - key stroke to process

Returns:

readable form of specified key stroke

hotkeyToString

@NotNull
public static String hotkeyToString(boolean isCtrl,
                                             boolean isAlt,
                                             boolean isShift,
                                             @Nullable
                                             Integer keyCode)

Returns readable form for specified hotkey.

Parameters:

isCtrl - whether hotkey requires CTRL modifier or not

isAlt - whether hotkey requires ALT modifier or not

isShift - whether hotkey requires SHIFT modifier or not

keyCode - key code for hotkey

Returns:

readable form for specified hotkey

isCtrl

public static boolean isCtrl(@NotNull
                             InputEvent event)

Returns whether CTRL modifier is triggered by the specified event or not.

Parameters:

event - event to process

Returns:

true if CTRL modifier is triggered by the specified event, false otherwise

isCtrl

public static boolean isCtrl(int modifiers)

Returns whether CTRL modifier is triggered by the specified modifiers or not.

Parameters:

modifiers - modifiers to process

Returns:

true if CTRL modifier is triggered by the specified modifiers, false otherwise

isAlt

public static boolean isAlt(@NotNull
                            InputEvent event)

Returns whether ALT modifier is triggered by the specified event or not.

Parameters:

event - event to process

Returns:

true if ALT modifier is triggered by the specified event, false otherwise

isAlt

public static boolean isAlt(int modifiers)

Returns whether ALT modifier is triggered by the specified modifiers or not.

Parameters:

modifiers - modifiers to process

Returns:

true if ALT modifier is triggered by the specified modifiers, false otherwise

isShift

public static boolean isShift(@NotNull
                              InputEvent event)

Returns whether SHIFT modifier is triggered by the specified event or not.

Parameters:

event - event to process

Returns:

true if SHIFT modifier is triggered by the specified event, false otherwise

isShift

public static boolean isShift(int modifiers)

Returns whether SHIFT modifier is triggered by the specified modifiers or not.

Parameters:

modifiers - modifiers to process

Returns:

true if SHIFT modifier is triggered by the specified modifiers, false otherwise

getHotkeyData

@NotNull
public static HotkeyData getHotkeyData(@NotNull
                                                KeyStroke keyStroke)

Returns hotkey data extracted from the specified key stroke.

Parameters:

keyStroke - key stroke to process

Returns:

hotkey data

getDefaultLabelFont

@NotNull
public static Font getDefaultLabelFont()

Returns default label font. This method might be used as a hack with other LaFs to retrieve system default font for simple text.

Returns:

default label font

getDefaultLabelFontMetrics

@NotNull
public static FontMetrics getDefaultLabelFontMetrics()

Returns default label font metrics. This method might be used as a hack with other LaFs to retrieve system default font metrics for simple text.

Returns:

default label font metrics

getScrollPane

@Nullable
public static JScrollPane getScrollPane(@Nullable
                                                  Component component)

Returns JSplitPane for the specified Component if it is directly added into one, null otherwise.

Parameters:

component - Component to process

Returns:

JSplitPane for the specified Component if it is directly added into one, null otherwise

compositeRequestFocus

@Nullable
public static Component compositeRequestFocus(@NotNull
                                                        Component component)

Performs composite focus request and returns Component that requested focus.

Parameters:

component - Component to perform composite focus request for

Returns:

Component that requested focus

findFocusableComponent

@Nullable
public static Component findFocusableComponent(@NotNull
                                                         Container container)

Returns first focusable component found in the container.

Parameters:

container - container to process

Returns:

first focusable component found in the container

findComponentsWithText

@NotNull
public static List<Component> findComponentsWithText(@Nullable
                                                              String text,
                                                              @Nullable
                                                              Component component)

Returns list of all components that visually contains the specified text.

Parameters:

text - text to find

component - component or container to look for specified text

Returns:

list of all components that visually contains the specified text

findComponentsWithText

@NotNull
public static List<Component> findComponentsWithText(@Nullable
                                                              String text,
                                                              @Nullable
                                                              Component component,
                                                              @NotNull
                                                              List<Component> components)

Returns list of all components that visually contains the specified text.

Parameters:

text - text to find

component - component or container to look for specified text

components - list of found components

Returns:

list of all components that visually contains the specified text

indexOf

public static int indexOf(@NotNull
                          Container container,
                          @Nullable
                          Component child)

Returns component index within the specified parent container.

Parameters:

container - container

child - child component

Returns:

component index within the specified parent container

getChildPreferredSizes

@NotNull
public static Map<Component,Dimension> getChildPreferredSizes(@NotNull
                                                                       Container container)

Returns map of container child components preferred sizes.

Parameters:

container - container to process

Returns:

map of container child components preferred sizes

equalizeComponentsSize

public static void equalizeComponentsSize(@NotNull
                                          Component... components)

Makes all specified component sizes equal.

Parameters:

components - components to modify

equalizeComponentsSize

public static void equalizeComponentsSize(@NotNull
                                          List<String> properties,
                                          @NotNull
                                          Component... components)

Makes all specified component sizes equal.

Parameters:

properties - properties to listen for later size updates

components - components to modify

equalizeComponentsSize

public static void equalizeComponentsSize(@NotNull
                                          List<? extends Component> components)

Makes all specified component sizes equal.

Parameters:

components - components to modify

equalizeComponentsSize

public static void equalizeComponentsSize(@NotNull
                                          List<String> properties,
                                          @NotNull
                                          List<? extends Component> components)

Makes all specified component sizes equal.

Parameters:

properties - properties to listen for later size updates

components - components to modify

equalizeComponentsWidth

public static void equalizeComponentsWidth(@NotNull
                                           Component... components)

Makes all specified component widths equal.

Parameters:

components - components to modify

equalizeComponentsWidth

public static void equalizeComponentsWidth(@NotNull
                                           List<String> properties,
                                           @NotNull
                                           Component... components)

Makes all specified component widths equal.

Parameters:

properties - properties to listen for later size updates

components - components to modify

equalizeComponentsWidth

public static void equalizeComponentsWidth(@NotNull
                                           List<? extends Component> components)

Makes all specified component widths equal.

Parameters:

components - components to modify

equalizeComponentsWidth

public static void equalizeComponentsWidth(@NotNull
                                           List<String> properties,
                                           @NotNull
                                           List<? extends Component> components)

Makes all specified component widths equal.

Parameters:

properties - properties to listen for later size updates

components - components to modify

equalizeComponentsHeight

public static void equalizeComponentsHeight(@NotNull
                                            Component... components)

Makes all specified component heights equal.

Parameters:

components - components to modify

equalizeComponentsHeight

public static void equalizeComponentsHeight(@NotNull
                                            List<String> properties,
                                            @NotNull
                                            Component... components)

Makes all specified component heights equal.

Parameters:

properties - properties to listen for later size updates

components - components to modify

equalizeComponentsHeight

public static void equalizeComponentsHeight(@NotNull
                                            List<? extends Component> components)

Makes all specified component heights equal.

Parameters:

components - components to modify

equalizeComponentsHeight

public static void equalizeComponentsHeight(@NotNull
                                            List<String> properties,
                                            @NotNull
                                            List<? extends Component> components)

Makes all specified component heights equal.

Parameters:

properties - properties to listen for later size updates

components - components to modify

isEqualOrChild

public static boolean isEqualOrChild(@Nullable
                                     Component component,
                                     @Nullable
                                     Component child)

Returns whether the first component or any of its children are equal to second component or not.

Parameters:

component - first component to compare

child - second component to compare

Returns:

true if the first component or any of its children are equal to second component, false otherwise

hasFocusOwner

public static boolean hasFocusOwner(@Nullable
                                    Component component)

Returns whether component or any of its children has focus or not.

Parameters:

component - component to process

Returns:

true if component or any of its children has focus, false otherwise

hasFocusableComponent

public static boolean hasFocusableComponent(@NotNull
                                            Container container)

Returns whether at least one of child components within the specified container is focusable or not.

Parameters:

container - container to process

Returns:

true if at least one of child components within the specified container is focusable, false otherwise

getFontNames

@NotNull
public static String[] getFontNames()

Returns system font names array.

Returns:

system font names array

getFonts

@NotNull
public static Font[] getFonts()

Returns system fonts array.

Returns:

system fonts array

createFonts

@NotNull
public static Font[] createFonts(@NotNull
                                          String[] fontNames)

Returns an array of fonts created using specified array of font names.

Parameters:

fontNames - array of font names

Returns:

an array of fonts

toRTL

@NotNull
public static Insets toRTL(@NotNull
                                    Insets insets)

Returns insets converted into RTL orientation.

Parameters:

insets - insets to convert

Returns:

insets converted into RTL orientation

setupTextAntialias

public static Map setupTextAntialias(@NotNull
                                     Graphics g)

Installs text antialiasing hints into specified graphics context.

Parameters:

g - graphics context

Returns:

old text antialiasing hints

setupTextAntialias

public static Map setupTextAntialias(@NotNull
                                     Graphics2D g2d)

Installs text antialiasing hints into specified graphics context.

Parameters:

g2d - graphics context

Returns:

old text antialiasing hints

setupTextAntialias

public static Map setupTextAntialias(@NotNull
                                     Graphics g,
                                     @NotNull
                                     TextRasterization rasterization)

Installs text antialiasing hints into specified graphics context.

Parameters:

g - graphics context

rasterization - text rasterization option

Returns:

old text antialiasing hints

setupTextAntialias

public static Map setupTextAntialias(@NotNull
                                     Graphics2D g2d,
                                     @NotNull
                                     TextRasterization rasterization)

Installs text antialiasing hints into specified graphics context.

Parameters:

g2d - graphics context

rasterization - text rasterization option

Returns:

old text antialiasing hints

restoreTextAntialias

public static void restoreTextAntialias(@NotNull
                                        Graphics g,
                                        @Nullable
                                        Map hints)

Restores text antialiasing hints into specified graphics context

Parameters:

g - graphics context

hints - old text antialiasing hints

restoreTextAntialias

public static void restoreTextAntialias(@NotNull
                                        Graphics2D g2d,
                                        @Nullable
                                        Map hints)

Restores text antialiasing hints into specified graphics context

Parameters:

g2d - graphics context

hints - old text antialiasing hints

getFontMetrics

@NotNull
public static FontMetrics getFontMetrics(@Nullable
                                                  JComponent component,
                                                  @NotNull
                                                  Graphics g)

Returns the FontMetrics for the current Font of the passed in Graphics. This method is used when a Graphics is available, typically when painting. If a Graphics is not available the JComponent method of the same name should be used.

This does not necessarily return the FontMetrics from the Graphics.

Parameters:

component - JComponent requesting FontMetrics, may be null

g - Graphics Graphics

Returns:

FontMetrics for the current Font of the passed in Graphics

getFontMetrics

@NotNull
public static FontMetrics getFontMetrics(@Nullable
                                                  JComponent component,
                                                  @NotNull
                                                  Graphics g,
                                                  @NotNull
                                                  Font font)

Returns the FontMetrics for the specified Font. This method is used when a Graphics is available, typically when painting. If a Graphics is not available the JComponent method of the same name should be used.

This does not necessarily return the FontMetrics from the Graphics.

Parameters:

component - JComponent requesting FontMetrics, may be null

g - Graphics Graphics

font - Font to get FontMetrics for

Returns:

FontMetrics for the specified Font

firePropertyChanged

public static void firePropertyChanged(@NotNull
                                       Component component,
                                       @NotNull
                                       String property,
                                       @Nullable
                                       Object oldValue,
                                       @Nullable
                                       Object newValue)

Fires painter property change event. This is a workaround since firePropertyChange() method is protected and cannot be called w/o using reflection.

Parameters:

component - component to fire property change to

property - changed property

oldValue - old value

newValue - new value

frameRateDelay

public static long frameRateDelay(int frameRate)

Returns delay in milliseconds for the preferred frame rate.

Parameters:

frameRate - frame rate per second (FPS)

Returns:

delay in milliseconds for the preferred frame rate

stringWidth

public static int stringWidth(@NotNull
                              FontMetrics fontMetrics,
                              @Nullable
                              String string)

Returns the width of the passed in String. If the passed String is null, returns zero.

Parameters:

fontMetrics - FontMetrics used to measure the String width

string - String to get the width of

Returns:

width of the passed in String