com.zfqjava.swing
Class JLinkButton

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.AbstractButton
                          |
                          +--javax.swing.JButton
                                |
                                +--com.zfqjava.swing.JLinkButton

All Implemented Interfaces:

javax.accessibility.Accessible, java.awt.image.ImageObserver, java.awt.ItemSelectable, java.awt.MenuContainer, java.io.Serializable, javax.swing.SwingConstants

public class JLinkButton

extends javax.swing.JButton

JLinkButton provides a button can launch a URL.

See Also:

Serialized Form

Inner Class Summary

protected class

JLinkButton.AccessibleJLinkButton This class implements accessibility support for the JLinkButton class.

Inner classes inherited from class javax.swing.JButton

javax.swing.JButton.AccessibleJButton

Inner classes inherited from class javax.swing.AbstractButton

javax.swing.AbstractButton.AccessibleAbstractButton, javax.swing.AbstractButton.ButtonChangeListener

Inner classes inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Inner classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Inner classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent

Field Summary

static int	ALWAYS_UNDERLINE Identifies the always underline behavior of the link text.
static int	HOVER_UNDERLINE Identifies the hover underline behavior of the link text.
static int	NEVER_UNDERLINE Identifies the nerver underline behavior of the link text.
static int	SYSTEM_DEFAULT Identifies the default behavior of the link text.

Fields inherited from class javax.swing.AbstractButton

actionListener, BORDER_PAINTED_CHANGED_PROPERTY, changeEvent, changeListener, CONTENT_AREA_FILLED_CHANGED_PROPERTY, DISABLED_ICON_CHANGED_PROPERTY, DISABLED_SELECTED_ICON_CHANGED_PROPERTY, FOCUS_PAINTED_CHANGED_PROPERTY, HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY, HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY, ICON_CHANGED_PROPERTY, itemListener, MARGIN_CHANGED_PROPERTY, MNEMONIC_CHANGED_PROPERTY, model, MODEL_CHANGED_PROPERTY, PRESSED_ICON_CHANGED_PROPERTY, ROLLOVER_ENABLED_CHANGED_PROPERTY, ROLLOVER_ICON_CHANGED_PROPERTY, ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY, SELECTED_ICON_CHANGED_PROPERTY, TEXT_CHANGED_PROPERTY, VERTICAL_ALIGNMENT_CHANGED_PROPERTY, VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NORTH, NORTH_EAST, NORTH_WEST, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

JLinkButton()
Creates a button with no set text or icon or URL.

JLinkButton(javax.swing.Action a)
Creates a button where properties are taken from the Action supplied.

JLinkButton(javax.swing.Icon icon)
Creates a link button with an icon.

JLinkButton(javax.swing.Icon icon, java.net.URL url)
Creates a button with the icon and the URL.

JLinkButton(java.lang.String text)
Creates a button with where text are taken from the URL.

JLinkButton(java.lang.String text, javax.swing.Icon icon, java.net.URL url)
Creates a button with initial text and an icon.

JLinkButton(java.lang.String text, java.net.URL url)
Creates a button with the text and the URL.

JLinkButton(java.net.URL url)
Creates a button with where text are taken from the URL.

Method Summary

protected javax.swing.Action	createDefaultAction() Creates a action handler to handle this button's action event.
javax.accessibility.AccessibleContext	getAccessibleContext() Gets the AccessibleContext associated with this JLinkButton.
java.awt.Color	getActiveLinkColor() Returns the active link color.
javax.swing.Action	getDefaultAction() Returns the default action handler of this button.
java.awt.Color	getDisabledLinkColor() Returns the disabled link color.
int	getLinkBehavior() Returns the current link behaviro of this JLinkButton.
java.awt.Color	getLinkColor() Returns the link color.
java.net.URL	getLinkURL() Returns the URL that this button linked.
java.lang.String	getUIClassID() Returns a string that specifies the name of the L&F class that renders this component.
java.awt.Color	getVisitedLinkColor() Returns the visited link color.
boolean	isLinkVisited() Returns true if this link URL has been visited, otherwise return false;
protected java.lang.String	paramString() Returns a string representation of this JLinkButton.
void	setActiveLinkColor(java.awt.Color activeColor) Sets the active link color.
void	setDefaultAction(javax.swing.Action action) Sets the action that will handle this button's action event.
void	setDisabledLinkColor(java.awt.Color disabledColor) Sets the disabled link color.
void	setLinkBehavior(int behavior) Sets this JLinkButton link behavior.
void	setLinkColor(java.awt.Color color) Sets the link color.
void	setLinkURL(java.net.URL url) Sets the URL that this button linked.
void	setLinkVisited(boolean isVisited) Sets the linkVisited property, default is false.
protected void	setupToolTipText() Setup the tool tip text when the link URL changed.
void	setVisitedLinkColor(java.awt.Color visitedColor) Sets the visited link color.
void	updateUI() Resets the UI property to a value from the current look and feel.

