com.alee.utils

Class LafUtils

java.lang.Object

com.alee.utils.LafUtils

public final class LafUtils
extends java.lang.Object

This class provides a set of utilities for core WebLaF components. Created mostly for internal usage within WebLaF.

Field Summary

Fields

Modifier and Type	Field and Description
static int	halfButton Draws web styled selection using shapes operations.
static int	halfLine
static int	halfSelector
static int	shadeWidth

Constructor Summary

Constructors

Constructor and Description
LafUtils()

Method Summary

Modifier and Type	Method and Description
static void	drawAlphaLayer(java.awt.Graphics2D g2d, int x, int y, int width, int height) Draws alpha-background
static void	drawAlphaLayer(java.awt.Graphics2D g2d, int x, int y, int width, int height, int size)
static void	drawAlphaLayer(java.awt.Graphics2D g2d, int x, int y, int width, int height, int size, java.awt.Color light, java.awt.Color dark)
static void	drawCustomWebBorder(java.awt.Graphics2D g2d, javax.swing.JComponent component, java.awt.Shape borderShape, java.awt.Color shadeColor, int shadeWidth, boolean fillBackground, boolean webColored) Paints custom shaped web styled border within the component with shadow and background
static void	drawCustomWebBorder(java.awt.Graphics2D g2d, javax.swing.JComponent component, java.awt.Shape borderShape, java.awt.Color shadeColor, int shadeWidth, boolean fillBackground, boolean webColored, java.awt.Color border, java.awt.Color disabledBorder)
static void	drawCustomWebBorder(java.awt.Graphics2D g2d, javax.swing.JComponent component, java.awt.Shape borderShape, java.awt.Color shadeColor, int shadeWidth, boolean fillBackground, boolean webColored, java.awt.Color border, java.awt.Color disabledBorder, java.awt.Color backgroundColor)
static void	drawCustomWebFocus(java.awt.Graphics2D g2d, javax.swing.JComponent component, com.alee.utils.laf.FocusType focusType, java.awt.Shape shape) Draws custom shaped web styled focus within the component
static void	drawCustomWebFocus(java.awt.Graphics2D g2d, javax.swing.JComponent component, com.alee.utils.laf.FocusType focusType, java.awt.Shape shape, java.lang.Boolean mouseover)
static void	drawCustomWebFocus(java.awt.Graphics2D g2d, javax.swing.JComponent component, com.alee.utils.laf.FocusType focusType, java.awt.Shape shape, java.lang.Boolean mouseover, java.lang.Boolean hasFocus)
static void	drawWebIconedGripper(java.awt.Graphics2D g2d, int x, int y)
static void	drawWebIconedGripper(java.awt.Graphics2D g2d, java.awt.Point point)
static void	drawWebIconedSelection(java.awt.Graphics2D g2d, java.awt.Rectangle selection, boolean resizableLR, boolean resizableUD, boolean drawConnectors)
static void	drawWebIconedSelection(java.awt.Graphics2D g2d, java.awt.Rectangle selection, boolean resizableLR, boolean resizableUD, boolean drawConnectors, boolean drawSideControls)
static void	drawWebIconedSelector(java.awt.Graphics2D g2d, java.awt.Rectangle selection, int selector)
static void	drawWebSelection(java.awt.Graphics2D g2d, java.awt.Color color, int x, int y, int width, int height, boolean resizableLR, boolean resizableUD, boolean drawConnectors)
static void	drawWebSelection(java.awt.Graphics2D g2d, java.awt.Color color, int x, int y, int width, int height, boolean resizableLR, boolean resizableUD, boolean drawConnectors, boolean drawSideControls)
static void	drawWebSelection(java.awt.Graphics2D g2d, java.awt.Color color, java.awt.Rectangle selection, boolean resizableLR, boolean resizableUD, boolean drawConnectors)
static void	drawWebSelection(java.awt.Graphics2D g2d, java.awt.Color color, java.awt.Rectangle selection, boolean resizableLR, boolean resizableUD, boolean drawConnectors, boolean drawSideControls)
static void	drawWebSelector(java.awt.Graphics2D g2d, java.awt.Color color, java.awt.Rectangle selection, int selector)
static java.awt.Shape	drawWebStyle(java.awt.Graphics2D g2d, javax.swing.JComponent component, java.awt.Color shadeColor, int shadeWidth, int round, boolean fillBackground, boolean webColored) Deprecated.
static java.awt.Shape	drawWebStyle(java.awt.Graphics2D g2d, javax.swing.JComponent component, java.awt.Color shadeColor, int shadeWidth, int round, boolean fillBackground, boolean webColored, java.awt.Color border)
static java.awt.Shape	drawWebStyle(java.awt.Graphics2D g2d, javax.swing.JComponent component, java.awt.Color shadeColor, int shadeWidth, int round, boolean fillBackground, boolean webColored, java.awt.Color border, java.awt.Color disabledBorder)
static java.awt.Shape	drawWebStyle(java.awt.Graphics2D g2d, javax.swing.JComponent component, java.awt.Color shadeColor, int shadeWidth, int round, boolean fillBackground, boolean webColored, java.awt.Color border, java.awt.Color disabledBorder, java.awt.Color background, float opacity)
static java.awt.Shape	drawWebStyle(java.awt.Graphics2D g2d, javax.swing.JComponent component, java.awt.Color shadeColor, int shadeWidth, int round, boolean fillBackground, boolean webColored, java.awt.Color border, java.awt.Color disabledBorder, float opacity)
static java.awt.Insets	getInsets(java.awt.Component component) Returns current component border insets if it is supported.
static java.awt.Insets	getMargin(java.awt.Component component) Returns current component margin if it is supported.
static java.awt.Insets	getPadding(java.awt.Component component) Returns current component padding if it is supported.
static ShapeProvider	getShapeProvider(java.awt.Component component) Returns shape provider for the specified component or null if shape provider is not supported.
static Styleable	getStyleable(java.awt.Component c) Returns styleable element for the specified component.
static Styleable	getStyleable(javax.swing.plaf.ComponentUI ui) Returns styleable element for the specified ui.
static java.awt.Rectangle	getTextBounds(java.lang.String text, java.awt.Graphics2D g2d, java.awt.Font font)
static java.awt.Rectangle	getTextBounds(java.lang.String text, java.awt.Graphics g, java.awt.Font font) Determines real text size
static java.awt.Point	getTextCenterShift(java.awt.FontMetrics metrics, java.lang.String text) Returns X and Y shift for the specified text and font metrics.
static int	getTextCenterShiftX(java.awt.FontMetrics metrics, java.lang.String text) Returns X shift for the specified text and font metrics.
static int	getTextCenterShiftY(java.awt.FontMetrics metrics) Returns Y shift for the specified font metrics.
static <T extends javax.swing.plaf.ComponentUI> T	getUI(java.awt.Component component) Returns component UI or null if UI cannot be retrieved.
static java.awt.Shape	getWebBorderShape(javax.swing.JComponent component, int shadeWidth, int round)
static java.awt.GradientPaint	getWebGradientPaint(int x1, int y1, int x2, int y2)
static java.awt.GradientPaint	getWebGradientPaint(java.awt.Rectangle bounds)
static boolean	isInDecoratedWindow(java.awt.Component component) Returns whether window in which specified component located is decorated by L&F or not.
static TexturePainter	loadTexturePainter(java.lang.Object source) Returns TexturePainter which is read from the source.
static TexturePainter	loadTexturePainter(com.alee.utils.xml.ResourceFile resource) Returns TexturePainter which is read from specified ResourceFile.
static boolean	setupLookAndFeelSafely(java.lang.Class<? extends javax.swing.LookAndFeel> clazz) Installs specified L&F as current application's L&F.
static boolean	setupLookAndFeelSafely(java.lang.String className) Installs specified L&F as current application's L&F.

