org.jdesktop.swingx.hyperlink
Class HyperlinkAction
java.lang.Object
javax.swing.AbstractAction
org.jdesktop.swingx.action.AbstractActionExt
org.jdesktop.swingx.hyperlink.AbstractHyperlinkAction<java.net.URI>
org.jdesktop.swingx.hyperlink.HyperlinkAction
- All Implemented Interfaces:
- java.awt.event.ActionListener, java.awt.event.ItemListener, java.io.Serializable, java.lang.Cloneable, java.util.EventListener, javax.swing.Action
public class HyperlinkAction
- extends AbstractHyperlinkAction<java.net.URI>
A implementation wrapping Desktop
actions BROWSE and MAIL, that is
URI-related.
- Author:
- Jeanette Winzenburg
- See Also:
- Serialized Form
Fields inherited from class javax.swing.AbstractAction |
changeSupport, enabled |
Fields inherited from interface javax.swing.Action |
ACCELERATOR_KEY, ACTION_COMMAND_KEY, DEFAULT, DISPLAYED_MNEMONIC_INDEX_KEY, LARGE_ICON_KEY, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SELECTED_KEY, SHORT_DESCRIPTION, SMALL_ICON |
Constructor Summary |
HyperlinkAction()
Instantiates a HyperlinkAction with action type BROWSE. |
HyperlinkAction(java.awt.Desktop.Action desktopAction)
Instantiates a HyperlinkAction with the given action type. |
HyperlinkAction(java.net.URI uri,
java.awt.Desktop.Action desktopAction)
|
Methods inherited from class org.jdesktop.swingx.action.AbstractActionExt |
dispose, getAccelerator, getActionCommand, getGroup, getLargeIcon, getLongDescription, getMnemonic, getName, getShortDescription, getSmallIcon, isSelected, isStateAction, setAccelerator, setActionCommand, setGroup, setLargeIcon, setLongDescription, setMnemonic, setMnemonic, setName, setSelected, setShortDescription, setSmallIcon, setStateAction, toString |
Methods inherited from class javax.swing.AbstractAction |
addPropertyChangeListener, clone, firePropertyChange, getKeys, getPropertyChangeListeners, getValue, isEnabled, putValue, removePropertyChangeListener, setEnabled |
Methods inherited from class java.lang.Object |
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
HyperlinkAction
public HyperlinkAction()
- Instantiates a HyperlinkAction with action type BROWSE.
- Throws:
java.awt.HeadlessException
- if GraphicsEnvironment.isHeadless()
returns true
java.lang.UnsupportedOperationException
- if the current platform doesn't support
Desktop
java.lang.IllegalArgumentException
- if unsupported action type
HyperlinkAction
public HyperlinkAction(java.awt.Desktop.Action desktopAction)
- Instantiates a HyperlinkAction with the given action type.
- Parameters:
desktopAction
- the type of desktop action this class should perform, must be
BROWSE or MAIL
- Throws:
java.awt.HeadlessException
- if GraphicsEnvironment.isHeadless()
returns true
java.lang.UnsupportedOperationException
- if the current platform doesn't support
Desktop
java.lang.IllegalArgumentException
- if unsupported action type
HyperlinkAction
public HyperlinkAction(java.net.URI uri,
java.awt.Desktop.Action desktopAction)
- Parameters:
uri
- the target uri, maybe null.desktopAction
- the type of desktop action this class should perform, must be
BROWSE or MAIL
- Throws:
java.awt.HeadlessException
- if GraphicsEnvironment.isHeadless()
returns true
java.lang.UnsupportedOperationException
- if the current platform doesn't support
Desktop
java.lang.IllegalArgumentException
- if unsupported action type
createHyperlinkAction
public static HyperlinkAction createHyperlinkAction(java.net.URI uri)
- Factory method to create and return a HyperlinkAction for the given uri. Tries
to guess the appropriate type from the uri. If uri is not null and has a
scheme of mailto, create one of type Mail. In all other cases, creates one
for BROWSE.
- Parameters:
uri
- to uri to create a HyperlinkAction for, maybe null.
- Returns:
- a HyperlinkAction for the given URI.
- Throws:
java.awt.HeadlessException
- if GraphicsEnvironment.isHeadless()
returns true
java.lang.UnsupportedOperationException
- if the current platform doesn't support
Desktop
createHyperlinkAction
public static HyperlinkAction createHyperlinkAction(java.net.URI uri,
java.awt.Desktop.Action type)
- Creates and returns a HyperlinkAction with the given target and action type.
- Parameters:
uri
- the target uri, maybe null.desktopAction
- the type of desktop action this class should perform, must be
BROWSE or MAIL
- Returns:
- a HyperlinkAction
- Throws:
java.awt.HeadlessException
- if GraphicsEnvironment.isHeadless()
returns true
java.lang.UnsupportedOperationException
- if the current platform doesn't support
Desktop
java.lang.IllegalArgumentException
- if unsupported action type
actionPerformed
public void actionPerformed(java.awt.event.ActionEvent e)
-
Implemented to perform the appropriate Desktop action if supported on the current
target. Sets the visited property to true if the desktop action doesn't throw
an exception or to false if it did.
Does nothing if the action isn't supported.
getDesktopAction
public java.awt.Desktop.Action getDesktopAction()
- Returns:
installTarget
protected void installTarget()
- Description copied from class:
AbstractHyperlinkAction
- hook for subclasses to update internal state after
a new target has been set.
Subclasses are free to decide the details.
Here:
- the text property is set to target.toString or empty String if
the target is null
- visited is set to false.
- Overrides:
installTarget
in class AbstractHyperlinkAction<java.net.URI>
Copyright © 2010. All Rights Reserved.