Module platform
Package de.grogra.pf.ui.autocomplete.impl

Class Util

java.lang.Object
de.grogra.pf.ui.autocomplete.impl.Util
public final class Util extends Object
Utility methods for the auto-complete framework.
Version:
1.0
Author:
Robert Futrell

  • Field Details

    • 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, to true, 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:

    • PROPERTY_ALLOW_DECORATED_AUTOCOMPLETE_WINDOWS

      public static final String PROPERTY_ALLOW_DECORATED_AUTOCOMPLETE_WINDOWS
      If this system property is true, then even the "main" two auto-complete windows will allow window decorations via PopupWindowDecorator. If this property is undefined or false, 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:

  • Method Details

    • 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 is null, nothing happens and this method returns false.
      Returns:
      Whether the operation was successful. This will be false on JRE's older than 1.6.

    • 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:

    • 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 is false, 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 boolean isLightForeground(Color fg)
      Returns whether the specified color is "light" to use as a foreground. Colors that return true 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 prefix)
      Returns whether a string starts with a specified prefix, ignoring case. This method does not support characters outside the BMP.
      Parameters:
      str - The string to check. This cannot be null.
      prefix - The prefix to check for. This cannot be null.
      Returns:
      Whether str starts with prefix, ignoring case.

    • stripHtml

      public static String stripHtml(String text)
      Strips any HTML from a string. The string must start with "<html>" for markup tags to be stripped.
      Parameters:
      text - The string.
      Returns:
      The string, with any HTML stripped.