Methods inherited from class java.lang.Object

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

Field Detail

halfButton

public static int halfButton

Draws web styled selection using shapes operations. This method is pretty slow and should not be used for multiply selections presentation.

halfSelector

public static int halfSelector

halfLine

public static int halfLine

shadeWidth

public static int shadeWidth

Constructor Detail

LafUtils

public LafUtils()

Method Detail

isInDecoratedWindow

public static boolean isInDecoratedWindow(java.awt.Component component)

Returns whether window in which specified component located is decorated by L&F or not.

Parameters:

component - component used to determine window decoration state

Returns:

true if window in which specified component located is decorated by L&F, false otherwise

getMargin

public static java.awt.Insets getMargin(java.awt.Component component)

Returns current component margin if it is supported. Might return null which is basically the same as an empty [0,0,0,0] margin.

Parameters:

component - component to retrieve margin from

Returns:

current component margin if it is supported

getPadding

public static java.awt.Insets getPadding(java.awt.Component component)

Returns current component padding if it is supported. Might return null which is basically the same as an empty [0,0,0,0] padding.

Parameters:

component - component to retrieve padding from

Returns:

current component padding if it is supported

getInsets

public static java.awt.Insets getInsets(java.awt.Component component)

Returns current component border insets if it is supported. Might return null which is basically the same as an empty [0,0,0,0] border insets.

