berry::IPerspectiveRegistry Struct Reference

#include <berryIPerspectiveRegistry.h>

Public Member Functions
virtual	~IPerspectiveRegistry ()
virtual IPerspectiveDescriptor::Pointer	ClonePerspective (const QString &id, const QString &label, IPerspectiveDescriptor::Pointer desc)=0
virtual void	DeletePerspective (IPerspectiveDescriptor::Pointer persp)=0
virtual IPerspectiveDescriptor::Pointer	FindPerspectiveWithId (const QString &perspectiveId)=0
virtual IPerspectiveDescriptor::Pointer	FindPerspectiveWithLabel (const QString &label)=0
virtual QString	GetDefaultPerspective ()=0
virtual QList< IPerspectiveDescriptor::Pointer >	GetPerspectives ()=0
virtual void	SetDefaultPerspective (const QString &id)=0
virtual void	RevertPerspective (IPerspectiveDescriptor::Pointer perspToRevert)=0

Detailed Description

The workbench's global registry of perspectives.

This registry contains a descriptor for each perspectives in the workbench. It is initially populated with stock perspectives from the workbench's perspective extension point ("org.blueberry.ui.perspectives") and with custom perspectives defined by the user.

This interface is not intended to be implemented by clients.

See also

IWorkbench::getPerspectiveRegistry This interface is not intended to be implemented by clients.

Definition at line 41 of file berryIPerspectiveRegistry.h.

Constructor & Destructor Documentation

berry::IPerspectiveRegistry::~IPerspectiveRegistry ( )

virtual

Definition at line 22 of file berryIPerspectiveRegistry.cpp.

Member Function Documentation

virtual IPerspectiveDescriptor::Pointer berry::IPerspectiveRegistry::ClonePerspective ( const QString &  id, const QString &  label, IPerspectiveDescriptor::Pointer  desc  )

pure virtual

Create a new perspective.

Parameters

label	the name of the new descriptor
originalDescriptor	the descriptor on which to base the new descriptor

Returns

a new perspective descriptor or null if the creation failed. Clones an existing perspective.

Parameters

id	the id for the cloned perspective, which must not already be used by any registered perspective
label	the label assigned to the cloned perspective
desc	the perspective to clone

Returns

the cloned perspective descriptor

Exceptions

IllegalArgumentException

if there is already a perspective with the given id

virtual void berry::IPerspectiveRegistry::DeletePerspective ( IPerspectiveDescriptor::Pointer  persp )

pure virtual

Deletes a perspective. Has no effect if the perspective is defined in an extension.

Parameters

persp

the perspective to delete

virtual IPerspectiveDescriptor::Pointer berry::IPerspectiveRegistry::FindPerspectiveWithId ( const QString &  perspectiveId )

pure virtual

Finds and returns the registered perspective with the given perspective id.

Parameters

perspectiveId

the perspective id

Returns

the perspective, or null if none

See also

IPerspectiveDescriptor::getId

virtual IPerspectiveDescriptor::Pointer berry::IPerspectiveRegistry::FindPerspectiveWithLabel ( const QString &  label )

pure virtual

Finds and returns the registered perspective with the given label.

Parameters

label

the label

Returns

the perspective, or null if none

See also

IPerspectiveDescriptor::getLabel

virtual QString berry::IPerspectiveRegistry::GetDefaultPerspective ( )

pure virtual

Returns the id of the default perspective for the workbench. This identifies one perspective extension within the workbench's perspective registry.

Returns null if there is no default perspective.

Returns

the default perspective id, or null

virtual QList<IPerspectiveDescriptor::Pointer> berry::IPerspectiveRegistry::GetPerspectives ( )

pure virtual

Returns a list of the perspectives known to the workbench.

Returns

a list of perspectives

Referenced by QmitkViewNavigatorWidget::FillTreeList(), and QmitkExtWorkbenchWindowAdvisor::PostWindowCreate().

virtual void berry::IPerspectiveRegistry::RevertPerspective ( IPerspectiveDescriptor::Pointer  perspToRevert )

pure virtual

Reverts a perspective back to its original definition as specified in the plug-in manifest.

Parameters

perspToRevert

the perspective to revert

virtual void berry::IPerspectiveRegistry::SetDefaultPerspective ( const QString &  id )

pure virtual

Sets the default perspective for the workbench to the given perspective id. If non-null, the id must correspond to a perspective extension within the workbench's perspective registry.

A null id indicates no default perspective.

Parameters

id	a perspective id, or null

---

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

• berryIPerspectiveRegistry.h
• berryIPerspectiveRegistry.cpp