ro.sync.ecss.extensions.commons.editor
Class URLChooserEditorSWT

java.lang.Object
  ro.sync.ecss.extensions.api.editor.AbstractInplaceEditor
      ro.sync.ecss.extensions.commons.editor.URLChooserEditorSWT

All Implemented Interfaces:

org.eclipse.jface.text.ITextOperationTarget, InplaceEditor, Extension

@API(type=INTERNAL,
     src=PUBLIC)
public class URLChooserEditorSWT
extends AbstractInplaceEditor
implements org.eclipse.jface.text.ITextOperationTarget

URL Chooser in-place editor on Eclipse.

Field Summary

Fields inherited from interface org.eclipse.jface.text.ITextOperationTarget

COPY, CUT, DELETE, PASTE, PREFIX, PRINT, REDO, SELECT_ALL, SHIFT_LEFT, SHIFT_RIGHT, STRIP_PREFIX, UNDO

Constructor Summary

URLChooserEditorSWT()
Constructor.

Method Summary

void	cancelEditing() Cancels the editing process.
boolean	canDoOperation(int operation)
void	doOperation(int operation)
java.lang.String	getDescription()
java.lang.Object	getEditorComponent(AuthorInplaceContext context, Rectangle allocation, Point mouseInvocationLocation) Prepare and return the editor component.
Rectangle	getScrollRectangle() Returns a rectangle that should be made visible after the editor is shown.
java.lang.Object	getValue() Gets the value that the user entered.
void	requestFocus() Requests focus inside the editing component.
void	stopEditing() Stops the editing and commits the current value.

Methods inherited from class ro.sync.ecss.extensions.api.editor.AbstractInplaceEditor

addEditingListener, fireCommitValue, fireEditingCanceled, fireEditingOccured, fireEditingStopped, fireNextEditLocationRequested, firePreviousEditLocationRequested, removeEditingListener

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

URLChooserEditorSWT

public URLChooserEditorSWT()

Constructor.

Method Detail

getDescription

public java.lang.String getDescription()

Specified by:

getDescription in interface Extension

Returns:

The description of the extension.

See Also:

Extension.getDescription()

getEditorComponent

public java.lang.Object getEditorComponent(AuthorInplaceContext context,
                                           Rectangle allocation,
                                           Point mouseInvocationLocation)

Description copied from interface: InplaceEditor

Prepare and return the editor component.

Specified by:

getEditorComponent in interface InplaceEditor

Parameters:

context - The context where the editor will be used.

allocation - The bounds where the editor will be shown. This is normally the bounds of the box in which the value being edited is rendered. If the editor requires to be presented in different bounds it should alter this parameter. The X,Y coordinates are relative to the parent in which the editor will be added.

mouseInvocationLocation - if the editor was requested using the mouse this parameter represents the X,Y location where the event took place. It is relative to the parent in which the editor will be added. null if the editor wasn't requested through mouse interaction.

OBS: This is the very first call received by an editor. This ensures that the editor is properly initialized for the subsequent calls (like a InplaceEditor.requestFocus() call).
OBS: An editor implementation will have to add listeners onto itself like:

• a KeyListener for handling key events like: ENTER to stop editing (by calling InplaceEditingListener.editingStopped(EditingEvent)) and ESCAPE to cancel it (by calling InplaceEditingListener.editingCanceled()).
• a FocusListener to stop editing when the focus is given to a component that is not part of the editor (by calling InplaceEditingListener.editingStopped(EditingEvent)).
• a DocumentListener to fire InplaceEditingListener.editingOccured() events (If the editor has a document).

Returns:

The component that performs the editing. For the Standalone distribution this should be a java.awt.JComponent implementation. For the Eclipse plugin distribution, an org.eclipse.swt.widgets.Control is expected.

See Also:

InplaceEditor.getEditorComponent(ro.sync.ecss.extensions.api.editor.AuthorInplaceContext, ro.sync.exml.view.graphics.Rectangle, ro.sync.exml.view.graphics.Point)

getScrollRectangle

public Rectangle getScrollRectangle()

Description copied from interface: InplaceEditor

Returns a rectangle that should be made visible after the editor is shown. The coordinate should be relative to the editor itself. The default behavior is to make the entire editor visible but if the editor is bigger than the viewport the visible part might not be the right one. For example is the editor is a text field the caret might not be visible. This is when this method is useful. The caret rectangle should be returned so that the part of the editor with the caret is presented.

Specified by:

getScrollRectangle in interface InplaceEditor

Returns:

A rectangle to be made visible or null to make the entire editor visible.

See Also:

InplaceEditor.getScrollRectangle()

requestFocus

public void requestFocus()

Description copied from interface: InplaceEditor

Requests focus inside the editing component.

Specified by:

requestFocus in interface InplaceEditor

See Also:

InplaceEditor.requestFocus()

getValue

public java.lang.Object getValue()

Description copied from interface: InplaceEditor

Gets the value that the user entered.

Specified by:

getValue in interface InplaceEditor

Returns:

The value that the user entered.

See Also:

InplaceEditor.getValue()

stopEditing

public void stopEditing()

Description copied from interface: InplaceEditor

Stops the editing and commits the current value. The editor should release any held resources and notify InplaceEditingListener.editingStopped(EditingEvent). OBS: The current value will be committed only if at least one InplaceEditingListener.editingOccured() event was issued before this moment.

Specified by:

stopEditing in interface InplaceEditor

See Also:

InplaceEditor.stopEditing()

cancelEditing

public void cancelEditing()

Description copied from interface: InplaceEditor

Cancels the editing process. The editor should release any held resources and notify InplaceEditingListener.editingCanceled().

Specified by:

cancelEditing in interface InplaceEditor

See Also:

InplaceEditor.cancelEditing()

canDoOperation

public boolean canDoOperation(int operation)

Specified by:

canDoOperation in interface org.eclipse.jface.text.ITextOperationTarget

See Also:

ITextOperationTarget.canDoOperation(int)

doOperation

public void doOperation(int operation)

Specified by:

doOperation in interface org.eclipse.jface.text.ITextOperationTarget

See Also:

ITextOperationTarget.doOperation(int)