Methods inherited from class javax.swing.JButton

configurePropertiesFromAction, isDefaultButton, isDefaultCapable, removeNotify, setDefaultCapable

Methods inherited from class javax.swing.AbstractButton

addActionListener, addChangeListener, addItemListener, checkHorizontalKey, checkVerticalKey, createActionListener, createActionPropertyChangeListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getDisabledIcon, getDisabledSelectedIcon, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getLabel, getMargin, getMnemonic, getModel, getPressedIcon, getRolloverIcon, getRolloverSelectedIcon, getSelectedIcon, getSelectedObjects, getText, getUI, getVerticalAlignment, getVerticalTextPosition, imageUpdate, init, isBorderPainted, isContentAreaFilled, isFocusPainted, isFocusTraversable, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setEnabled, setFocusPainted, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setLabel, setMargin, setMnemonic, setMnemonic, setModel, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVerifyInputWhenFocusTarget, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, hide, isDoubleBuffered, isFocusCycleRoot, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processFocusEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, inside, isDisplayable, isEnabled, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus

Methods inherited from class java.lang.Object

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

Field Detail

ALWAYS_UNDERLINE

public static final int ALWAYS_UNDERLINE

Identifies the always underline behavior of the link text.

HOVER_UNDERLINE

public static final int HOVER_UNDERLINE

Identifies the hover underline behavior of the link text.

NEVER_UNDERLINE

public static final int NEVER_UNDERLINE

Identifies the nerver underline behavior of the link text.

SYSTEM_DEFAULT

public static final int SYSTEM_DEFAULT

Identifies the default behavior of the link text.

Constructor Detail

JLinkButton

public JLinkButton()

Creates a button with no set text or icon or URL.

See Also:

JLinkButton()

JLinkButton

public JLinkButton(javax.swing.Action a)

Creates a button where properties are taken from the Action supplied.

Parameters:

a - the Action used to specify the new button

See Also:

JLinkButton()

JLinkButton

public JLinkButton(javax.swing.Icon icon)

Creates a link button with an icon.

Parameters:

icon - the Icon image to display on the link button

JLinkButton

public JLinkButton(java.lang.String text)

Creates a button with where text are taken from the URL.

See Also:

JLinkButton()

JLinkButton

public JLinkButton(java.net.URL url)

Creates a button with where text are taken from the URL.

See Also:

JLinkButton()

JLinkButton

public JLinkButton(java.lang.String text,
                   java.net.URL url)

Creates a button with the text and the URL.

See Also:

JLinkButton()

JLinkButton

public JLinkButton(javax.swing.Icon icon,
                   java.net.URL url)

Creates a button with the icon and the URL.

See Also:

JLinkButton()

JLinkButton

public JLinkButton(java.lang.String text,
                   javax.swing.Icon icon,
                   java.net.URL url)

Creates a button with initial text and an icon.

Parameters:

text - the text of the button

icon - the Icon image to display on the button

Method Detail

updateUI

public void updateUI()

Resets the UI property to a value from the current look and feel.

Overrides:

updateUI in class javax.swing.JButton

See Also:

JComponent.updateUI()

getUIClassID

public java.lang.String getUIClassID()

Returns a string that specifies the name of the L&F class that renders this component.

Overrides:

getUIClassID in class javax.swing.JButton

Returns:

the string "LinkButtonUI"

See Also:

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

setupToolTipText

protected void setupToolTipText()

Setup the tool tip text when the link URL changed. If the link URL not null, use it's toExternalForm method get string as current tool tip text. If you can't use this automatic feature, overide this method, do nothing.

Returns:

