Class UIPlugin

All Implemented Interfaces:
BundleActivator

public final class UIPlugin extends AbstractUIPlugin
The plug-in class for the org.eclipse.ui plug-in. This class is internal to the workbench and should not be referenced by clients.
  • Constructor Details

    • UIPlugin

      public UIPlugin()
      Creates an instance of the UIPlugin.
      Since:
      3.0
  • Method Details

    • createImageRegistry

      protected ImageRegistry createImageRegistry()
      Returns the image registry for this plugin. Where are the images? The images (typically png) are found in the same plugins directory. Note: The workbench uses the standard JFace ImageRegistry to track its images. In addition the class WorkbenchGraphicResources provides convenience access to the graphics resources and fast field access for some of the commonly used graphical images.
      Overrides:
      createImageRegistry in class AbstractUIPlugin
      Returns:
      ImageRegistry the resulting registry.
      See Also:
    • getImageRegistry

      public ImageRegistry getImageRegistry()
      Description copied from class: AbstractUIPlugin
      Returns the image registry for this UI plug-in.

      The image registry contains the images used by this plug-in that are very frequently used and so need to be globally shared within the plug-in. Since many OSs have a severe limit on the number of images that can be in memory at any given time, a plug-in should only keep a small number of images in their registry.

      Subclasses should reimplement initializeImageRegistry if they have custom graphic images to load.

      Subclasses may override this method but are not expected to.

      Overrides:
      getImageRegistry in class AbstractUIPlugin
      Returns:
      the image registry
    • getDefault

      public static UIPlugin getDefault()
      Returns the default instance of the receiver. This represents the runtime plugin.
      Returns:
      UIPlugin the singleton instance of the receiver.
      See Also:
    • start

      public void start(BundleContext context) throws Exception
      Description copied from class: AbstractUIPlugin
      The AbstractUIPlugin implementation of this Plugin method refreshes the plug-in actions. Subclasses may extend this method, but must send super first. Starts up this plug-in.

      This method should be overridden in subclasses that need to do something when this plug-in is started. Implementors should call the inherited method at the first possible point to ensure that any system requirements can be met.

      If this method throws an exception, it is taken as an indication that plug-in initialization has failed; as a result, the plug-in will not be activated; moreover, the plug-in will be marked as disabled and ineligible for activation for the duration.

      Note 1: This method is automatically invoked by the platform the first time any code in the plug-in is executed.

      Note 2: This method is intended to perform simple initialization of the plug-in environment. The platform may terminate initializers that do not complete in a timely fashion.

      Note 3: The class loader typically has monitors acquired during invocation of this method. It is strongly recommended that this method avoid synchronized blocks or other thread locking mechanisms, as this would lead to deadlock vulnerability.

      Note 4: The supplied bundle context represents the plug-in to the OSGi framework. For security reasons, it is strongly recommended that this object should not be divulged.

      Note 5: This method and the Plugin.stop(BundleContext) may be called from separate threads, but the OSGi framework ensures that both methods will not be called simultaneously.

      Clients must never explicitly call this method.
      Specified by:
      start in interface BundleActivator
      Overrides:
      start in class AbstractUIPlugin
      Parameters:
      context - the bundle context for this plug-in
      Throws:
      Exception - if this plug-in did not start up properly