Class JFaceResources

java.lang.Object
org.eclipse.jface.resource.JFaceResources

public class JFaceResources extends Object
Utility methods to access JFace-specific resources.

All methods declared on this class are static. This class cannot be instantiated.

The following global state is also maintained by this class:

  • a font registry
  • a color registry
  • an image registry
  • a resource bundle
Restriction:
This class is not intended to be subclassed by clients.
Restriction:
This class is not intended to be instantiated by clients.
  • Field Details

    • DEFAULT_FONT

      public static final String DEFAULT_FONT
      The symbolic font name for the standard font (value "org.eclipse.jface.defaultfont").
      See Also:
    • DIALOG_FONT

      public static final String DIALOG_FONT
      The symbolic font name for the dialog font (value "org.eclipse.jface.dialogfont").
      See Also:
    • HEADER_FONT

      public static final String HEADER_FONT
      The symbolic font name for the header font (value "org.eclipse.jface.headerfont").
      See Also:
    • TEXT_FONT

      public static final String TEXT_FONT
      The symbolic font name for the text font (value "org.eclipse.jface.textfont").
      See Also:
    • VIEWER_FONT

      @Deprecated public static final String VIEWER_FONT
      Deprecated.
      This font is not in use
      The symbolic font name for the viewer font (value "org.eclipse.jface.viewerfont").
      See Also:
    • WINDOW_FONT

      @Deprecated public static final String WINDOW_FONT
      Deprecated.
      This font is not in use
      The symbolic font name for the window font (value "org.eclipse.jface.windowfont").
      See Also:
  • Method Details

    • format

      public static String format(String key, Object... args)
      Returns the formatted message for the given key in JFace's resource bundle.
      Parameters:
      key - the resource name
      args - the message arguments
      Returns:
      the string
    • getBannerFont

      public static Font getBannerFont()
      Returns the JFace's banner font. Convenience method equivalent to
       JFaceResources.getFontRegistry().get(JFaceResources.BANNER_FONT)
       
      Returns:
      the font
    • getBundle

      public static ResourceBundle getBundle()
      Returns the resource bundle for JFace itself. The resource bundle is obtained from ResourceBundle.getBundle("org.eclipse.jface.jface_nls").

      Note that several static convenience methods are also provided on this class for directly accessing resources in this bundle.

      Returns:
      the resource bundle
    • getColorRegistry

      public static ColorRegistry getColorRegistry()
      Returns the color registry for JFace itself.
      Returns:
      the ColorRegistry.
      Since:
      3.0
    • getResources

      public static ResourceManager getResources(Display toQuery)
      Returns the global resource manager for the given display
      Parameters:
      toQuery - display to query
      Returns:
      the global resource manager for the given display
      Since:
      3.1
    • getResources

      public static ResourceManager getResources()
      Returns the ResourceManager for the current display. May only be called from a UI thread.
      Returns:
      the global ResourceManager for the current display
      Since:
      3.1
    • getDefaultFont

      public static Font getDefaultFont()
      Returns JFace's standard font. Convenience method equivalent to
       JFaceResources.getFontRegistry().get(JFaceResources.DEFAULT_FONT)
       
      Returns:
      the font
    • getDefaultFontDescriptor

      public static FontDescriptor getDefaultFontDescriptor()
      Returns the descriptor for JFace's standard font. Convenience method equivalent to
       JFaceResources.getFontRegistry().getDescriptor(JFaceResources.DEFAULT_FONT)
       
      Returns:
      the font
      Since:
      3.3
    • getDialogFont

      public static Font getDialogFont()
      Returns the JFace's dialog font. Convenience method equivalent to
       JFaceResources.getFontRegistry().get(JFaceResources.DIALOG_FONT)
       
      Returns:
      the font
    • getDialogFontDescriptor

      public static FontDescriptor getDialogFontDescriptor()
      Returns the descriptor for JFace's dialog font. Convenience method equivalent to
       JFaceResources.getFontRegistry().getDescriptor(JFaceResources.DIALOG_FONT)
       
      Returns:
      the font
      Since:
      3.3
    • getFont

      public static Font getFont(String symbolicName)
      Returns the font in JFace's font registry with the given symbolic font name. Convenience method equivalent to
       JFaceResources.getFontRegistry().get(symbolicName)
       
      If an error occurs, return the default font.
      Parameters:
      symbolicName - the symbolic font name
      Returns:
      the font
    • getFontDescriptor

      public static FontDescriptor getFontDescriptor(String symbolicName)
      Returns the font descriptor for in JFace's font registry with the given symbolic name. Convenience method equivalent to
       JFaceResources.getFontRegistry().getDescriptor(symbolicName)
       
      If an error occurs, return the default font.
      Parameters:
      symbolicName - the symbolic font name
      Returns:
      the font descriptor (never null)
      Since:
      3.3
    • getFontRegistry

      public static FontRegistry getFontRegistry()
      Returns the font registry for JFace itself. If the value has not been established by an earlier call to setFontRegistry, is it initialized to new FontRegistry("org.eclipse.jface.resource.jfacefonts").

      Note that several static convenience methods are also provided on this class for directly accessing JFace's standard fonts.

      Returns:
      the JFace font registry
    • getHeaderFont

      public static Font getHeaderFont()
      Returns the JFace's header font. Convenience method equivalent to
       JFaceResources.getFontRegistry().get(JFaceResources.HEADER_FONT)
       
      Returns:
      the font
    • getHeaderFontDescriptor

      public static FontDescriptor getHeaderFontDescriptor()
      Returns the descriptor for JFace's header font. Convenience method equivalent to
       JFaceResources.getFontRegistry().get(JFaceResources.HEADER_FONT)
       
      Returns:
      the font descriptor (never null)
      Since:
      3.3
    • getImage

      public static Image getImage(String key)
      Returns the image in JFace's image registry with the given key, or null if none. Convenience method equivalent to
       JFaceResources.getImageRegistry().get(key)
       
      Parameters:
      key - the key
      Returns:
      the image, or null if none
    • getImageRegistry

      public static ImageRegistry getImageRegistry()
      Returns the image registry for JFace itself.

      Note that the static convenience method getImage is also provided on this class.

      Returns:
      the JFace image registry
    • getString

      public static String getString(String key)
      Returns the resource object with the given key in JFace's resource bundle. If there isn't any value under the given key, the key is returned.
      Parameters:
      key - the resource name
      Returns:
      the string
    • getStrings

      public static String[] getStrings(String[] keys)
      Returns a list of string values corresponding to the given list of keys. The lookup is done with getString. The values are in the same order as the keys.
      Parameters:
      keys - a list of keys
      Returns:
      a list of corresponding string values
    • getTextFont

      public static Font getTextFont()
      Returns JFace's text font. Convenience method equivalent to
       JFaceResources.getFontRegistry().get(JFaceResources.TEXT_FONT)
       
      Returns:
      the font
    • getTextFontDescriptor

      public static FontDescriptor getTextFontDescriptor()
      Returns the descriptor for JFace's text font. Convenience method equivalent to
       JFaceResources.getFontRegistry().getDescriptor(JFaceResources.TEXT_FONT)
       
      Returns:
      the font descriptor (never null)
      Since:
      3.3
    • getViewerFont

      @Deprecated public static Font getViewerFont()
      Deprecated.
      This font is not in use
      Returns JFace's viewer font. Convenience method equivalent to
       JFaceResources.getFontRegistry().get(JFaceResources.VIEWER_FONT)
       
      Returns:
      the font
    • setFontRegistry

      public static void setFontRegistry(FontRegistry registry)
      Sets JFace's font registry to the given value. This method may only be called once; the call must occur before JFaceResources.getFontRegistry is invoked (either directly or indirectly).
      Parameters:
      registry - a font registry
    • managerFor

      public static LocalResourceManager managerFor(Control owner)
      Creates a local registry that wraps the ResourceManager for the current display. Anything allocated by this registry will be automatically cleaned up with the given control is disposed. Note that registries created in this way should not be used to allocate any resource that must outlive the given control. shortcut for LocalResourceManager(JFaceResources.getResources(), owner)
      Parameters:
      owner - control whose disposal will trigger cleanup of everything in the registry.
      Returns:
      LocalResourceManager
      Since:
      3.32