Parameters:

component - component to retrieve border insets from

Returns:

current component border insets if it is supported

getUI

public static <T extends javax.swing.plaf.ComponentUI> T getUI(java.awt.Component component)

Returns component UI or null if UI cannot be retrieved.

Type Parameters:

T - UI class type

Parameters:

component - component to retrieve UI from

Returns:

component UI or null if UI cannot be retrieved

drawAlphaLayer

public static void drawAlphaLayer(java.awt.Graphics2D g2d,
                                  int x,
                                  int y,
                                  int width,
                                  int height)

Draws alpha-background

drawAlphaLayer

public static void drawAlphaLayer(java.awt.Graphics2D g2d,
                                  int x,
                                  int y,
                                  int width,
                                  int height,
                                  int size)

drawAlphaLayer

public static void drawAlphaLayer(java.awt.Graphics2D g2d,
                                  int x,
                                  int y,
                                  int width,
                                  int height,
                                  int size,
                                  java.awt.Color light,
                                  java.awt.Color dark)

getTextBounds

public static java.awt.Rectangle getTextBounds(java.lang.String text,
                                               java.awt.Graphics g,
                                               java.awt.Font font)

Determines real text size

getTextBounds

public static java.awt.Rectangle getTextBounds(java.lang.String text,
                                               java.awt.Graphics2D g2d,
                                               java.awt.Font font)

drawWebStyle

@Deprecated
public static java.awt.Shape drawWebStyle(java.awt.Graphics2D g2d,
                                                      javax.swing.JComponent component,
                                                      java.awt.Color shadeColor,
                                                      int shadeWidth,
                                                      int round,
                                                      boolean fillBackground,
                                                      boolean webColored)

Deprecated.

Paints web styled border within the component with shadow and background if needed

drawWebStyle

public static java.awt.Shape drawWebStyle(java.awt.Graphics2D g2d,
                                          javax.swing.JComponent component,
                                          java.awt.Color shadeColor,
                                          int shadeWidth,
                                          int round,
                                          boolean fillBackground,
                                          boolean webColored,
                                          java.awt.Color border)

drawWebStyle

public static java.awt.Shape drawWebStyle(java.awt.Graphics2D g2d,
                                          javax.swing.JComponent component,
                                          java.awt.Color shadeColor,
                                          int shadeWidth,
                                          int round,
                                          boolean fillBackground,
                                          boolean webColored,
                                          java.awt.Color border,
                                          java.awt.Color disabledBorder)

drawWebStyle

public static java.awt.Shape drawWebStyle(java.awt.Graphics2D g2d,
                                          javax.swing.JComponent component,
                                          java.awt.Color shadeColor,
                                          int shadeWidth,
                                          int round,
                                          boolean fillBackground,
                                          boolean webColored,
                                          java.awt.Color border,
                                          java.awt.Color disabledBorder,
                                          float opacity)

