Medical Imaging Interaction Toolkit
2016.11.0
Medical Imaging Interaction Toolkit
|
#include <berryIPerspectiveFactory.h>
Public Member Functions | |
berryObjectMacro (berry::IPerspectiveFactory)~IPerspectiveFactory() | |
virtual void | CreateInitialLayout (IPageLayout::Pointer layout)=0 |
Public Member Functions inherited from berry::Object | |
virtual QString | GetClassName () const |
virtual Reflection::TypeInfo | GetTypeInfo () const |
virtual QList< Reflection::TypeInfo > | GetSuperclasses () const |
virtual void | Delete () |
QDebug | Print (QDebug os, Indent Indent=0) const |
virtual QString | ToString () const |
virtual uint | HashCode () const |
virtual bool | operator< (const Object *) const |
void | Register () const |
void | UnRegister (bool del=true) const |
int | GetReferenceCount () const |
void | SetReferenceCount (int) |
void | AddDestroyListener (const MessageAbstractDelegate<> &delegate) const |
void | RemoveDestroyListener (const MessageAbstractDelegate<> &delegate) const |
virtual bool | operator== (const Object *) const |
Additional Inherited Members | |
Public Types inherited from berry::Object | |
typedef Object | Self |
typedef berry::SmartPointer< Self > | Pointer |
typedef berry::SmartPointer< const Self > | ConstPointer |
typedef berry::WeakPointer< Self > | WeakPtr |
typedef berry::WeakPointer< const Self > | ConstWeakPtr |
Static Public Member Functions inherited from berry::Object | |
static const char * | GetStaticClassName () |
static Reflection::TypeInfo | GetStaticTypeInfo () |
static QList< Reflection::TypeInfo > | GetStaticSuperclasses () |
Protected Member Functions inherited from berry::Object | |
Object () | |
virtual | ~Object () |
virtual QDebug | PrintSelf (QDebug os, Indent indent) const |
virtual QDebug | PrintHeader (QDebug os, Indent indent) const |
virtual QDebug | PrintTrailer (QDebug os, Indent indent) const |
Protected Attributes inherited from berry::Object | |
QAtomicInt | m_ReferenceCount |
QMutex | m_ReferenceCountLock |
A perspective factory generates the initial page layout and visible action set for a page.
When a new page is created in the workbench a perspective is used to define the initial page layout. If this is a predefined perspective (based on an extension to the workbench's perspective extension point) an IPerspectiveFactory
is used to define the initial page layout.
The factory for the perspective is created and passed an IPageLayout
where views can be added. The default layout consists of the editor area with no additional views. Additional views are added to the layout using the editor area as the initial point of reference. The factory is used only briefly while a new page is created; then discarded.
To define a perspective clients should implement this interface and include the name of their class in an extension to the workbench's perspective extension point (named "org.blueberry.ui.perspectives"
). For example, the plug-in's XML markup might contain:
<extension point="org.blueberry.ui.perspectives"> <perspective id="com.example.plugin.perspective" name="My Perspective" class="namespaze::MyPerspective"> </perspective> </extension>
Example of populating a page with standard workbench views:
public: void CreateInitialLayout(IPageLayout layout) { // Get the editor area. QString editorArea = layout->GetEditorArea();
// Top left: Resource Navigator view and Bookmarks view placeholder IFolderLayout::Pointer topLeft = layout->CreateFolder("topLeft", IPageLayout::LEFT, 0.25f, editorArea); topLeft->AddView(IPageLayout::ID_RES_NAV); topLeft->AddPlaceholder(IPageLayout::ID_BOOKMARKS);
// Bottom left: Outline view and Property Sheet view IFolderLayout::Pointer bottomLeft = layout->CreateFolder("bottomLeft", IPageLayout::BOTTOM, 0.50f, "topLeft"); bottomLeft->AddView(IPageLayout::ID_OUTLINE); bottomLeft->AddView(IPageLayout::ID_PROP_SHEET);
// Bottom right: Task List view layout->AddView(IPageLayout::ID_TASK_LIST, IPageLayout::BOTTOM, 0.66f, editorArea); }
Within the workbench a user may override the visible views, layout and action sets of a predefined perspective to create a custom perspective. In such cases the layout is persisted by the workbench and the factory is not used.
Definition at line 86 of file berryIPerspectiveFactory.h.
berry::IPerspectiveFactory::berryObjectMacro | ( | berry::IPerspectiveFactory | ) |
|
pure virtual |
Creates the initial layout for a page.
Implementors of this method may add additional views to a perspective. The perspective already contains an editor folder identified by the result of IPageLayout.getEditorArea()
. Additional views should be added to the layout using this value as the initial point of reference.
layout | the page layout |
Implemented in berry::EmptyPerspective.