#include <berryIPageLayout.h>

Inheritance diagram for berry::IPageLayout:

Collaboration diagram for berry::IPageLayout:

Public Member Functions
	berryObjectMacro (berry::IPageLayout)

virtual void	AddPerspectiveShortcut (const QString &id)=0

virtual void	AddPlaceholder (const QString &viewId, int relationship, float ratio, const QString &refId)=0

virtual void	AddShowInPart (const QString &id)=0

virtual void	AddShowViewShortcut (const QString &id)=0

virtual void	AddView (const QString &viewId, int relationship, float ratio, const QString &refId)=0

virtual IFolderLayout::Pointer	CreateFolder (const QString &folderId, int relationship, float ratio, const QString &refId)=0

virtual IPlaceholderFolderLayout::Pointer	CreatePlaceholderFolder (const QString &folderId, int relationship, float ratio, const QString &refId)=0

virtual QString	GetEditorArea ()=0

virtual bool	IsEditorAreaVisible ()=0

virtual void	SetEditorAreaVisible (bool showEditorArea)=0

virtual void	SetFixed (bool isFixed)=0

virtual bool	IsFixed ()=0

virtual IViewLayout::Pointer	GetViewLayout (const QString &id)=0

virtual void	AddStandaloneView (const QString &viewId, bool showTitle, int relationship, float ratio, const QString &refId)=0

virtual void	AddStandaloneViewPlaceholder (const QString &viewId, int relationship, float ratio, const QString &refId, bool showTitle)=0

virtual IPerspectiveDescriptor::Pointer	GetDescriptor ()=0

virtual IPlaceholderFolderLayout::Pointer	GetFolderForView (const QString &id)=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

Static Public Attributes
static const QString	ID_EDITOR_AREA

static const QString	ID_RES_NAV

static const QString	ID_PROP_SHEET

static const QString	ID_OUTLINE

static const QString	ID_BOOKMARKS

static const QString	ID_PROBLEM_VIEW

static const QString	ID_PROGRESS_VIEW

static const QString	ID_TASK_LIST

static const QString	ID_NAVIGATE_ACTION_SET

static const int	LEFT

static const int	RIGHT

static const int	TOP

static const int	BOTTOM

static const float	RATIO_MIN

static const float	RATIO_MAX

static const float	DEFAULT_VIEW_RATIO

static const float	INVALID_RATIO

static const float	nullptr_RATIO

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

Detailed Description

A page layout defines the initial layout for a perspective within a page in a workbench window.

This interface is not intended to be implemented by clients.

When a perspective is opened, it creates a new page layout with a single editor area. This layout is then passed to the perspective factory (implementation of IPerspectiveFactory#CreateInitialLayout) where additional views and other content can be added, using the existing editor area as the initial point of reference.

In some cases, multiple instances of a particular view may need to be added to the same layout. These are disambiguated using a secondary id. In layout methods taking a view id, the id can have the compound form: primaryId [':' secondaryId]. If a secondary id is given, the view must allow multiple instances by having specified allowMultiple="true" in its extension. View placeholders may also have a secondary id.

Wildcards are permitted in placeholder ids (but not regular view ids). '*' matches any substring, '?' matches any single character. Wildcards can be specified for the primary id, the secondary id, or both. For example, the placeholder "someView:*" will match any occurrence of the view that has primary id "someView" and that also has some non-null secondary id. Note that this placeholder will not match the view if it has no secondary id, since the compound id in this case is simply "someView".

Example of populating a layout with standard workbench views:

IPageLayout layout = ...
// Get the editor area.
String editorArea = layout.getEditorArea();

// Top left: Resource Navigator view and Bookmarks view placeholder
IFolderLayout 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 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);

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

Definition at line 83 of file berryIPageLayout.h.

Member Function Documentation

◆ AddPerspectiveShortcut()

virtual void berry::IPageLayout::AddPerspectiveShortcut ( const QString & id )

pure virtual

