Package org.eclipse.ui.actions

Class OpenNewPageMenu

java.lang.Object

org.eclipse.jface.action.ContributionItem

org.eclipse.ui.actions.PerspectiveMenu

org.eclipse.ui.actions.OpenNewPageMenu

All Implemented Interfaces:

IContributionItem

@Deprecated
public class OpenNewPageMenu
extends PerspectiveMenu

Deprecated.

Workbench no longer exposes the concept of "pages" in the user ui model. See IWorkbench.showPerspective methods.

A menu for page creation in the workbench.

An OpenNewPageMenu is used to populate a menu with "Open Page" actions. One item is added for each shortcut perspective, as defined by the product ini. If the user selects one of these items a new page is created in the workbench with the given perspective.

The visible perspectives within the menu may also be updated dynamically to reflect user preference.

The input for the page is determined by the value of pageInput. The input should be passed into the constructor of this class or set using the setPageInput method.

This class may be instantiated; it is not intended to be subclassed.

Restriction:

This class is not intended to be subclassed by clients.

Field Summary

Fields inherited from class org.eclipse.ui.actions.PerspectiveMenu

SHOW_PERSP_ID

Constructor Summary

Constructors

Constructor	Description
OpenNewPageMenu(IWorkbenchWindow window)	Deprecated. Constructs a new instance of OpenNewPageMenu.
OpenNewPageMenu(IWorkbenchWindow window, IAdaptable input)	Deprecated. Constructs a new instance of OpenNewPageMenu.

Method Summary

Modifier and Type	Method	Description
protected void	run(IPerspectiveDescriptor desc)	Deprecated. Runs an action for a particular perspective.
void	setPageInput(IAdaptable input)	Deprecated. Sets the page input.

Methods inherited from class org.eclipse.ui.actions.PerspectiveMenu

dispose, fill, getPerspectiveItems, getShowActive, getWindow, isDirty, isDynamic, run, showActive

Methods inherited from class org.eclipse.jface.action.ContributionItem

fill, fill, fill, getId, getParent, isEnabled, isGroupMarker, isSeparator, isVisible, saveWidgetState, setId, setParent, setVisible, toString, update, update

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

OpenNewPageMenu

public OpenNewPageMenu(IWorkbenchWindow window)

Deprecated.

Constructs a new instance of OpenNewPageMenu.

If this method is used be sure to set the page input by invoking setPageInput. The page input is required when the user selects an item in the menu. At that point the menu will attempt to open a new page with the selected perspective and page input. If there is no page input an error dialog will be opened.

Parameters:

window - the window where a new page is created if an item within the menu is selected

OpenNewPageMenu

public OpenNewPageMenu(IWorkbenchWindow window,
                       IAdaptable input)

Deprecated.

Constructs a new instance of OpenNewPageMenu.

Parameters:

window - the window where a new page is created if an item within the menu is selected

input - the page input

Method Detail

run

protected void run(IPerspectiveDescriptor desc)

Deprecated.

Description copied from class: PerspectiveMenu

Runs an action for a particular perspective. The behavior of the action is defined by the subclass.

Specified by:

run in class PerspectiveMenu

Parameters:

desc - the selected perspective

setPageInput

public void setPageInput(IAdaptable input)

Deprecated.

Sets the page input.

Parameters:

input - the page input