Package org.fife.ui.autocomplete
Class Util
- java.lang.Object
-
- org.fife.ui.autocomplete.Util
-
public class Util extends Object
Utility methods for the auto-complete framework.- Version:
- 1.0
- Author:
- Robert Futrell
-
-
Field Summary
Fields Modifier and Type Field Description static String
PROPERTY_ALLOW_DECORATED_AUTOCOMPLETE_WINDOWS
If this system property istrue
, then even the "main" two auto-complete windows will allow window decorations viaPopupWindowDecorator
.static String
PROPERTY_DONT_USE_SUBSTANCE_RENDERERS
If a system property is defined with this name and set, ignoring case, totrue
, this library will not attempt to use Substance renderers.
-
Constructor Summary
Constructors Constructor Description Util()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static boolean
browse(URI uri)
Attempts to open a web browser to the specified URI.static String
getHexString(Color c)
Returns a hex string for the specified color, suitable for HTML.static Rectangle
getScreenBoundsForPoint(int x, int y)
Returns the screen coordinates for the monitor that contains the specified point.static boolean
getShouldAllowDecoratingMainAutoCompleteWindows()
Give apps a chance to decorate us with drop shadows, etc.static boolean
getUseSubstanceRenderers()
Returns whether we should attempt to use Substance cell renderers and styles for things such as completion choices, if a Substance Look and Feel is installed.static boolean
isLightForeground(Color fg)
Returns whether the specified color is "light" to use as a foreground.static boolean
startsWithIgnoreCase(String str, String start)
Returns whetherstr
starts withstart
, ignoring case.static String
stripHtml(String text)
Strips any HTML from a string.
-
-
-
Field Detail
-
PROPERTY_DONT_USE_SUBSTANCE_RENDERERS
public static final String PROPERTY_DONT_USE_SUBSTANCE_RENDERERS
If a system property is defined with this name and set, ignoring case, totrue
, this library will not attempt to use Substance renderers. Otherwise, if a Substance Look and Feel is installed, we will attempt to use Substance cell renderers in all of our dropdowns.Note that we do not have a build dependency on Substance, so all access to Substance stuff is done via reflection. We will fall back onto default renderers if something goes horribly wrong.
- See Also:
- Constant Field Values
-
PROPERTY_ALLOW_DECORATED_AUTOCOMPLETE_WINDOWS
public static final String PROPERTY_ALLOW_DECORATED_AUTOCOMPLETE_WINDOWS
If this system property istrue
, then even the "main" two auto-complete windows will allow window decorations viaPopupWindowDecorator
. If this property is undefined orfalse
, they won't honor such decorations. This is due to certain performance issues with translucent windows (used for drop shadows), even as of Java 7u2.- See Also:
- Constant Field Values
-
-
Method Detail
-
browse
public static boolean browse(URI uri)
Attempts to open a web browser to the specified URI.- Parameters:
uri
- The URI to open. If this isnull
, nothing happens and this method returnsfalse
.- Returns:
- Whether the operation was successful. This will be
false
on JRE's older than 1.6.
-
getHexString
public static String getHexString(Color c)
Returns a hex string for the specified color, suitable for HTML.- Parameters:
c
- The color.- Returns:
- The string representation, in the form "
#rrggbb
", ornull
ifc
isnull
.
-
getScreenBoundsForPoint
public static Rectangle getScreenBoundsForPoint(int x, int y)
Returns the screen coordinates for the monitor that contains the specified point. This is useful for setups with multiple monitors, to ensure that popup windows are positioned properly.- Parameters:
x
- The x-coordinate, in screen coordinates.y
- The y-coordinate, in screen coordinates.- Returns:
- The bounds of the monitor that contains the specified point.
-
getShouldAllowDecoratingMainAutoCompleteWindows
public static boolean getShouldAllowDecoratingMainAutoCompleteWindows()
Give apps a chance to decorate us with drop shadows, etc. Since very scrolly things such as lists (of e.g. completions) are *very* slow when in per-pixel translucent windows, even as of Java 7u2, we force the user to specify an extra option for the two "main" auto-complete windows.- Returns:
- Whether to allow decorating the main auto-complete windows.
- See Also:
PROPERTY_ALLOW_DECORATED_AUTOCOMPLETE_WINDOWS
-
getUseSubstanceRenderers
public static boolean getUseSubstanceRenderers()
Returns whether we should attempt to use Substance cell renderers and styles for things such as completion choices, if a Substance Look and Feel is installed. If this isfalse
, we'll use our standard rendering for completions, even when Substance is being used.- Returns:
- Whether to use Substance renderers if Substance is installed.
-
isLightForeground
public static final boolean isLightForeground(Color fg)
Returns whether the specified color is "light" to use as a foreground. Colors that returntrue
indicate that the current Look and Feel probably uses light text colors on a dark background.- Parameters:
fg
- The foreground color.- Returns:
- Whether it is a "light" foreground color.
-
startsWithIgnoreCase
public static boolean startsWithIgnoreCase(String str, String start)
Returns whetherstr
starts withstart
, ignoring case.- Parameters:
str
- The string to check.start
- The prefix to check for.- Returns:
- Whether
str
starts withstart
, ignoring case.
-
-