Adds a perspective shortcut to the page layout. These are typically shown in the UI to allow rapid navigation to appropriate new wizards. For example, in the Eclipse IDE, these appear as items under the Window > Open Perspective menu. The id must name a perspective extension contributed to the workbench's perspectives extension point (named "org.blueberry.ui.perspectives").

Parameters

id	the perspective id

◆ AddPlaceholder()

virtual void berry::IPageLayout::AddPlaceholder	(	const QString &	viewId,
		int	relationship,
		float	ratio,
		const QString &	refId
	)

pure virtual

Adds a view placeholder to this page layout. A view placeholder is used to define the position of a view before the view appears. Initially, it is invisible; however, if the user ever opens a view whose compound id matches the placeholder, the view will appear at the same location as the placeholder. See the IPageLayout type documentation for more details about compound ids. If the placeholder contains wildcards, it remains in the layout, otherwise it is replaced by the view. If the primary id of the placeholder has no wildcards, it must refer to a view contributed to the workbench's view extension point (named "org.blueberry.ui.views").

Parameters

viewId	the compound view id (wildcards allowed)
relationship	the position relative to the reference part; one of `TOP`, `BOTTOM`, `LEFT`, or `RIGHT`
ratio	a ratio specifying how to divide the space currently occupied by the reference part, in the range `0.05f` to `0.95f`. Values outside this range will be clipped to facilitate direct manipulation. For a vertical split, the part on top gets the specified ratio of the current space and the part on bottom gets the rest. Likewise, for a horizontal split, the part at left gets the specified ratio of the current space and the part at right gets the rest.
refId	the id of the reference part; either a view id, a folder id, or the special editor area id returned by `getEditorArea`

◆ AddShowInPart()

virtual void berry::IPageLayout::AddShowInPart ( const QString & id )

pure virtual

Adds an item to the Show In prompter. The id must name a view contributed to the workbench's view extension point (named "org.blueberry.ui.views").

Parameters

id	the view id

Since: 2.1

◆ AddShowViewShortcut()

virtual void berry::IPageLayout::AddShowViewShortcut ( const QString & id )

pure virtual

Adds a show view shortcut to the page layout. These are typically shown in the UI to allow rapid navigation to appropriate views. For example, in the Eclipse IDE, these appear as items under the Window > Show View menu. The id must name a view contributed to the workbench's views extension point (named "org.blueberry.ui.views").

Parameters

id	the view id

◆ AddStandaloneView()

virtual void berry::IPageLayout::AddStandaloneView	(	const QString &	viewId,
		bool	showTitle,
		int	relationship,
		float	ratio,
		const QString &	refId
	)

pure virtual

Adds a standalone view with the given compound id to this page layout. See the IPageLayout type documentation for more details about compound ids. A standalone view cannot be docked together with other views. A standalone view's title can optionally be hidden. If hidden, then any controls typically shown with the title (such as the close button) are also hidden. Any contributions or other content from the view itself are always shown (e.g. toolbar or view menu contributions, content description).

The id must name a view contributed to the workbench's view extension point (named "org.blueberry.ui.views").

Parameters

viewId	the compound view id
showTitle	`true` to show the title and related controls, `false` to hide them
relationship	the position relative to the reference part; one of `TOP`, `BOTTOM`, `LEFT`, or `RIGHT`
ratio	a ratio specifying how to divide the space currently occupied by the reference part, in the range `0.05f` to `0.95f`. Values outside this range will be clipped to facilitate direct manipulation. For a vertical split, the part on top gets the specified ratio of the current space and the part on bottom gets the rest. Likewise, for a horizontal split, the part at left gets the specified ratio of the current space and the part at right gets the rest.
refId	the id of the reference part; either a view id, a folder id, or the special editor area id returned by `getEditorArea`

Since: 3.0

◆ AddStandaloneViewPlaceholder()

virtual void berry::IPageLayout::AddStandaloneViewPlaceholder	(	const QString &	viewId,
		int	relationship,
		float	ratio,
		const QString &	refId,
		bool	showTitle
	)

pure virtual

