Package org.eclipse.jface.text.hyperlink
Interface IHyperlinkPresenter
- All Superinterfaces:
ITextViewerLifecycle
- All Known Implementing Classes:
DefaultHyperlinkPresenter
,MultipleHyperlinkPresenter
A hyperlink presenter shows hyperlinks on the installed text viewer and allows to pick one on of
the hyperlinks.
In order to provide backward compatibility for clients of IHyperlinkDetector
,
extension interfaces are used to provide a means of evolution. The following extension interfaces
exist:
IHyperlinkPresenterExtension
since version 3.4, adds the ability to query whether the currently shown hyperlinks can be hidden.IHyperlinkPresenterExtension2
since version 3.7, adds the ability distinguish between the modes in which the control either takes focus or not when visible.
Clients may implement this interface. A default implementation is provided through
DefaultHyperlinkPresenter
.
- Since:
- 3.1
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionboolean
Tells whether this presenter is able to handle more than one hyperlink.void
Tells this hyperlink presenter to hide the hyperlinks requested to be shown byshowHyperlinks(IHyperlink[])
.void
install
(ITextViewer textViewer) Installs this hyperlink presenter on the given text viewer.void
showHyperlinks
(IHyperlink[] hyperlinks) Tells this hyperlink presenter to show the given hyperlinks on the installed text viewer.void
Uninstalls this hyperlink presenter.
-
Method Details
-
canShowMultipleHyperlinks
boolean canShowMultipleHyperlinks()Tells whether this presenter is able to handle more than one hyperlink.- Returns:
true
if this presenter can handle more than one hyperlink
-
showHyperlinks
Tells this hyperlink presenter to show the given hyperlinks on the installed text viewer.- Parameters:
hyperlinks
- the hyperlinks to show- Throws:
IllegalArgumentException
- ifhyperlinks
is emptycanShowMultipleHyperlinks()
returnsfalse
andhyperlinks
contains more than one element
-
hideHyperlinks
void hideHyperlinks()Tells this hyperlink presenter to hide the hyperlinks requested to be shown byshowHyperlinks(IHyperlink[])
. -
install
Installs this hyperlink presenter on the given text viewer.- Specified by:
install
in interfaceITextViewerLifecycle
- Parameters:
textViewer
- the text viewer
-
uninstall
void uninstall()Uninstalls this hyperlink presenter.- Specified by:
uninstall
in interfaceITextViewerLifecycle
-