#include <berryWorkbenchAdvisor.h>

Inheritance diagram for berry::WorkbenchAdvisor:

Public Member Functions
void	InternalBasicInitialize (IWorkbenchConfigurer::Pointer configurer)

virtual void	Initialize (IWorkbenchConfigurer::Pointer configurer)

virtual void	PreStartup ()

virtual void	PostStartup ()

virtual bool	PreShutdown ()

virtual void	PostShutdown ()

virtual WorkbenchWindowAdvisor *	CreateWorkbenchWindowAdvisor (IWorkbenchWindowConfigurer::Pointer configurer)=0

virtual IAdaptable *	GetDefaultPageInput ()

virtual QString	GetInitialWindowPerspectiveId ()=0

virtual QString	GetMainPreferencePageId ()

virtual bool	OpenWindows ()

virtual bool	SaveState (IMemento::Pointer memento)

virtual bool	RestoreState (IMemento::Pointer memento)

Protected Member Functions
	WorkbenchAdvisor ()

virtual	~WorkbenchAdvisor ()

IWorkbenchConfigurer::Pointer	GetWorkbenchConfigurer ()

Detailed Description

public: base class for configuring the workbench.

Note that the workbench advisor object is created in advance of creating the workbench. However, by the time the workbench starts calling methods on this class, PlatformUI::GetWorkbench() is guaranteed to have been properly initialized.

