public final class SwingXUtilities
extends java.lang.Object
Modifier and Type | Method and Description |
---|---|
static void |
adjustFocus(javax.swing.JComponent component) |
static int |
convertModifiersToDropAction(int modifiers,
int sourcActions) |
static <T> T |
getAncestor(java.lang.Class<T> clazz,
java.awt.Component c)
An improved version of
SwingUtilities.getAncestorOfClass(Class, Component) . |
static <T> T |
invokeAndWait(java.util.concurrent.Callable<T> callable)
A version of
SwingUtilities.invokeAndWait(Runnable) that supports
return values. |
static <T> java.util.concurrent.FutureTask<T> |
invokeLater(java.util.concurrent.Callable<T> callable)
A version of
SwingUtilities.invokeLater(Runnable) that supports
return values. |
static boolean |
isDescendingFrom(java.awt.Component focusOwner,
java.awt.Component parent)
Returns whether the component is part of the parent's container
hierarchy.
|
static boolean |
isUIInstallable(java.lang.Object property)
Checks and returns whether the given property should be replaced by the
UI's default value.
|
static int |
loc2IndexFileList(javax.swing.JList list,
java.awt.Point point) |
static void |
setComponentTreeBackground(java.awt.Component c,
java.awt.Color color)
Sets the background for an entire component hierarchy to the specified
color.
|
static void |
setComponentTreeEnabled(java.awt.Component c,
boolean enabled)
Enables or disables of the components in the tree starting with
c . |
static void |
setComponentTreeFont(java.awt.Component c,
java.awt.Font font)
Sets the font for an entire component hierarchy to the specified font.
|
static void |
setComponentTreeForeground(java.awt.Component c,
java.awt.Color color)
Sets the foreground for an entire component hierarchy to the specified
color.
|
static void |
setComponentTreeLocale(java.awt.Component c,
java.util.Locale locale)
Sets the locale for an entire component hierarchy to the specified
locale.
|
static void |
setHtmlFont(javax.swing.text.html.HTMLDocument doc,
java.awt.Font font)
Sets the font used for HTML displays to the specified font.
|
static void |
setLeadAnchorWithoutSelection(javax.swing.ListSelectionModel selectionModel,
int lead,
int anchor)
Updates lead and anchor selection index without changing the selection.
|
static boolean |
shouldIgnore(java.awt.event.MouseEvent mouseEvent,
javax.swing.JComponent component) |
static void |
updateAllComponentTreeUIs()
Updates the componentTreeUI of all top-level windows of the current
application.
|
static void |
updateAllComponentTreeUIs(java.awt.Window window)
Updates the componentTreeUI of the given window and all its owned
windows, recursively.
|
static void |
updateMnemonicBinding(javax.swing.JComponent c,
java.lang.String pressed)
A helper for creating and updating key bindings for components with
mnemonics.
|
static void |
updateMnemonicBinding(javax.swing.JComponent c,
java.lang.String pressed,
java.lang.String released)
A helper for creating and updating key bindings for components with
mnemonics.
|
public static void updateMnemonicBinding(javax.swing.JComponent c, java.lang.String pressed)
pressed
action will be invoked when the mnemonic
is activated.
TODO establish an interface for the mnemonic properties, such as MnemonicEnabled
and change signature to public static <T extends
JComponent & MnemonicEnabled> void updateMnemonicBinding(T c, String
pressed)
c
- the component bindings to updatepressed
- the name of the action in the action map to invoke when
the mnemonic is pressedjava.lang.NullPointerException
- if the component is null
public static void updateMnemonicBinding(javax.swing.JComponent c, java.lang.String pressed, java.lang.String released)
pressed
action will be invoked when the mnemonic
is activated and the released
action will be invoked when the
mnemonic is deactivated.
TODO establish an interface for the mnemonic properties, such as MnemonicEnabled
and change signature to public static <T extends
JComponent & MnemonicEnabled> void updateMnemonicBinding(T c, String
pressed, String released)
c
- the component bindings to updatepressed
- the name of the action in the action map to invoke when
the mnemonic is pressedreleased
- the name of the action in the action map to invoke when
the mnemonic is released (if the action is a toggle style, then this
parameter should be null
)java.lang.NullPointerException
- if the component is null
public static void setComponentTreeEnabled(java.awt.Component c, boolean enabled)
c
.c
- the starting componentenabled
- true
if the component is to enabled; false
otherwisepublic static void setComponentTreeLocale(java.awt.Component c, java.util.Locale locale)
c
- the starting componentlocale
- the locale to setpublic static void setComponentTreeBackground(java.awt.Component c, java.awt.Color color)
c
- the starting componentcolor
- the color to setpublic static void setComponentTreeForeground(java.awt.Component c, java.awt.Color color)
c
- the starting componentcolor
- the color to setpublic static void setComponentTreeFont(java.awt.Component c, java.awt.Font font)
c
- the starting componentfont
- the font to setpublic static void setHtmlFont(javax.swing.text.html.HTMLDocument doc, java.awt.Font font)
setHtmlFont
after the data is set will force the HTML display to use the font
specified to this method.doc
- the HTML document to updatefont
- the font to usejava.lang.NullPointerException
- if any parameter is null
public static void updateAllComponentTreeUIs()
public static void updateAllComponentTreeUIs(java.awt.Window window)
window
- the window to updatepublic static <T> java.util.concurrent.FutureTask<T> invokeLater(java.util.concurrent.Callable<T> callable)
SwingUtilities.invokeLater(Runnable)
that supports
return values.T
- the return type of the callablecallable
- the callable to executeCallable
public static <T> T invokeAndWait(java.util.concurrent.Callable<T> callable) throws java.lang.InterruptedException, java.lang.reflect.InvocationTargetException
SwingUtilities.invokeAndWait(Runnable)
that supports
return values.T
- the return type of the callablecallable
- the callable to executejava.lang.InterruptedException
- if we're interrupted while waiting for the
event dispatching thread to finish executing callable.call()
java.lang.reflect.InvocationTargetException
- if an exception is thrown while running
callable
Callable
public static <T> T getAncestor(java.lang.Class<T> clazz, java.awt.Component c)
SwingUtilities.getAncestorOfClass(Class, Component)
. This method
traverses JPopupMenu
invoker and uses generics to return an
appropriately typed object.T
- the type of ancestor to findclazz
- the class instance of the ancestor to findc
- the component to start the search fromnull
if no such
ancestor exists. This method also returns null
if any parameter
is null
.public static boolean isDescendingFrom(java.awt.Component focusOwner, java.awt.Component parent)
focusOwner
- parent
- public static boolean isUIInstallable(java.lang.Object property)
property
- the property to check.public static void setLeadAnchorWithoutSelection(javax.swing.ListSelectionModel selectionModel, int lead, int anchor)
selectionModel
- the selection model to change lead/anchorlead
- the lead selection indexanchor
- the anchor selection indexpublic static boolean shouldIgnore(java.awt.event.MouseEvent mouseEvent, javax.swing.JComponent component)
public static int loc2IndexFileList(javax.swing.JList list, java.awt.Point point)
public static void adjustFocus(javax.swing.JComponent component)
public static int convertModifiersToDropAction(int modifiers, int sourcActions)