the text of the tool tip

setLinkBehavior

public void setLinkBehavior(int behavior)

Sets this JLinkButton link behavior. One of the 4 legal values:

• JLinkButton.ALWAYS_UNDERLINE
• JLinkButton.HOVER_UNDERLINE
• JLinkButton.NEVER_UNDERLINE
• JLinkButton.SYSTEM_DEFAULT

Parameters:

behavior - the link behavior type

Throws:

java.lang.IllegalArgumentException - if the behavior illegal

See Also:

getLinkBehavior()

getLinkBehavior

public int getLinkBehavior()

Returns the current link behaviro of this JLinkButton. One of the 4 legal values:

• JLinkButton.ALWAYS_UNDERLINE
• JLinkButton.HOVER_UNDERLINE
• JLinkButton.NEVER_UNDERLINE
• JLinkButton.SYSTEM_DEFAULT

Returns:

the link behavior type

See Also:

setLinkBehavior(int)

setLinkColor

public void setLinkColor(java.awt.Color color)

Sets the link color.

Parameters:

color - the link color

See Also:

getLinkColor()

getLinkColor

public java.awt.Color getLinkColor()

Returns the link color.

Returns:

the link color

See Also:

setLinkColor(java.awt.Color)

setActiveLinkColor

public void setActiveLinkColor(java.awt.Color activeColor)

Sets the active link color.

Parameters:

activeColor - the active link color

See Also:

getActiveLinkColor()

getActiveLinkColor

public java.awt.Color getActiveLinkColor()

Returns the active link color.

Returns:

the active link color

See Also:

setActiveLinkColor(java.awt.Color)

setDisabledLinkColor

public void setDisabledLinkColor(java.awt.Color disabledColor)

Sets the disabled link color.

Parameters:

disabledColor - the disabled link color

See Also:

getDisabledLinkColor()

getDisabledLinkColor

public java.awt.Color getDisabledLinkColor()

Returns the disabled link color.

Returns:

the disabled link color

See Also:

setDisabledLinkColor(java.awt.Color)

setVisitedLinkColor

public void setVisitedLinkColor(java.awt.Color visitedColor)

Sets the visited link color.

Parameters:

visitedColor - the visited link color

See Also:

getVisitedLinkColor()

getVisitedLinkColor

public java.awt.Color getVisitedLinkColor()

Returns the visited link color.

Returns:

the visited link color

See Also:

setVisitedLinkColor(java.awt.Color)

getLinkURL

public java.net.URL getLinkURL()

Returns the URL that this button linked.

Returns:

the URL that this button linked

See Also:

getLinkURL()

setLinkURL

public void setLinkURL(java.net.URL url)

Sets the URL that this button linked.

Parameters:

url - the URL that this button linked

See Also:

getLinkURL()

setLinkVisited

public void setLinkVisited(boolean isVisited)

Sets the linkVisited property, default is false.

Parameters:

isVisited - the visited state

See Also:

isLinkVisited()

isLinkVisited

public boolean isLinkVisited()

Returns true if this link URL has been visited, otherwise return false;

Returns:

true if this link URL has been visited, otherwise return false

See Also:

setLinkVisited(boolean)

setDefaultAction

public void setDefaultAction(javax.swing.Action action)

Sets the action that will handle this button's action event.

Parameters:

action - the action handler to use

See Also:

getDefaultAction()

getDefaultAction

public javax.swing.Action getDefaultAction()

Returns the default action handler of this button.

Returns:

the default action handler

See Also:

setDefaultAction(javax.swing.Action)

createDefaultAction

protected javax.swing.Action createDefaultAction()

Creates a action handler to handle this button's action event.

paramString

protected java.lang.String paramString()

Returns a string representation of this JLinkButton. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.

Overrides:

paramString in class javax.swing.JButton

Returns:

a string representation of this JLinkButton.

getAccessibleContext

public javax.accessibility.AccessibleContext getAccessibleContext()

Gets the AccessibleContext associated with this JLinkButton. For JLinkButtons, the AccessibleContext takes the form of an AccessibleJLinkButton. A new AccessibleJLinkButton instance is created if necessary.

Overrides:

getAccessibleContext in class javax.swing.JButton

Returns:

an AccessibleJLinkButton that serves as the AccessibleContext of this JLinkButton