Package org.eclipse.ui.forms.widgets
Class AbstractHyperlink
- java.lang.Object
-
- org.eclipse.swt.widgets.Widget
-
- org.eclipse.swt.widgets.Control
-
- org.eclipse.swt.widgets.Scrollable
-
- org.eclipse.swt.widgets.Composite
-
- org.eclipse.swt.widgets.Canvas
-
- org.eclipse.ui.forms.widgets.AbstractHyperlink
-
- All Implemented Interfaces:
Drawable
- Direct Known Subclasses:
Hyperlink,ToggleHyperlink
public abstract class AbstractHyperlink extends Canvas
This is the base class for custom hyperlink widget. It is responsible for processing mouse and keyboard events, and converting them into unified hyperlink events. Subclasses are responsible for rendering the hyperlink in the client area.- Styles:
- None
- Since:
- 3.0
-
-
Field Summary
Fields Modifier and Type Field Description protected intmarginHeightAmount of the margin height around the hyperlink (default is 1).protected intmarginWidthAmount of the margin width around the hyperlink (default is 1).
-
Constructor Summary
Constructors Constructor Description AbstractHyperlink(Composite parent, int style)Creates a new hyperlink in the provided parent.
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description voidaddHyperlinkListener(IHyperlinkListener listener)Adds the event listener to this hyperlink.ObjectgetHref()Returns the object associated with this hyperlink.booleangetSelection()Returns the selection state of the control.StringgetText()Returns the textual representation of this hyperlink suitable for showing in tool tips or on the status line.protected voidhandleActivate(Event e)Called when hyperlink has been activated.protected voidhandleEnter(Event e)Called when hyperlink is entered.protected voidhandleExit(Event e)Called when hyperlink is exited.protected voidpaint(PaintEvent e)Paints the control as a reaction to the provided paint event.protected abstract voidpaintHyperlink(GC gc)Paints the hyperlink as a reaction to the provided paint event.voidremoveHyperlinkListener(IHyperlinkListener listener)Removes the event listener from this hyperlink.voidsetEnabled(boolean enabled)Enables the receiver if the argument istrue, and disables it otherwise.voidsetHref(Object href)Sets the object associated with this hyperlink.-
Methods inherited from class org.eclipse.swt.widgets.Canvas
drawBackground, getCaret, getIME, scroll, setCaret, setFont, setIME
-
Methods inherited from class org.eclipse.swt.widgets.Composite
changed, checkSubclass, drawBackground, getBackgroundMode, getChildren, getLayout, getLayoutDeferred, getTabList, isLayoutDeferred, layout, layout, layout, layout, layout, setBackgroundMode, setFocus, setLayout, setLayoutDeferred, setTabList
-
Methods inherited from class org.eclipse.swt.widgets.Scrollable
computeTrim, getClientArea, getHorizontalBar, getScrollbarsMode, getVerticalBar
-
Methods inherited from class org.eclipse.swt.widgets.Control
addControlListener, addDragDetectListener, addFocusListener, addGestureListener, addHelpListener, addKeyListener, addMenuDetectListener, addMouseListener, addMouseMoveListener, addMouseTrackListener, addMouseWheelListener, addPaintListener, addTouchListener, addTraverseListener, computeSize, computeSize, dragDetect, dragDetect, forceFocus, getAccessible, getBackground, getBackgroundImage, getBorderWidth, getBounds, getCursor, getDragDetect, getEnabled, getFont, getForeground, getLayoutData, getLocation, getMenu, getMonitor, getOrientation, getParent, getRegion, getShell, getSize, getTextDirection, getToolTipText, getTouchEnabled, getVisible, internal_dispose_GC, internal_new_GC, isEnabled, isFocusControl, isReparentable, isVisible, moveAbove, moveBelow, pack, pack, print, redraw, redraw, removeControlListener, removeDragDetectListener, removeFocusListener, removeGestureListener, removeHelpListener, removeKeyListener, removeMenuDetectListener, removeMouseListener, removeMouseMoveListener, removeMouseTrackListener, removeMouseWheelListener, removePaintListener, removeTouchListener, removeTraverseListener, requestLayout, setBackground, setBackgroundImage, setBounds, setBounds, setCapture, setCursor, setDragDetect, setForeground, setLayoutData, setLocation, setLocation, setMenu, setOrientation, setParent, setRedraw, setRegion, setSize, setSize, setTextDirection, setToolTipText, setTouchEnabled, setVisible, toControl, toControl, toDisplay, toDisplay, traverse, traverse, traverse, update
-
Methods inherited from class org.eclipse.swt.widgets.Widget
addDisposeListener, addListener, checkWidget, dispose, getData, getData, getDisplay, getListeners, getStyle, isAutoDirection, isDisposed, isListening, notifyListeners, removeDisposeListener, removeListener, removeListener, reskin, setData, setData, toString
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.eclipse.swt.graphics.Drawable
isAutoScalable
-
-
-
-
Constructor Detail
-
AbstractHyperlink
public AbstractHyperlink(Composite parent, int style)
Creates a new hyperlink in the provided parent.- Parameters:
parent- the control parentstyle- the widget style
-
-
Method Detail
-
addHyperlinkListener
public void addHyperlinkListener(IHyperlinkListener listener)
Adds the event listener to this hyperlink.- Parameters:
listener- the event listener to add
-
removeHyperlinkListener
public void removeHyperlinkListener(IHyperlinkListener listener)
Removes the event listener from this hyperlink.- Parameters:
listener- the event listener to remove
-
getSelection
public boolean getSelection()
Returns the selection state of the control. When focus is gained, the state will be true ; it will switch to false when the control looses focus.- Returns:
trueif the widget has focus,falseotherwise.
-
handleEnter
protected void handleEnter(Event e)
Called when hyperlink is entered. Subclasses that override this method must call 'super'.
-
handleExit
protected void handleExit(Event e)
Called when hyperlink is exited. Subclasses that override this method must call 'super'.
-
handleActivate
protected void handleActivate(Event e)
Called when hyperlink has been activated. Subclasses that override this method must call 'super'.
-
setHref
public void setHref(Object href)
Sets the object associated with this hyperlink. Concrete implementation of this class can use if to store text, URLs or model objects that need to be processed on hyperlink events.- Parameters:
href- the hyperlink object reference
-
getHref
public Object getHref()
Returns the object associated with this hyperlink.- Returns:
- the hyperlink object reference
- See Also:
setHref(java.lang.Object)
-
getText
public String getText()
Returns the textual representation of this hyperlink suitable for showing in tool tips or on the status line.- Returns:
- the hyperlink text
-
paintHyperlink
protected abstract void paintHyperlink(GC gc)
Paints the hyperlink as a reaction to the provided paint event.- Parameters:
gc- graphic context
-
paint
protected void paint(PaintEvent e)
Paints the control as a reaction to the provided paint event.- Parameters:
e- the paint event
-
setEnabled
public void setEnabled(boolean enabled)
Description copied from class:ControlEnables the receiver if the argument istrue, and disables it otherwise. A disabled control is typically not selectable from the user interface and draws with an inactive or "grayed" look.- Overrides:
setEnabledin classControl- Parameters:
enabled- the new enabled state
-
-