drawWebStyle

public static java.awt.Shape drawWebStyle(java.awt.Graphics2D g2d,
                                          javax.swing.JComponent component,
                                          java.awt.Color shadeColor,
                                          int shadeWidth,
                                          int round,
                                          boolean fillBackground,
                                          boolean webColored,
                                          java.awt.Color border,
                                          java.awt.Color disabledBorder,
                                          java.awt.Color background,
                                          float opacity)

getWebGradientPaint

public static java.awt.GradientPaint getWebGradientPaint(java.awt.Rectangle bounds)

getWebGradientPaint

public static java.awt.GradientPaint getWebGradientPaint(int x1,
                                                         int y1,
                                                         int x2,
                                                         int y2)

getWebBorderShape

public static java.awt.Shape getWebBorderShape(javax.swing.JComponent component,
                                               int shadeWidth,
                                               int round)

drawCustomWebBorder

public static void drawCustomWebBorder(java.awt.Graphics2D g2d,
                                       javax.swing.JComponent component,
                                       java.awt.Shape borderShape,
                                       java.awt.Color shadeColor,
                                       int shadeWidth,
                                       boolean fillBackground,
                                       boolean webColored)

Paints custom shaped web styled border within the component with shadow and background

drawCustomWebBorder

public static void drawCustomWebBorder(java.awt.Graphics2D g2d,
                                       javax.swing.JComponent component,
                                       java.awt.Shape borderShape,
                                       java.awt.Color shadeColor,
                                       int shadeWidth,
                                       boolean fillBackground,
                                       boolean webColored,
                                       java.awt.Color border,
                                       java.awt.Color disabledBorder)

drawCustomWebBorder

public static void drawCustomWebBorder(java.awt.Graphics2D g2d,
                                       javax.swing.JComponent component,
                                       java.awt.Shape borderShape,
                                       java.awt.Color shadeColor,
                                       int shadeWidth,
                                       boolean fillBackground,
                                       boolean webColored,
                                       java.awt.Color border,
                                       java.awt.Color disabledBorder,
                                       java.awt.Color backgroundColor)

drawCustomWebFocus

public static void drawCustomWebFocus(java.awt.Graphics2D g2d,
                                      javax.swing.JComponent component,
                                      com.alee.utils.laf.FocusType focusType,
                                      java.awt.Shape shape)

Draws custom shaped web styled focus within the component

drawCustomWebFocus

public static void drawCustomWebFocus(java.awt.Graphics2D g2d,
                                      javax.swing.JComponent component,
                                      com.alee.utils.laf.FocusType focusType,
                                      java.awt.Shape shape,
                                      java.lang.Boolean mouseover)

drawCustomWebFocus

public static void drawCustomWebFocus(java.awt.Graphics2D g2d,
                                      javax.swing.JComponent component,
                                      com.alee.utils.laf.FocusType focusType,
                                      java.awt.Shape shape,
                                      java.lang.Boolean mouseover,
                                      java.lang.Boolean hasFocus)

drawWebSelection

public static void drawWebSelection(java.awt.Graphics2D g2d,
                                    java.awt.Color color,
                                    int x,
                                    int y,
                                    int width,
                                    int height,
                                    boolean resizableLR,
                                    boolean resizableUD,
                                    boolean drawConnectors)

drawWebSelection

public static void drawWebSelection(java.awt.Graphics2D g2d,
                                    java.awt.Color color,
                                    int x,
                                    int y,
                                    int width,
                                    int height,
                                    boolean resizableLR,
                                    boolean resizableUD,
                                    boolean drawConnectors,
                                    boolean drawSideControls)

drawWebSelection

public static void drawWebSelection(java.awt.Graphics2D g2d,
                                    java.awt.Color color,
                                    java.awt.Rectangle selection,
                                    boolean resizableLR,
                                    boolean resizableUD,
                                    boolean drawConnectors)

drawWebSelection