Adds a standalone view placeholder to this page layout. A view placeholder is used to define the position of a view before the view appears. Initially, it is invisible; however, if the user ever opens a view whose compound id matches the placeholder, the view will appear at the same location as the placeholder. See the IPageLayout type documentation for more details about compound ids. If the placeholder contains wildcards, it remains in the layout, otherwise it is replaced by the view. If the primary id of the placeholder has no wildcards, it must refer to a view contributed to the workbench's view extension point (named "org.blueberry.ui.views").

Parameters

viewId	the compound view id (wildcards allowed)
relationship	the position relative to the reference part; one of `TOP`, `BOTTOM`, `LEFT`, or `RIGHT`
ratio	a ratio specifying how to divide the space currently occupied by the reference part, in the range `0.05f` to `0.95f`. Values outside this range will be clipped to facilitate direct manipulation. For a vertical split, the part on top gets the specified ratio of the current space and the part on bottom gets the rest. Likewise, for a horizontal split, the part at left gets the specified ratio of the current space and the part at right gets the rest.
refId	the id of the reference part; either a view id, a folder id, or the special editor area id returned by `getEditorArea`
showTitle	true to show the view's title, false if not

Since: 3.2

◆ AddView()

virtual void berry::IPageLayout::AddView	(	const QString &	viewId,
		int	relationship,
		float	ratio,
		const QString &	refId
	)

pure virtual

Adds a view with the given compound id to this page layout. See the IPageLayout type documentation for more details about compound ids. The primary id must name a view contributed to the workbench's view extension point (named "org.blueberry.ui.views").

Parameters

viewId	the compound view id
relationship	the position relative to the reference part; one of `TOP`, `BOTTOM`, `LEFT`, or `RIGHT`
ratio	a ratio specifying how to divide the space currently occupied by the reference part, in the range `0.05f` to `0.95f`. Values outside this range will be clipped to facilitate direct manipulation. For a vertical split, the part on top gets the specified ratio of the current space and the part on bottom gets the rest. Likewise, for a horizontal split, the part at left gets the specified ratio of the current space and the part at right gets the rest.
refId	the id of the reference part; either a view id, a folder id, or the special editor area id returned by `getEditorArea`

◆ berryObjectMacro()

berry::IPageLayout::berryObjectMacro ( berry::IPageLayout )

◆ CreateFolder()

virtual IFolderLayout::Pointer berry::IPageLayout::CreateFolder	(	const QString &	folderId,
		int	relationship,
		float	ratio,
		const QString &	refId
	)

pure virtual

Creates and adds a new folder with the given id to this page layout. The position and relative size of the folder is expressed relative to a reference part.

Parameters

folderId	the id for the new folder. This must be unique within the layout to avoid collision with other parts.
relationship	the position relative to the reference part; one of `TOP`, `BOTTOM`, `LEFT`, or `RIGHT`
ratio	a ratio specifying how to divide the space currently occupied by the reference part, in the range `0.05f` to `0.95f`. Values outside this range will be clipped to facilitate direct manipulation. For a vertical split, the part on top gets the specified ratio of the current space and the part on bottom gets the rest. Likewise, for a horizontal split, the part at left gets the specified ratio of the current space and the part at right gets the rest.
refId	the id of the reference part; either a view id, a folder id, or the special editor area id returned by `getEditorArea`

Returns: the new folder

◆ CreatePlaceholderFolder()

virtual IPlaceholderFolderLayout::Pointer berry::IPageLayout::CreatePlaceholderFolder	(	const QString &	folderId,
		int	relationship,
		float	ratio,
		const QString &	refId
	)

pure virtual

Creates and adds a placeholder for a new folder with the given id to this page layout. The position and relative size of the folder is expressed relative to a reference part.

Parameters

folderId	the id for the new folder. This must be unique within the layout to avoid collision with other parts.
relationship	the position relative to the reference part; one of `TOP`, `BOTTOM`, `LEFT`, or `RIGHT`
ratio	a ratio specifying how to divide the space currently occupied by the reference part, in the range `0.05f` to `0.95f`. Values outside this range will be clipped to facilitate direct manipulation. For a vertical split, the part on top gets the specified ratio of the current space and the part on bottom gets the rest. Likewise, for a horizontal split, the part at left gets the specified ratio of the current space and the part at right gets the rest.
refId	the id of the reference part; either a view id, a folder id, or the special editor area id returned by `getEditorArea`

