An editor can be defined by an extension to the workbench.
The user manually associates an editor with a given resource extension
type. This will override any default workbench or platform association.
The registry does not keep track of editors that are "implicitly" determined.
For example a bitmap (.bmp) file will typically not have a
registered editor. Instead, when no registered editor is found, the
underlying OS is consulted.
This interface is not intended to be implemented by clients.
getEditors(String fileName, IContentType contentType) Returns the list of file editors registered to work against the file with
the given file name and with the given content type.
setDefaultEditor(String fileNameOrExtension, String editorId) Sets the default editor id for the files that match that
specified file name or extension.
The property identifier for the contents of this registry.
SYSTEM_EXTERNAL_EDITOR_ID
final public static String SYSTEM_EXTERNAL_EDITOR_ID(Code)
The identifier for the system external editor descriptor. This descriptor
is always present in the registry on all platforms.
This editor requires an input which implements
org.eclipse.ui.IPathEditorInput IPathEditorInput .
Use
IEditorRegistry.findEditor findEditor to access the editor descriptor for
this identifier.
since: 3.0
SYSTEM_INPLACE_EDITOR_ID
final public static String SYSTEM_INPLACE_EDITOR_ID(Code)
The identifier for the system in-place editor descriptor. This descriptor
is only present in the registry on platforms that support in-place editing
(for example Win32). This editor requires an input which implements
org.eclipse.ui.IInPlaceEditorInput IInPlaceEditorInput . Use
IEditorRegistry.findEditor findEditor to access the editor descriptor for this
identifier.
since: 3.0
Finds and returns the descriptor of the editor with the given editor id.
Parameters: editorId - the editor id the editor descriptor with the given id, or null if notfound
Returns the default editor for a given file name and with the given content type.
The default editor is determined by taking the file extension for the
file and obtaining the default editor for that extension.
Parameters: fileName - the file name in the system Parameters: contentType - the content type or null for the unknown content type the descriptor of the default editor, or null if notfound since: 3.1
Returns the list of file editors registered to work against the file with
the given file name. This method assumes an unknown content type for the
given file.
Note: Use getDefaultEditor(String) if you only the need
the default editor rather than all candidate editors.
Parameters: fileName - the file name in the system a list of editor descriptors
Returns the list of file editors registered to work against the file with
the given file name and with the given content type.
Note: Use getDefaultEditor(String) if you only the need
the default editor rather than all candidate editors.
Parameters: fileName - the file name in the system Parameters: contentType - the content type or null for the unknowncontent type a list of editor descriptors since: 3.1
Returns a list of mappings from file type to editor. The resulting list
is sorted in ascending order by file extension.
Each mapping defines an extension and the set of editors that are
available for that type. The set of editors includes those registered
via plug-ins and those explicitly associated with a type by the user
in the workbench preference pages.
a list of mappings sorted alphabetically by extension
getImageDescriptor
public ImageDescriptor getImageDescriptor(String filename)(Code)
Returns the image descriptor associated with a given file. This image is
usually displayed next to the given file. This method assumes an unknown
content type for the given file.
The image is determined by taking the file extension of the file and
obtaining the image for the default editor associated with that
extension. A default image is returned if no default editor is available.
Parameters: filename - the file name in the system the descriptor of the image to display next to the file
getImageDescriptor
public ImageDescriptor getImageDescriptor(String filename, IContentType contentType)(Code)
Returns the image descriptor associated with a given file. This image is
usually displayed next to the given file.
The image is determined by taking the file extension of the file and
obtaining the image for the default editor associated with that
extension. A default image is returned if no default editor is available.
Parameters: filename - the file name in the system Parameters: contentType - the content type of the file or null for theunknown content type the descriptor of the image to display next to the file since: 3.1
getSystemExternalEditorImageDescriptor
public ImageDescriptor getSystemExternalEditorImageDescriptor(String filename)(Code)
Returns the image descriptor associated with the system editor that
would be used to edit this file externally.
Parameters: filename - the file name the descriptor of the external editor image, or nullif none since: 3.0
isSystemExternalEditorAvailable
public boolean isSystemExternalEditorAvailable(String filename)(Code)
Returns whether the system has an editor that could handle a file
with the given name.
Parameters: filename - the file name true if an external editor available, andfalse otherwise since: 3.0
isSystemInPlaceEditorAvailable
public boolean isSystemInPlaceEditorAvailable(String filename)(Code)
Returns whether there is an in-place editor that could handle a file
with the given name.
Parameters: filename - the file name true if an in-place editor is available, andfalse otherwise since: 3.0
Removes the given property listener from this registry.
Has no affect if an identical listener is not registered.
Parameters: listener - a property listener
setDefaultEditor
public void setDefaultEditor(String fileNameOrExtension, String editorId)(Code)
Sets the default editor id for the files that match that
specified file name or extension. The specified editor must be
defined as an editor for that file name or extension.
Parameters: fileNameOrExtension - the file name or extension pattern (e.g. "*.xml"); Parameters: editorId - the editor id or null for no default