JavaTM 2 Platform
Standard Edition

javax.accessibility
Class AccessibleHyperlink

java.lang.Object
  |
  +--javax.accessibility.AccessibleHyperlink
Direct Known Subclasses:
JEditorPane.JEditorPaneAccessibleHypertextSupport.HTMLLink

public abstract class AccessibleHyperlink
extends Object
implements AccessibleAction

Encapsulation of a link, or set of links (e.g. client side imagemap) in a Hypertext document

See Also:
Accessible, Accessible.getAccessibleContext(), AccessibleContext, AccessibleText, AccessibleContext.getAccessibleText()

Constructor Summary
AccessibleHyperlink()
           
 
Method Summary
abstract  boolean doAccessibleAction(int i)
          Perform the specified Action on the object
abstract  Object getAccessibleActionAnchor(int i)
          Return an object that represents the link anchor, as appropriate for that link.
abstract  int getAccessibleActionCount()
          Returns the number of accessible actions available in this Link If there are more than one, the first one is NOT considered the "default" action of this LINK object (e.g.
abstract  String getAccessibleActionDescription(int i)
          Return a String description of this particular link action.
abstract  Object getAccessibleActionObject(int i)
          Return an object that represents the link action, as appropriate for that link.
abstract  int getEndIndex()
          Get the index with the hypertext document at which this link ends
abstract  int getStartIndex()
          Get the index with the hypertext document at which this link begins
abstract  boolean isValid()
          Since the document a link is associated with may have changed, this method returns whether this Link is valid anymore (with respect to the document it references).
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AccessibleHyperlink

public AccessibleHyperlink()
Method Detail

isValid

public abstract boolean isValid()
Since the document a link is associated with may have changed, this method returns whether this Link is valid anymore (with respect to the document it references).
Returns:
a flag indicating whether this link is still valid with respect to the AccessibleHypertext it belongs to

getAccessibleActionCount

public abstract int getAccessibleActionCount()
Returns the number of accessible actions available in this Link If there are more than one, the first one is NOT considered the "default" action of this LINK object (e.g. in an HTML imagemap). In general, links will have only one AccessibleAction in them.
Specified by:
getAccessibleActionCount in interface AccessibleAction
Returns:
the zero-based number of Actions in this object

doAccessibleAction

public abstract boolean doAccessibleAction(int i)
Perform the specified Action on the object
Specified by:
doAccessibleAction in interface AccessibleAction
Parameters:
i - zero-based index of actions
Returns:
true if the the action was performed; else false.
See Also:
getAccessibleActionCount()

getAccessibleActionDescription

public abstract String getAccessibleActionDescription(int i)
Return a String description of this particular link action. This should be a text string associated with anchoring text, this should be the anchor text. E.g. from HTML: <a HREF="http://www.sun.com/access">Accessibility</a> this method would return "Accessibility". Similarly, from this HTML: <a HREF="#top"><img src="top-hat.gif" alt="top hat"></a> this method would return "top hat"
Specified by:
getAccessibleActionDescription in interface AccessibleAction
Parameters:
i - zero-based index of the actions
Returns:
a String description of the action
See Also:
getAccessibleActionCount()

getAccessibleActionObject

public abstract Object getAccessibleActionObject(int i)
Return an object that represents the link action, as appropriate for that link. E.g. from HTML: <a HREF="http://www.sun.com/access">Accessibility</a> this method would return a java.net.URL("http://www.sun.com/access.html");
Parameters:
i - zero-based index of the actions
Returns:
an Object representing the hypertext link itself
See Also:
getAccessibleActionCount()

getAccessibleActionAnchor

public abstract Object getAccessibleActionAnchor(int i)
Return an object that represents the link anchor, as appropriate for that link. E.g. from HTML: <a href="http://www.sun.com/access">Accessibility</a> this method would return a String containing the text: 'Accessibility'. Similarly, from this HTML: <a HREF="#top"><img src="top-hat.gif" alt="top hat"></a> this might return the object ImageIcon("top-hat.gif", "top hat");
Parameters:
i - zero-based index of the actions
Returns:
an Object representing the hypertext anchor
See Also:
getAccessibleActionCount()

getStartIndex

public abstract int getStartIndex()
Get the index with the hypertext document at which this link begins
Returns:
index of start of link

getEndIndex

public abstract int getEndIndex()
Get the index with the hypertext document at which this link ends
Returns:
index of end of link

JavaTM 2 Platform
Standard Edition

Submit a bug or feature
Java, Java 2D, and JDBC are a trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1999 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.