on the client does the work of instantiating the controls used to represent the launcher in the user interface. The default personality provided in the com.ibm.rcp.platform.personality
plug-in implements the DefaultWorkbenchWindowAdvisor
. The DefaultWorkbenchWindowAdvisor
creates an SButton
widget to represent the Launch button. It instantiates the LauncherManager
and passes a reference for it to the button. It then schedules a Job to build the LauncherRegistry
. The LauncherRegistry
builds a list of launcher contributions. Upon completion of that job a UIJob
is scheduled to fill the Launcher with the contributions resulting from the LauncherRegistry
The following classes are a few of the classes provided by the package com.ibm.rcp.ui.launcher
- LauncherManager - The class that is used to manage launcher contributions and the UI of those contributions. It uses SMenuManager to render launcher contributions in an SMenu and uses a given IBookmarkProvider for dynamically fetching content from the bookmark provider. The LauncherManager is a singleton enforced by making the constructors private and providing a static LauncherManager.getInstance() method for obtaining the singleton LauncherManager for a given WorkbenchWindow.
- LauncherContributionItem – This class is the base class that all contributions to the Launcher must inherit from in order to be launched. The exceptions are a Separator or a GroupMarker.
- EnvironmentVar - Used by the NativeProgramLauncherContributionItem to define system environment variable for configuring the environment to run a native program.
The following class is provided by the package com.ibm.rcp.jface.action
- SMenuManager - A subclass of Eclipse's MenuManager that has been enhanced to use SMenu rather than Menu.
You can populate the launcher either dynamically through extensions or through direct calls into the Launcher public APIs located in the platform personality bundle.
If you are using WebSphere® Portal to create a Portal-based applications that you are pushing to the client through the Composite Application Infrastructure, you can add the page to the launcher by specifying the following page parameter: com.ibm.rcp.launcher=true
Parent topic: Custom widgets: XPD622