|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.eclipse.jface.action.Action
org.eclipse.ui.texteditor.ResourceAction
org.eclipse.ui.texteditor.TextEditorAction
Skeleton of a standard text editor action. The action is
initially associated with a text editor via the constructor,
but can subsequently be changed using setEditor
.
Subclasses must implement the run
method and if
required override the update
method.
Subclasses that may modify the editor content should use canModifyEditor()
in their update
code to check whether updating the editor is most
likely possible (even if it is read-only - this may change for editor contents
that are under version control) and validateEditorInputState()
before
actually modifying the editor contents.
Field Summary |
---|
Fields inherited from interface org.eclipse.jface.action.IAction |
---|
AS_CHECK_BOX, AS_DROP_DOWN_MENU, AS_PUSH_BUTTON, AS_RADIO_BUTTON, AS_UNSPECIFIED, CHECKED, DESCRIPTION, ENABLED, HANDLED, IMAGE, RESULT, TEXT, TOOL_TIP_TEXT |
Constructor Summary | |
---|---|
protected |
TextEditorAction(ResourceBundle bundle,
String prefix,
ITextEditor editor)
Creates and initializes the action for the given text editor. |
protected |
TextEditorAction(ResourceBundle bundle,
String prefix,
ITextEditor editor,
int style)
Creates and initializes the action for the given text editor. |
Method Summary | |
---|---|
protected boolean |
canModifyEditor()
Checks the editor's modifiable state. |
protected ITextEditor |
getTextEditor()
Returns the action's text editor. |
void |
setEditor(ITextEditor editor)
Retargets this action to the given editor. |
void |
update()
Always enables this action if it is connected to a text editor. |
protected boolean |
validateEditorInputState()
Checks and validates the editor's modifiable state. |
Methods inherited from class org.eclipse.ui.texteditor.ResourceAction |
---|
getString, initialize, setHelpContextId |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
protected TextEditorAction(ResourceBundle bundle, String prefix, ITextEditor editor)
bundle
- the resource bundleprefix
- a prefix to be prepended to the various resource keys
(described in ResourceAction
constructor), or
null
if noneeditor
- the text editorResourceAction.ResourceAction(ResourceBundle, String)
protected TextEditorAction(ResourceBundle bundle, String prefix, ITextEditor editor, int style)
bundle
- the resource bundleprefix
- a prefix to be prepended to the various resource keys
(described in ResourceAction
constructor), or
null
if noneeditor
- the text editorstyle
- the style of this actionResourceAction.ResourceAction(ResourceBundle, String, int)
Method Detail |
protected ITextEditor getTextEditor()
public void setEditor(ITextEditor editor)
editor
- the new editor, or null
if nonepublic void update()
null
, the action is disabled.
Subclasses may override.
update
in interface IUpdate
protected boolean canModifyEditor()
true
if the editor can be modified,
taking in account the possible editor extensions.
If the editor implements ITextEditorExtension2
,
this method returns ITextEditorExtension2.isEditorInputModifiable()
;
else if the editor
implements ITextEditorExtension2
, it returns ITextEditorExtension.isEditorInputReadOnly()
;
else, ITextEditor.isEditable()
is returned, or false
if the editor is null
.
There is only a difference to validateEditorInputState()
if the editor implements
ITextEditorExtension2
.
true
if a modifying action should be enabled, false
otherwiseprotected boolean validateEditorInputState()
true
if an action
can proceed modifying the editor's input, false
if it should not.
If the editor implements ITextEditorExtension2
,
this method returns ITextEditorExtension2.validateEditorInputState()
;
else if the editor
implements ITextEditorExtension
, it returns ITextEditorExtension.isEditorInputReadOnly()
;
else, ITextEditor.isEditable()
is returned, or false
if the editor is null
.
There is only a difference to canModifyEditor()
if the editor implements
ITextEditorExtension2
.
true
if a modifying action can proceed to modify the underlying document, false
otherwise
|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) IBM Corp. and others 2000, 2005. All rights reserved.