public class FileEditorInput extends Object implements IFileEditorInput, IPathEditorInput, IPersistableElement
This class may be instantiated; it is not intended to be subclassed.
| Constructor and Description |
|---|
FileEditorInput(IFile file)
Creates an editor input based of the given file resource.
|
| Modifier and Type | Method and Description |
|---|---|
boolean |
equals(Object obj) |
boolean |
exists()
Returns whether the editor input exists.
|
Object |
getAdapter(Class adapter)
Returns an object which is an instance of the given class
associated with this object.
|
String |
getFactoryId()
Returns the id of the element factory which should be used to re-create this
object.
|
IFile |
getFile()
Returns the file resource underlying this editor input.
|
ImageDescriptor |
getImageDescriptor()
Returns the image descriptor for this input.
|
String |
getName()
Returns the name of this editor input for display purposes.
|
IPath |
getPath()
Returns the local file system path of the file underlying this editor input.
|
IPersistableElement |
getPersistable()
Returns an object that can be used to save the state of this editor
input.
|
IStorage |
getStorage()
Returns the underlying IStorage object.
|
String |
getToolTipText()
Returns the tool tip text for this editor input.
|
int |
hashCode() |
void |
saveState(IMemento memento)
Saves the state of the object in the given memento.
|
String |
toString() |
public FileEditorInput(IFile file)
file - the file resourcepublic boolean exists()
IEditorInput
This method is primarily used to determine if an editor input should
appear in the "File Most Recently Used" menu. An editor input will appear
in the list until the return value of exists becomes
false or it drops off the bottom of the list.
exists in interface IEditorInputtrue if the editor input exists;
false otherwisepublic Object getAdapter(Class adapter)
IAdaptablenull if
no such object can be found.getAdapter in interface IAdaptableadapter - the adapter class to look upnull if this object does not
have an adapter for the given classpublic String getFactoryId()
IPersistableElement
Factory ids are declared in extensions to the standard extension point
"org.eclipse.ui.elementFactories".
getFactoryId in interface IPersistableElementIElementFactorypublic IFile getFile()
IFileEditorInput
The IFile returned can be a handle to a resource
that does not exist in the workspace. As such, an editor should
provide appropriate feedback to the user instead of simply failing
during input validation. For example, a text editor could open
in read-only mode with a message in the text area to inform the
user that the file does not exist.
getFile in interface IFileEditorInputpublic ImageDescriptor getImageDescriptor()
IEditorInputNote: although a null return value has never been permitted from this method, there are many known buggy implementations that return null. Clients that need the image for an editor are advised to use IWorkbenchPart.getImage() instead of IEditorInput.getImageDescriptor(), or to recover from a null return value in a manner that records the ID of the problematic editor input. Implementors that have been returning null from this method should pick some other default return value (such as ImageDescriptor.getMissingImageDescriptor()).
getImageDescriptor in interface IEditorInputnull if
there is no image.public String getName()
IEditorInputFor instance, when the input is from a file, the return value would ordinarily be just the file name.
getName in interface IEditorInputnull;public IPersistableElement getPersistable()
IEditorInputgetPersistable in interface IEditorInputnull if this editor
input cannot be persistedpublic IStorage getStorage() throws CoreException
IStorageEditorInputgetStorage in interface IStorageEditorInputCoreException - if this method failspublic String getToolTipText()
IEditorInputgetToolTipText in interface IEditorInputnull.public void saveState(IMemento memento)
IPersistablesaveState in interface IPersistablememento - the storage area for object's statepublic IPath getPath()
IPathEditorInputgetPath in interface IPathEditorInputGuidelines for using Eclipse APIs. Copyright (c) IBM Corp. and others 2000, 2006. All rights reserved.