JavaTM 2 Platform Std. Ed. v1.6.0
javax.accessibility
Class AccessibleHyperlink
java.lang.Object
javax.accessibility.AccessibleHyperlink
- All Implemented Interfaces:
- AccessibleAction
- 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()
Method Summary |
abstract boolean |
doAccessibleAction(int i)
Performs the specified Action on the object |
abstract Object |
getAccessibleActionAnchor(int i)
Returns 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)
Returns a String description of this particular
link action. |
abstract Object |
getAccessibleActionObject(int i)
Returns an object that represents the link action,
as appropriate for that link. |
abstract int |
getEndIndex()
Gets the index with the hypertext document at which this
link ends |
abstract int |
getStartIndex()
Gets 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 or not this Link is still valid
(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 |
AccessibleHyperlink
public AccessibleHyperlink()
isValid
public abstract boolean isValid()
- Since the document a link is associated with may have
changed, this method returns whether or not this Link is still valid
(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)
- Performs the specified Action on the object
- Specified by:
doAccessibleAction in interface AccessibleAction
- Parameters:
i - zero-based index of actions
- Returns:
- true if the action was performed; otherwise false.
- See Also:
getAccessibleActionCount()
getAccessibleActionDescription
public abstract String getAccessibleActionDescription(int i)
- Returns 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 class="javasearch" HREF="http://www.sun.com/access">Accessibility</a>
this method would return "Accessibility".
Similarly, from this HTML:
<a class="javasearch" 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)
- Returns an object that represents the link action,
as appropriate for that link. E.g. from HTML:
<a class="javasearch" 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)
- Returns 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 class="javasearch" 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()
- Gets the index with the hypertext document at which this
link begins
- Returns:
- index of start of link
getEndIndex
public abstract int getEndIndex()
- Gets the index with the hypertext document at which this
link ends
- Returns:
- index of end of link
Copyright 2003 Sun Microsystems, Inc. All rights reserved
|