Returns: a placeholder for the new folder

Since: 2.0

◆ GetDescriptor()

virtual IPerspectiveDescriptor::Pointer berry::IPageLayout::GetDescriptor ( )

pure virtual

Returns the perspective descriptor for the perspective being layed out.

Returns: the perspective descriptor for the perspective being layed out

Since: 3.2

◆ GetEditorArea()

virtual QString berry::IPageLayout::GetEditorArea ( )

pure virtual

Returns the special identifier for the editor area in this page layout. The identifier for the editor area is also stored in ID_EDITOR_AREA.

The editor area is automatically added to each layout before anything else. It should be used as the point of reference when adding views to a layout.

Returns: the special id of the editor area

◆ GetFolderForView()

virtual IPlaceholderFolderLayout::Pointer berry::IPageLayout::GetFolderForView ( const QString & id )

pure virtual

Returns the folder layout for the view or placeholder with the given compound id in this page layout. See the IPageLayout type documentation for more details about compound ids. Returns null if the specified view or placeholder is unknown to the layout, or the placeholder was not in a folder.

Parameters

id	the compound view id or placeholder. Must not be `null`.

Returns: the folder layout, or null

Since: 3.3

◆ GetViewLayout()

virtual IViewLayout::Pointer berry::IPageLayout::GetViewLayout ( const QString & id )

pure virtual

Returns the layout for the view or placeholder with the given compound id in this page layout. See the IPageLayout type documentation for more details about compound ids. Returns null if the specified view or placeholder is unknown to the layout.

Parameters

id	the compound view id or placeholder

Returns: the view layout, or null

Since: 3.0

◆ IsEditorAreaVisible()

virtual bool berry::IPageLayout::IsEditorAreaVisible ( )

pure virtual

Returns whether the page's layout will show the editor area.

Returns: true when editor area visible, false otherwise

◆ IsFixed()

virtual bool berry::IPageLayout::IsFixed ( )

pure virtual

Returns true if this layout is fixed, false if not. In a fixed layout, layout parts cannot be moved or zoomed, and the initial set of views cannot be closed. The default is false.

Returns: true if this layout is fixed, false if not.

Since: 3.0

◆ SetEditorAreaVisible()

virtual void berry::IPageLayout::SetEditorAreaVisible ( bool showEditorArea )

pure virtual

Show or hide the editor area for the page's layout.

Parameters

showEditorArea true to show the editor area, false to hide the editor area

◆ SetFixed()

virtual void berry::IPageLayout::SetFixed ( bool isFixed )

pure virtual

Sets whether this layout is fixed. In a fixed layout, layout parts cannot be moved or zoomed, and the initial set of views cannot be closed.

Parameters

isFixed true if this layout is fixed, false if not

Since: 3.0

Member Data Documentation

◆ BOTTOM

const int berry::IPageLayout::BOTTOM

static

Relationship constant indicating a part should be placed below its relative.

Definition at line 160 of file berryIPageLayout.h.

◆ DEFAULT_VIEW_RATIO

const float berry::IPageLayout::DEFAULT_VIEW_RATIO

static

The default view ratio width for regular (non-fast) views.

Since: 2.0

Definition at line 178 of file berryIPageLayout.h.

◆ ID_BOOKMARKS

const QString berry::IPageLayout::ID_BOOKMARKS

static

The view id for the workbench's Bookmark Navigator standard component.

Definition at line 112 of file berryIPageLayout.h.

◆ ID_EDITOR_AREA

const QString berry::IPageLayout::ID_EDITOR_AREA

static

The part id for the workbench's editor area. This may only be used as a reference part for view addition.

Definition at line 92 of file berryIPageLayout.h.

◆ ID_NAVIGATE_ACTION_SET

const QString berry::IPageLayout::ID_NAVIGATE_ACTION_SET

static

Id of the navigate action set. (value "org.blueberry.ui.NavigateActionSet")

