org.eclipse.ui
Interface IFileEditorMapping

public interface IFileEditorMapping

An association between a file name/extension and a list of known editors for files of that type.

The name and extension can never empty or null. The name may contain the single wild card character (*) to indicate the editor applies to all files with the same extension (e.g. *.doc). The name can never embed the wild card character within itself (i.e. rep*)

This interface is not intended to be implemented by clients.

See Also:

IEditorRegistry.getFileEditorMappings()

Method Summary

IEditorDescriptor	getDefaultEditor() Returns the default editor registered for this type mapping.
IEditorDescriptor[]	getDeletedEditors() Returns the list of editors formerly registered for this type mapping which have since been deleted.
IEditorDescriptor[]	getEditors() Returns the list of editors registered for this type mapping.
String	getExtension() Returns the file's extension for this type mapping.
ImageDescriptor	getImageDescriptor() Returns the descriptor of the image to use for a file of this type.
String	getLabel() Returns the label to use for this mapping.
String	getName() Returns the file's name for this type mapping.

Method Detail

getDefaultEditor

public IEditorDescriptor getDefaultEditor()

Returns the default editor registered for this type mapping.

Returns:

the descriptor of the default editor, or null if there is no default editor registered

getEditors

public IEditorDescriptor[] getEditors()

Returns the list of editors registered for this type mapping.

Returns:

a possibly empty list of editors

getDeletedEditors

public IEditorDescriptor[] getDeletedEditors()

Returns the list of editors formerly registered for this type mapping which have since been deleted.

Returns:

a possibly empty list of editors

getExtension

public String getExtension()

Returns the file's extension for this type mapping.

Returns:

the extension for this mapping

getImageDescriptor

public ImageDescriptor getImageDescriptor()

Returns the descriptor of the image to use for a file of this type.

The image is obtained from the default editor. A default file image is returned if no default editor is available.

Returns:

the descriptor of the image to use for a resource of this type

getLabel

public String getLabel()

Returns the label to use for this mapping. Labels have the form "name.extension".

Returns:

the label to use for this mapping

getName

public String getName()

Returns the file's name for this type mapping.

Returns:

the name for this mapping