Package org.eclipse.jface.viewers
Class TextCellEditor
- java.lang.Object
-
- org.eclipse.jface.viewers.CellEditor
-
- org.eclipse.jface.viewers.TextCellEditor
-
public class TextCellEditor extends CellEditor
A cell editor that manages a text entry field. The cell editor's value is the text string itself.This class may be instantiated or subclassed.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class org.eclipse.jface.viewers.CellEditor
CellEditor.LayoutData
-
-
Constructor Summary
Constructors Constructor Description TextCellEditor()
Creates a new text string cell editor with no control The cell editor value is the string itself, which is initially the empty string.TextCellEditor(Composite parent)
Creates a new text string cell editor parented under the given control.TextCellEditor(Composite parent, int style)
Creates a new text string cell editor parented under the given control.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected Control
createControl(Composite parent)
Creates the control for this cell editor under the given parent control.protected boolean
dependsOnExternalFocusListener()
This implementation ofCellEditor.dependsOnExternalFocusListener()
returns false if the current instance's class is TextCellEditor, and true otherwise.protected Object
doGetValue()
TheTextCellEditor
implementation of thisCellEditor
framework method returns the text string.protected void
doSetFocus()
Sets the focus to the cell editor's control.protected void
doSetValue(Object value)
TheTextCellEditor
implementation of thisCellEditor
framework method accepts a text string (typeString
).protected void
editOccured(ModifyEvent e)
Processes a modify event that occurred in this text cell editor.CellEditor.LayoutData
getLayoutData()
Since a text editor field is scrollable we don't set a minimumSize.protected void
handleDefaultSelection(SelectionEvent event)
Handles a default selection event from the text control by applying the editor value and deactivating this cell editor.boolean
isCopyEnabled()
TheTextCellEditor
implementation of thisCellEditor
method returnstrue
if the current selection is not empty.boolean
isCutEnabled()
TheTextCellEditor
implementation of thisCellEditor
method returnstrue
if the current selection is not empty.boolean
isDeleteEnabled()
TheTextCellEditor
implementation of thisCellEditor
method returnstrue
if there is a selection or if the caret is not positioned at the end of the text.boolean
isPasteEnabled()
TheTextCellEditor
implementation of thisCellEditor
method always returnstrue
.boolean
isSaveAllEnabled()
Check if save all is enabledboolean
isSelectAllEnabled()
Returnstrue
if this cell editor is able to perform the select all action.protected void
keyReleaseOccured(KeyEvent keyEvent)
Processes a key release event that occurred in this cell editor.void
performCopy()
TheTextCellEditor
implementation of thisCellEditor
method copies the current selection to the clipboard.void
performCut()
TheTextCellEditor
implementation of thisCellEditor
method cuts the current selection to the clipboard.void
performDelete()
TheTextCellEditor
implementation of thisCellEditor
method deletes the current selection or, if there is no selection, the character next character from the current position.void
performPaste()
TheTextCellEditor
implementation of thisCellEditor
method pastes the the clipboard contents over the current selection.void
performSelectAll()
TheTextCellEditor
implementation of thisCellEditor
method selects all of the current text.-
Methods inherited from class org.eclipse.jface.viewers.CellEditor
activate, activate, addListener, addPropertyChangeListener, create, deactivate, deactivate, dispose, fireApplyEditorValue, fireCancelEditor, fireEditorValueChanged, fireEnablementChanged, focusLost, getControl, getDoubleClickTimeout, getErrorMessage, getStyle, getValidator, getValue, isActivated, isCorrect, isDirty, isFindEnabled, isRedoEnabled, isUndoEnabled, isValueValid, markDirty, performFind, performRedo, performUndo, removeListener, removePropertyChangeListener, setErrorMessage, setFocus, setStyle, setValidator, setValue, setValueValid, valueChanged
-
-
-
-
Field Detail
-
text
protected Text text
The text control; initiallynull
.
-
-
Constructor Detail
-
TextCellEditor
public TextCellEditor()
Creates a new text string cell editor with no control The cell editor value is the string itself, which is initially the empty string. Initially, the cell editor has no cell validator.- Since:
- 2.1
-
TextCellEditor
public TextCellEditor(Composite parent)
Creates a new text string cell editor parented under the given control. The cell editor value is the string itself, which is initially the empty string. Initially, the cell editor has no cell validator.- Parameters:
parent
- the parent control
-
TextCellEditor
public TextCellEditor(Composite parent, int style)
Creates a new text string cell editor parented under the given control. The cell editor value is the string itself, which is initially the empty string. Initially, the cell editor has no cell validator.- Parameters:
parent
- the parent controlstyle
- the style bits- Since:
- 2.1
-
-
Method Detail
-
createControl
protected Control createControl(Composite parent)
Description copied from class:CellEditor
Creates the control for this cell editor under the given parent control.This framework method must be implemented by concrete subclasses.
- Specified by:
createControl
in classCellEditor
- Parameters:
parent
- the parent control- Returns:
- the new control, or
null
if this cell editor has no control
-
doGetValue
protected Object doGetValue()
TheTextCellEditor
implementation of thisCellEditor
framework method returns the text string.- Specified by:
doGetValue
in classCellEditor
- Returns:
- the text string
- See Also:
CellEditor.getValue()
-
doSetFocus
protected void doSetFocus()
Description copied from class:CellEditor
Sets the focus to the cell editor's control.This framework method must be implemented by concrete subclasses.
- Specified by:
doSetFocus
in classCellEditor
- See Also:
CellEditor.setFocus()
-
doSetValue
protected void doSetValue(Object value)
TheTextCellEditor
implementation of thisCellEditor
framework method accepts a text string (typeString
).- Specified by:
doSetValue
in classCellEditor
- Parameters:
value
- a text string (typeString
)- See Also:
CellEditor.setValue(java.lang.Object)
-
editOccured
protected void editOccured(ModifyEvent e)
Processes a modify event that occurred in this text cell editor. This framework method performs validation and sets the error message accordingly, and then reports a change viafireEditorValueChanged
. Subclasses should call this method at appropriate times. Subclasses may extend or reimplement.- Parameters:
e
- the SWT modify event
-
getLayoutData
public CellEditor.LayoutData getLayoutData()
Since a text editor field is scrollable we don't set a minimumSize.- Overrides:
getLayoutData
in classCellEditor
- Returns:
- the layout data object
-
handleDefaultSelection
protected void handleDefaultSelection(SelectionEvent event)
Handles a default selection event from the text control by applying the editor value and deactivating this cell editor.- Parameters:
event
- the selection event- Since:
- 3.0
-
isCopyEnabled
public boolean isCopyEnabled()
TheTextCellEditor
implementation of thisCellEditor
method returnstrue
if the current selection is not empty.- Overrides:
isCopyEnabled
in classCellEditor
- Returns:
true
if copy is possible,false
otherwise
-
isCutEnabled
public boolean isCutEnabled()
TheTextCellEditor
implementation of thisCellEditor
method returnstrue
if the current selection is not empty.- Overrides:
isCutEnabled
in classCellEditor
- Returns:
true
if cut is possible,false
otherwise
-
isDeleteEnabled
public boolean isDeleteEnabled()
TheTextCellEditor
implementation of thisCellEditor
method returnstrue
if there is a selection or if the caret is not positioned at the end of the text.- Overrides:
isDeleteEnabled
in classCellEditor
- Returns:
true
if delete is possible,false
otherwise
-
isPasteEnabled
public boolean isPasteEnabled()
TheTextCellEditor
implementation of thisCellEditor
method always returnstrue
.- Overrides:
isPasteEnabled
in classCellEditor
- Returns:
true
if paste is possible,false
otherwise
-
isSaveAllEnabled
public boolean isSaveAllEnabled()
Check if save all is enabled- Returns:
- true if it is
-
isSelectAllEnabled
public boolean isSelectAllEnabled()
Returnstrue
if this cell editor is able to perform the select all action.This default implementation always returns
false
.Subclasses may override
- Overrides:
isSelectAllEnabled
in classCellEditor
- Returns:
true
if select all is possible,false
otherwise
-
keyReleaseOccured
protected void keyReleaseOccured(KeyEvent keyEvent)
Processes a key release event that occurred in this cell editor.The
TextCellEditor
implementation of this framework method ignores when the RETURN key is pressed since this is handled inhandleDefaultSelection
. An exception is made for Ctrl+Enter for multi-line texts, since a default selection event is not sent in this case.- Overrides:
keyReleaseOccured
in classCellEditor
- Parameters:
keyEvent
- the key event
-
performCopy
public void performCopy()
TheTextCellEditor
implementation of thisCellEditor
method copies the current selection to the clipboard.- Overrides:
performCopy
in classCellEditor
-
performCut
public void performCut()
TheTextCellEditor
implementation of thisCellEditor
method cuts the current selection to the clipboard.- Overrides:
performCut
in classCellEditor
-
performDelete
public void performDelete()
TheTextCellEditor
implementation of thisCellEditor
method deletes the current selection or, if there is no selection, the character next character from the current position.- Overrides:
performDelete
in classCellEditor
-
performPaste
public void performPaste()
TheTextCellEditor
implementation of thisCellEditor
method pastes the the clipboard contents over the current selection.- Overrides:
performPaste
in classCellEditor
-
performSelectAll
public void performSelectAll()
TheTextCellEditor
implementation of thisCellEditor
method selects all of the current text.- Overrides:
performSelectAll
in classCellEditor
-
dependsOnExternalFocusListener
protected boolean dependsOnExternalFocusListener()
This implementation ofCellEditor.dependsOnExternalFocusListener()
returns false if the current instance's class is TextCellEditor, and true otherwise. Subclasses that hook their own focus listener should override this method and return false. See also bug 58777.- Overrides:
dependsOnExternalFocusListener
in classCellEditor
- Returns:
true
to indicate that a focus listener has to be attached- Since:
- 3.4
-
-