Since: 2.1

Definition at line 136 of file berryIPageLayout.h.

◆ ID_OUTLINE

const QString berry::IPageLayout::ID_OUTLINE

static

The view id for the workbench's Content Outline standard component.

Definition at line 107 of file berryIPageLayout.h.

◆ ID_PROBLEM_VIEW

const QString berry::IPageLayout::ID_PROBLEM_VIEW

static

The view id for the workbench's Problems View standard component.

Since: 3.0

Definition at line 118 of file berryIPageLayout.h.

◆ ID_PROGRESS_VIEW

const QString berry::IPageLayout::ID_PROGRESS_VIEW

static

The view id for the workbench's Progress View standard component.

Since: 3.2

Definition at line 124 of file berryIPageLayout.h.

◆ ID_PROP_SHEET

const QString berry::IPageLayout::ID_PROP_SHEET

static

The view id for the workbench's Property Sheet standard component.

Definition at line 102 of file berryIPageLayout.h.

◆ ID_RES_NAV

const QString berry::IPageLayout::ID_RES_NAV

static

The view id for the workbench's Resource Navigator standard component.

Definition at line 97 of file berryIPageLayout.h.

◆ ID_TASK_LIST

const QString berry::IPageLayout::ID_TASK_LIST

static

The view id for the workbench's Task List standard component.

Definition at line 129 of file berryIPageLayout.h.

◆ INVALID_RATIO

const float berry::IPageLayout::INVALID_RATIO

static

A variable used to represent invalid ratios.

Since: 2.0

Definition at line 184 of file berryIPageLayout.h.

◆ LEFT

const int berry::IPageLayout::LEFT

static

Relationship constant indicating a part should be placed to the left of its relative.

Definition at line 142 of file berryIPageLayout.h.

◆ nullptr_RATIO

const float berry::IPageLayout::nullptr_RATIO

static

A variable used to represent a ratio which has not been specified.

Since: 2.0

Definition at line 190 of file berryIPageLayout.h.

◆ RATIO_MAX

const float berry::IPageLayout::RATIO_MAX

static

Maximum acceptable ratio value when adding a view

Since: 2.0

Definition at line 172 of file berryIPageLayout.h.

◆ RATIO_MIN

const float berry::IPageLayout::RATIO_MIN

static

Minimum acceptable ratio value when adding a view

Since: 2.0

Definition at line 166 of file berryIPageLayout.h.

◆ RIGHT

const int berry::IPageLayout::RIGHT

static

Relationship constant indicating a part should be placed to the right of its relative.

Definition at line 148 of file berryIPageLayout.h.

◆ TOP

const int berry::IPageLayout::TOP

static

Relationship constant indicating a part should be placed above its relative.

Definition at line 154 of file berryIPageLayout.h.

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

berryIPageLayout.h

Public Member Functions

Static Public Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ AddPerspectiveShortcut()

◆ AddPlaceholder()

◆ AddShowInPart()

◆ AddShowViewShortcut()

◆ AddStandaloneView()

◆ AddStandaloneViewPlaceholder()

◆ AddView()

◆ berryObjectMacro()

◆ CreateFolder()

◆ CreatePlaceholderFolder()

◆ GetDescriptor()

◆ GetEditorArea()

◆ GetFolderForView()

◆ GetViewLayout()

◆ IsEditorAreaVisible()

◆ IsFixed()

◆ SetEditorAreaVisible()

◆ SetFixed()

Member Data Documentation

◆ BOTTOM

◆ DEFAULT_VIEW_RATIO

◆ ID_BOOKMARKS

◆ ID_EDITOR_AREA

◆ ID_NAVIGATE_ACTION_SET

◆ ID_OUTLINE

◆ ID_PROBLEM_VIEW

◆ ID_PROGRESS_VIEW

◆ ID_PROP_SHEET

◆ ID_RES_NAV

◆ ID_TASK_LIST

◆ INVALID_RATIO

◆ LEFT

◆ nullptr_RATIO

◆ RATIO_MAX

◆ RATIO_MIN

◆ RIGHT

◆ TOP