| org.eclipse.ui.internal.ICompatibleWorkbenchPage
All known Subclasses: org.eclipse.ui.internal.CompatibleWorkbenchPage,
ICompatibleWorkbenchPage | public interface ICompatibleWorkbenchPage (Code) | | Internal interface used in providing increased binary compatibility for
pre-3.0 plug-ins. This declaration masks the empty interface of the same name
declared in the Workbench proper. This interface declares IWorkbenchPage that
existed in 2.1 but were removed in 3.0 because they referenced resource API.
Plug-ins should not refer to this type or its containing fragment from their
class path. It is intended only to provide binary compatibility for pre-3.0
plug-ins, and should not be referenced at development time.
since: 3.0 |
Method Summary | |
public IEditorPart | openEditor(IFile input) Opens an editor on the given file resource.
If this page already has an editor open on the target object that editor
is activated; otherwise, a new editor is opened.
An appropriate editor for the input is determined using a multistep
process.
- The workbench editor registry is consulted to determine if an editor
extension has been registered for the file type.
| public IEditorPart | openEditor(IFile input, String editorId, boolean activate) Opens an editor on the given file resource.
If this page already has an editor open on the target object that editor
is brought to front; otherwise, a new editor is opened. | public IEditorPart | openEditor(IFile input, String editorId) Opens an editor on the given file resource.
If this page already has an editor open on the target object that editor
is activated; otherwise, a new editor is opened.
The editor type is determined by mapping editorId to an
editor extension registered with the workbench. | public IEditorPart | openEditor(IMarker marker) Opens an editor on the file resource of the given marker.
If this page already has an editor open on the target object that editor
is activated; otherwise, a new editor is opened. | public IEditorPart | openEditor(IMarker marker, boolean activate) Opens an editor on the file resource of the given marker.
If this page already has an editor open on the target object that editor
is brought to front; otherwise, a new editor is opened. | public void | openSystemEditor(IFile input) Opens an operating system editor on a given file. |
openEditor | public IEditorPart openEditor(IFile input) throws PartInitException(Code) | | Opens an editor on the given file resource.
If this page already has an editor open on the target object that editor
is activated; otherwise, a new editor is opened.
An appropriate editor for the input is determined using a multistep
process.
- The workbench editor registry is consulted to determine if an editor
extension has been registered for the file type. If so, an instance of
the editor extension is opened on the file. See
IEditorRegistry.getDefaultEditor(IFile) .
- Next, the native operating system will be consulted to determine if
a native editor exists for the file type. If so, a new process is started
and the native editor is opened on the file.
- If all else fails the file will be opened in a default text editor.
Parameters: input - the file to edit an open and active editor, or null if a systemeditor was opened exception: PartInitException - if the editor could not be initialized |
openEditor | public IEditorPart openEditor(IFile input, String editorId, boolean activate) throws PartInitException(Code) | | Opens an editor on the given file resource.
If this page already has an editor open on the target object that editor
is brought to front; otherwise, a new editor is opened. If
activate == true the editor will be activated.
The editor type is determined by mapping editorId to an
editor extension registered with the workbench. An editor id is passed
rather than an editor object to prevent the accidental creation of more
than one editor for the same input. It also guarantees a consistent
lifecycle for editors, regardless of whether they are created by the user
or restored from saved data.
Parameters: input - the file to edit Parameters: editorId - the id of the editor extension to use or null Parameters: activate - if true the editor will be activated an open and active editor exception: PartInitException - if the editor could not be initialized |
openEditor | public IEditorPart openEditor(IFile input, String editorId) throws PartInitException(Code) | | Opens an editor on the given file resource.
If this page already has an editor open on the target object that editor
is activated; otherwise, a new editor is opened.
The editor type is determined by mapping editorId to an
editor extension registered with the workbench. An editor id is passed
rather than an editor object to prevent the accidental creation of more
than one editor for the same input. It also guarantees a consistent
lifecycle for editors, regardless of whether they are created by the user
or restored from saved data.
Parameters: editorId - the id of the editor extension to use Parameters: input - the file to edit an open and active editor exception: PartInitException - if the editor could not be initialized |
openEditor | public IEditorPart openEditor(IMarker marker) throws PartInitException(Code) | | Opens an editor on the file resource of the given marker.
If this page already has an editor open on the target object that editor
is activated; otherwise, a new editor is opened. The cursor and selection
state of the editor is then updated from information recorded in the
marker.
If the marker contains an EDITOR_ID_ATTR attribute the
attribute value will be used to determine the editor type to be opened.
If not, the registered editor for the marker resource will be used.
Parameters: marker - the marker to open an open and active editor, or null if a system editor was opened exception: PartInitException - if the editor could not be initialized See Also: IEditorPart.gotoMarker |
openEditor | public IEditorPart openEditor(IMarker marker, boolean activate) throws PartInitException(Code) | | Opens an editor on the file resource of the given marker.
If this page already has an editor open on the target object that editor
is brought to front; otherwise, a new editor is opened. If
activate == true the editor will be activated. The cursor
and selection state of the editor are then updated from information
recorded in the marker.
If the marker contains an EDITOR_ID_ATTR attribute the
attribute value will be used to determine the editor type to be opened.
If not, the registered editor for the marker resource will be used.
Parameters: marker - the marker to open Parameters: activate - if true the editor will be activated an open editor, or null if a system editor was opened exception: PartInitException - if the editor could not be initialized See Also: IEditorPart.gotoMarker |
openSystemEditor | public void openSystemEditor(IFile input) throws PartInitException(Code) | | Opens an operating system editor on a given file. Once open, the
workbench has no knowledge of the editor or the state of the file being
edited. Users are expected to perform a "Local Refresh" from the
workbench user interface.
Parameters: input - the file to edit exception: PartInitException - if the editor could not be opened. |
|
|