Eclipse Platform
Release 3.1

org.eclipse.ui
Interface IEditorSite

All Superinterfaces:
IAdaptable, IShellProvider, IWorkbenchPartSite, IWorkbenchSite
All Known Implementing Classes:
MultiPageEditorSite

public interface IEditorSite
extends IWorkbenchPartSite

The primary interface between an editor part and the workbench.

The workbench exposes its implemention of editor part sites via this interface, which is not intended to be implemented or extended by clients.


Method Summary
 IEditorActionBarContributor getActionBarContributor()
          Returns the action bar contributor for this editor.
 IActionBars getActionBars()
          Returns the action bars for this part site.
 void registerContextMenu(MenuManager menuManager, ISelectionProvider selectionProvider, boolean includeEditorInput)
           Registers a pop-up menu with the default id for extension.
 void registerContextMenu(String menuId, MenuManager menuManager, ISelectionProvider selectionProvider, boolean includeEditorInput)
           Registers a pop-up menu with a particular id for extension.
 
Methods inherited from interface org.eclipse.ui.IWorkbenchPartSite
getId, getKeyBindingService, getPart, getPluginId, getRegisteredName, registerContextMenu, registerContextMenu
 
Methods inherited from interface org.eclipse.ui.IWorkbenchSite
getPage, getSelectionProvider, getShell, getWorkbenchWindow, setSelectionProvider
 
Methods inherited from interface org.eclipse.core.runtime.IAdaptable
getAdapter
 

Method Detail

getActionBarContributor

public IEditorActionBarContributor getActionBarContributor()
Returns the action bar contributor for this editor.

An action contributor is responsable for the creation of actions. By design, this contributor is used for one or more editors of the same type. Thus, the contributor returned by this method is not owned completely by the editor - it is shared.

Returns:
the editor action bar contributor, or null if none exists

getActionBars

public IActionBars getActionBars()
Returns the action bars for this part site. Editors of the same type share the same action bars. Contributions to the action bars are done by the IEditorActionBarContributor.

Returns:
the action bars
Since:
2.1

registerContextMenu

public void registerContextMenu(MenuManager menuManager,
                                ISelectionProvider selectionProvider,
                                boolean includeEditorInput)

Registers a pop-up menu with the default id for extension. The default id is defined as the part id.

By default, context menus include object contributions based on the editor input for the current editor. It is possible to override this behaviour by calling this method with includeEditorInput as false. This might be desirable for editors that present a localized view of an editor input (e.g., a node in a model editor).

For a detailed description of context menu registration see IWorkbenchPartSite.registerContextMenu(MenuManager, ISelectionProvider)

Parameters:
menuManager - the menu manager; must not be null.
selectionProvider - the selection provider; must not be null.
includeEditorInput - Whether the editor input should be included when adding object contributions to this context menu.
Since:
3.1
See Also:
IWorkbenchPartSite.registerContextMenu(MenuManager, ISelectionProvider)

registerContextMenu

public void registerContextMenu(String menuId,
                                MenuManager menuManager,
                                ISelectionProvider selectionProvider,
                                boolean includeEditorInput)

Registers a pop-up menu with a particular id for extension. This method should only be called if the target part has more than one context menu to register.

By default, context menus include object contributions based on the editor input for the current editor. It is possible to override this behaviour by calling this method with includeEditorInput as false. This might be desirable for editors that present a localized view of an editor input (e.g., a node in a model editor).

For a detailed description of context menu registration see IWorkbenchPartSite.registerContextMenu(MenuManager, ISelectionProvider)

Parameters:
menuId - the menu id; must not be null.
menuManager - the menu manager; must not be null.
selectionProvider - the selection provider; must not be null.
includeEditorInput - Whether the editor input should be included when adding object contributions to this context menu.
Since:
3.1
See Also:
IWorkbenchPartSite.registerContextMenu(MenuManager, ISelectionProvider)

Eclipse Platform
Release 3.1

Guidelines for using Eclipse APIs.

Copyright (c) IBM Corp. and others 2000, 2005. All rights reserved.