/*
* Copyright (c) 2010, 2014, Oracle and/or its affiliates. All rights reserved.
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*/
package javafx.scene.control;
import javafx.beans.property.BooleanProperty;
import javafx.beans.property.BooleanPropertyBase;
import javafx.beans.value.WritableValue;
import javafx.event.ActionEvent;
import javafx.scene.AccessibleAttribute;
import javafx.scene.AccessibleRole;
import javafx.scene.Cursor;
import javafx.scene.Node;
import javafx.css.PseudoClass;
import com.sun.javafx.scene.control.skin.HyperlinkSkin;
import javafx.css.StyleableProperty;
/**
*
An HTML like label which can be a graphic and/or text which responds to rollovers and clicks.
* When a hyperlink is clicked/pressed {@link #isVisited} becomes {@code true}. A Hyperlink behaves
* just like a {@link Button}. When a hyperlink is pressed and released
* a {@link ActionEvent} is sent, and your application can perform some action based on this event.
*
*
* Example:
* {@code Hyperlink link = new Hyperlink("www.oracle.com"); }
* @since JavaFX 2.0
*/
public class Hyperlink extends ButtonBase {
/***************************************************************************
* *
* Constructors *
* *
**************************************************************************/
/**
* Creates a hyperlink with no label.
*/
public Hyperlink() {
initialize();
}
/**
* Create a hyperlink with the specified text as its label.
*
* @param text A text string for its label.
*/
public Hyperlink(String text) {
super(text);
initialize();
}
/**
* Create a hyperlink with the specified text and graphic as its label.
*
* @param text A text string for its label.
* @param graphic A graphic for its label
*/
public Hyperlink(String text, Node graphic) {
super(text, graphic);
initialize();
}
private void initialize() {
// Initialize the style class to be 'hyperlink'.
getStyleClass().setAll(DEFAULT_STYLE_CLASS);
setAccessibleRole(AccessibleRole.HYPERLINK);
// cursor is styleable through css. Calling setCursor
// makes it look to css like the user set the value and css will not
// override. Initializing cursor by calling applyStyle with null
// StyleOrigin ensures that css will be able to override the value.
((StyleableProperty)(WritableValue)cursorProperty()).applyStyle(null, Cursor.HAND);
}
/***************************************************************************
* *
* Properties *
* *
**************************************************************************/
/**
* Indicates whether this link has already been "visited".
*/
public final BooleanProperty visitedProperty() {
if (visited == null) {
visited = new BooleanPropertyBase() {
@Override protected void invalidated() {
pseudoClassStateChanged(PSEUDO_CLASS_VISITED, get());
}
@Override
public Object getBean() {
return Hyperlink.this;
}
@Override
public String getName() {
return "visited";
}
};
}
return visited;
}
private BooleanProperty visited;
public final void setVisited(boolean value) {
visitedProperty().set(value);
}
public final boolean isVisited() {
return visited == null ? false : visited.get();
}
/***************************************************************************
* *
* Methods *
* *
**************************************************************************/
/**
* Implemented to invoke the {@link ActionEvent} if one is defined. This
* function will also {@link #setVisited} to true.
*/
@Override public void fire() {
if (!isDisabled()) {
// Avoid causing an exception in the case that visited was bound
if (visited == null || !visited.isBound()) {
setVisited(true);
}
fireEvent(new ActionEvent());
}
}
/** {@inheritDoc} */
@Override protected Skin> createDefaultSkin() {
return new HyperlinkSkin(this);
}
/***************************************************************************
* *
* Stylesheet Handling *
* *
**************************************************************************/
private static final String DEFAULT_STYLE_CLASS = "hyperlink";
private static final PseudoClass PSEUDO_CLASS_VISITED =
PseudoClass.getPseudoClass("visited");
/**
* Hyperlink uses HAND as the default value for cursor.
* This method provides a way for css to get the correct initial value.
* @treatAsPrivate implementation detail
*/
@Deprecated @Override
protected /*do not make final*/ Cursor impl_cssGetCursorInitialValue() {
return Cursor.HAND;
}
/***************************************************************************
* *
* Accessibility handling *
* *
**************************************************************************/
@Override
public Object queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters) {
switch (attribute) {
case VISITED: return isVisited();
default: return super.queryAccessibleAttribute(attribute, parameters);
}
}
}