public static void drawWebSelection(java.awt.Graphics2D g2d,
                                    java.awt.Color color,
                                    java.awt.Rectangle selection,
                                    boolean resizableLR,
                                    boolean resizableUD,
                                    boolean drawConnectors,
                                    boolean drawSideControls)

drawWebSelector

public static void drawWebSelector(java.awt.Graphics2D g2d,
                                   java.awt.Color color,
                                   java.awt.Rectangle selection,
                                   int selector)

drawWebIconedSelection

public static void drawWebIconedSelection(java.awt.Graphics2D g2d,
                                          java.awt.Rectangle selection,
                                          boolean resizableLR,
                                          boolean resizableUD,
                                          boolean drawConnectors)

drawWebIconedSelection

public static void drawWebIconedSelection(java.awt.Graphics2D g2d,
                                          java.awt.Rectangle selection,
                                          boolean resizableLR,
                                          boolean resizableUD,
                                          boolean drawConnectors,
                                          boolean drawSideControls)

drawWebIconedSelector

public static void drawWebIconedSelector(java.awt.Graphics2D g2d,
                                         java.awt.Rectangle selection,
                                         int selector)

drawWebIconedGripper

public static void drawWebIconedGripper(java.awt.Graphics2D g2d,
                                        java.awt.Point point)

drawWebIconedGripper

public static void drawWebIconedGripper(java.awt.Graphics2D g2d,
                                        int x,
                                        int y)

getTextCenterShift

public static java.awt.Point getTextCenterShift(java.awt.FontMetrics metrics,
                                                java.lang.String text)

Returns X and Y shift for the specified text and font metrics. It will return values you need to add to the point relative to which you want to center text.

Parameters:

metrics - font metrics

text - text

Returns:

X and Y shift for the specified text and font metrics

getTextCenterShiftX

public static int getTextCenterShiftX(java.awt.FontMetrics metrics,
                                      java.lang.String text)

Returns X shift for the specified text and font metrics. It will return value you need to add to the point X coordinate relative to which you want to horizontally center text.

Parameters:

metrics - font metrics

text - text

Returns:

X shift for the specified text and font metrics

getTextCenterShiftY

public static int getTextCenterShiftY(java.awt.FontMetrics metrics)

Returns Y shift for the specified font metrics. It will return value you need to add to the point Y coordinate relative to which you want to vertically center text.

Parameters:

metrics - font metrics

Returns:

Y shift for the specified font metrics

getShapeProvider

public static ShapeProvider getShapeProvider(java.awt.Component component)

Returns shape provider for the specified component or null if shape provider is not supported. This might be used to provide dynamic component shape to other components.

Parameters:

component - component to process

Returns:

shape provider for the specified component or null if shape provider is not supported

getStyleable

public static Styleable getStyleable(java.awt.Component c)

Returns styleable element for the specified component.

Parameters:

c - component to retrieve styleable element for

Returns:

styleable element for the specified component

getStyleable

public static Styleable getStyleable(javax.swing.plaf.ComponentUI ui)

Returns styleable element for the specified ui.

Parameters:

ui - ui to retrieve styleable element for

Returns:

styleable element for the specified ui

loadTexturePainter

public static TexturePainter loadTexturePainter(java.lang.Object source)

Returns TexturePainter which is read from the source.

Parameters:

source - one of possible sources: URL, String, File, Reader, InputStream

Returns:

TexturePainter

loadTexturePainter

public static TexturePainter loadTexturePainter(com.alee.utils.xml.ResourceFile resource)

Returns TexturePainter which is read from specified ResourceFile.

Parameters:

resource - file description

Returns:

TexturePainter

setupLookAndFeelSafely

public static boolean setupLookAndFeelSafely(java.lang.Class<? extends javax.swing.LookAndFeel> clazz)

Installs specified L&F as current application's L&F.

Parameters:

clazz - L&F class

Returns:

true if L&F was installed successfully, false otherwise

setupLookAndFeelSafely

public static boolean setupLookAndFeelSafely(java.lang.String className)

Installs specified L&F as current application's L&F.

Parameters:

className - L&F canonical class name

Returns:

true if L&F was installed successfully, false otherwise