Splash Handlers

org.eclipse.ui.splashHandlers

Since 3.3

This extension point allows for the contribution of splash handlers. These splash handlers may contribute custom behavior to the splash screen that appears during the start-up procedure that may include (but is not limited to) custom graphics and animation, custom progress reporting, and interactive behaviors.

It is possible to have only one splash handler active at a given time and the decision of which handler to choose from comes down to a product binding.

The splash life cycle is as follows:

<!ELEMENT extension (splashHandler* , splashHandlerProductBinding*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT splashHandler EMPTY>

<!ATTLIST splashHandler

id    CDATA #REQUIRED

class CDATA #REQUIRED>


<!ELEMENT splashHandlerProductBinding EMPTY>

<!ATTLIST splashHandlerProductBinding

splashId  CDATA #REQUIRED

productId CDATA #REQUIRED>


The following is an example of this extension point:

   

<extension point=

"org.eclipse.ui.splashHandlers"

>

<splashHandler class=

"com.xyz.splash.Handler"

id=

"com.xyz.splash"

>

</splashHandler>

<splashHandlerProductBinding productId=

"com.xyz.product"

splashId=

"com.xyz.splash"

>

</splashHandlerProductBinding>

</extension>

The value of the class attribute must be a fully qualified name of the class that extends org.eclipse.ui.splash.AbstractSplashHandler. It is common practice to subclass org.eclipse.ui.splash.BasicSplashHandler if the standard progress reporting is desired.

In the absence of a product-bound handler described by an extension of this type the default Eclipse splash is used. This splash is driven by product constants defined in org.eclipse.ui.branding.IProductConstants and will display a progress bar and message area at specified locations in specified colors.