Example of creating and running a workbench (in an berry::IApplication):


          class MyApplication : public berry::IApplication {

            public:

            int Start()
            {
              WorkbenchAdvisor* workbenchAdvisor = new MyWorkbenchAdvisor();
              berry::Display* display = berry::PlatformUI::CreateDisplay();
              int returnCode = berry::PlatformUI::CreateAndRunWorkbench(display, workbenchAdvisor);

              if (returnCode == PlatformUI::RETURN_RESTART) {
                 return berry::IApplication::EXIT_RESTART;
              } else {
                 return berry::IApplication::EXIT_OK;
            }
          };

An application should declare a subclass of berry::WorkbenchAdvisor and override methods to configure the workbench to suit the needs of the particular application.

The following advisor methods are called at strategic points in the workbench's lifecycle (all occur within the dynamic scope of the call to PlatformUI::CreateAndRunWorkbench()):

Initialize() - called first; before any windows; use to register things
PreStartup() - called second; after initialize but before first window is opened; use to temporarily disable things during startup or restore
PostStartup() - called third; after first window is opened; use to reenable things temporarily disabled in previous step
EventLoopException() - called to handle the case where the event loop has crashed; use to inform the user that things are not well (not implemented yet)
EventLoopIdle() - called when there are currently no more events to be processed; use to perform other work or to yield until new events enter the queue (not implemented yet)
PreShutdown() - called immediately prior to workbench shutdown before any windows have been closed; allows the advisor to veto the shutdown
PostShutdown() - called last; after event loop has terminated and all windows have been closed; use to deregister things registered during initialize

Definition at line 96 of file berryWorkbenchAdvisor.h.

Constructor & Destructor Documentation

berry::WorkbenchAdvisor::WorkbenchAdvisor ( )

protected

Creates and initializes a new workbench advisor instance.

Definition at line 24 of file berryWorkbenchAdvisor.cpp.

berry::WorkbenchAdvisor::~WorkbenchAdvisor ( )

protectedvirtual

Definition at line 29 of file berryWorkbenchAdvisor.cpp.

Member Function Documentation

virtual WorkbenchWindowAdvisor* berry::WorkbenchAdvisor::CreateWorkbenchWindowAdvisor ( IWorkbenchWindowConfigurer::Pointer configurer )

pure virtual

Creates a new workbench window advisor for configuring a new workbench window via the given workbench window configurer. Clients should override to provide their own window configurer.

Parameters

configurer the workbench window configurer

Returns: a new workbench window advisor

Implemented in QmitkDiffusionImagingAppWorkbenchAdvisor.

IAdaptable * berry::WorkbenchAdvisor::GetDefaultPageInput ( )

virtual

Returns the default input for newly created workbench pages when the input is not explicitly specified.

The default implementation returns null. Subclasses may override.

Returns: the default input for a new workbench window page, or null if none

See also: CreateWorkbenchWindowAdvisor(IWorkbenchWindowConfigurer::Pointer)

Definition at line 73 of file berryWorkbenchAdvisor.cpp.

virtual QString berry::WorkbenchAdvisor::GetInitialWindowPerspectiveId ( )

pure virtual

Returns the id of the perspective to use for the initial workbench window, or null if no initial perspective should be shown in the initial workbench window.

This method is called during startup when the workbench is creating the first new window. Subclasses must implement.

If the WorkbenchPreferenceConstants::DEFAULT_PERSPECTIVE_ID preference is specified, it supercedes the perspective specified here.

Returns: the id of the perspective for the initial window, or null if no initial perspective should be shown

Implemented in QmitkDiffusionImagingAppWorkbenchAdvisor.

QString berry::WorkbenchAdvisor::GetMainPreferencePageId ( )

virtual

Returns the id of the preference page that should be presented most prominently.

The default implementation returns null. Subclasses may override.

Returns: the id of the preference page, or null if none

Definition at line 79 of file berryWorkbenchAdvisor.cpp.

IWorkbenchConfigurer::Pointer berry::WorkbenchAdvisor::GetWorkbenchConfigurer ( )

protected

Returns the workbench configurer for the advisor. Can be null if the advisor is not initialized yet.

Returns: the workbench configurer, or null if the advisor is not initialized yet

Definition at line 48 of file berryWorkbenchAdvisor.cpp.

Referenced by OpenWindows().

void berry::WorkbenchAdvisor::Initialize ( IWorkbenchConfigurer::Pointer configurer )

virtual

Performs arbitrary initialization before the workbench starts running.

This method is called during workbench initialization prior to any windows being opened. Clients must not call this method directly (although super calls are okay). The default implementation does nothing. Subclasses may override. Typical clients will use the configurer passed in to tweak the workbench. If further tweaking is required in the future, the configurer may be obtained using GetWorkbenchConfigurer().

Parameters

configurer an object for configuring the workbench

Reimplemented in berry::QtWorkbenchAdvisor, and QmitkDiffusionImagingAppWorkbenchAdvisor.

Definition at line 43 of file berryWorkbenchAdvisor.cpp.

Referenced by berry::QtWorkbenchAdvisor::Initialize(), and InternalBasicInitialize().

void berry::WorkbenchAdvisor::InternalBasicInitialize ( IWorkbenchConfigurer::Pointer configurer )

Remembers the configurer and calls Initialize().

For internal use by the workbench only.

Parameters

configurer an object for configuring the workbench

Definition at line 33 of file berryWorkbenchAdvisor.cpp.

References Initialize().

bool berry::WorkbenchAdvisor::OpenWindows ( )

virtual

Opens the workbench windows on startup. The default implementation tries to restore the previously saved workbench state using IWorkbenchConfigurer::RestoreState(). If there was no previously saved state, or if the restore failed, then a first-time window is opened using IWorkbenchConfigurer::OpenFirstTimeWindow().

Returns: true to proceed with workbench startup, or false to exit

Definition at line 85 of file berryWorkbenchAdvisor.cpp.

References GetWorkbenchConfigurer().

void berry::WorkbenchAdvisor::PostShutdown ( )

virtual

Performs arbitrary finalization after the workbench stops running.

This method is called during workbench shutdown after all windows have been closed. Clients must not call this method directly (although super calls are okay). The default implementation does nothing. Subclasses may override.

Definition at line 68 of file berryWorkbenchAdvisor.cpp.

void berry::WorkbenchAdvisor::PostStartup ( )

virtual

Performs arbitrary actions after the workbench windows have been opened (or restored), but before the main event loop is run.

This method is called just after the windows have been opened. Clients must not call this method directly (although super calls are okay). The default implementation does nothing. Subclasses may override. It is okay to call IWorkbench::Close() from this method.

Definition at line 58 of file berryWorkbenchAdvisor.cpp.

bool berry::WorkbenchAdvisor::PreShutdown ( )

virtual

Performs arbitrary finalization before the workbench is about to shut down.

This method is called immediately prior to workbench shutdown before any windows have been closed. Clients must not call this method directly (although super calls are okay). The default implementation returns true. Subclasses may override.

The advisor may veto a regular shutdown by returning false, although this will be ignored if the workbench is being forced to shut down.

Returns: true to allow the workbench to proceed with shutdown, false to veto a non-forced shutdown

Definition at line 63 of file berryWorkbenchAdvisor.cpp.

void berry::WorkbenchAdvisor::PreStartup ( )

virtual

Performs arbitrary actions just before the first workbench window is opened (or restored).

This method is called after the workbench has been initialized and just before the first window is about to be opened. Clients must not call this method directly (although super calls are okay). The default implementation does nothing. Subclasses may override.

Definition at line 53 of file berryWorkbenchAdvisor.cpp.

bool berry::WorkbenchAdvisor::RestoreState ( IMemento::Pointer memento )

virtual

Restores arbitrary application-specific state information for this workbench advisor.

The default implementation simply returns an OK status. Subclasses may extend or override.

Parameters

memento the memento from which to restore the advisor's state

Returns: a status object indicating whether the restore was successful

Definition at line 165 of file berryWorkbenchAdvisor.cpp.

bool berry::WorkbenchAdvisor::SaveState ( IMemento::Pointer memento )

virtual

Saves arbitrary application-specific state information for this workbench advisor.

The default implementation simply returns an OK status. Subclasses may extend or override.

Parameters

memento the memento in which to save the advisor's state

Returns: a status object indicating whether the save was successful

Definition at line 160 of file berryWorkbenchAdvisor.cpp.

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation