<html> <head> <title>Interface XAccessibleHyperlink</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link rel="stylesheet" type="text/css" href="../../../../idl.css"> </head> <body> <div id="adc-idlref"> <a name="_top_"> </a><table class="navimain" border="0" cellpadding="3"> <tr> <td class="navimain"><a href="../module-ix.html" class="navimain">Overview</a></td> <td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td> <td class="navimain"><a href="XAccessibleHyperlink-xref.html" class="navimain">Use</a></td> <td class="navimain"><a href="http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/Accessibility/XAccessibleHyperlink" class="navimain">Devguide</a></td> <td class="navimain"><a href="../../../../index-files/index-1.html" class="navimain">Index</a></td> </tr> </table> <table class="navisub" border="0" cellpadding="0"> <tr> <td class="navisub"><a href="#MethodsSummary" class="navisub">Methods' Summary</a></td> <td class="navisub">Attributes' Summary</td> <td class="navisub"><a href="#MethodsDetails" class="navisub">Methods' Details</a></td> <td class="navisub">Attributes' Details</td> </tr> </table> <hr> <table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;"> <tr> <td><p class="namechain"><a href="../../../../module-ix.html" class="namechain">::</a> <a href="../../../module-ix.html" class="namechain">com</a> :: <a href="../../module-ix.html" class="namechain">sun</a> :: <a href="../module-ix.html" class="namechain">star</a> :: <a href="module-ix.html" class="namechain">accessibility</a> :: </p> </td> </tr> <tr> <td class="title">interface XAccessibleHyperlink</td> </tr> <tr> <td><dl> <dt><b>Base Interfaces</b></dt> <dd><pre style="font-family:monospace;"><strong>XAccessibleHyperlink</strong> ┗ <a href="XAccessibleAction.html">XAccessibleAction</a> </pre></dd> <dd><a name/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="crosstitle"> <tr> <td class="imsum_left"><a href="XAccessibleAction.html">XAccessibleAction</a></td> <td class="imsum_right"><dl> <dt>(referenced interface's summary:)</dt> <dd>Implement this interface to give access to actions that can be executed for accessible objects. </dd> </dl> </td> </tr> </table> </dd> </dl> </td> </tr> <tr> <td><dl> <dt><b>Description</b></dt> <dd>Implement this interface to represent a hyperlink or a group of hyperlinks. </dd> <dd><p>Single hyperlinks correspond to simple <a href> tags. Groups of hyperlinks are contained in client side image maps. Linked objects and anchors are implementation dependent. This interface inherits the <a href="XAccessibleAction.html">XAccessibleAction</a> interface. Especially that interface's <a href="XAccessibleAction.html">XAccessibleAction</a>::<a href="XAccessibleAction.html#getActionCount">getActionCount</a> method is needed to obtain a maximum value for the indices passed to the <a href="XAccessibleHyperlink.html#getAccessibleActionAnchor">getAccessibleActionAnchor</a> and <a href="XAccessibleHyperlink.html#getAccessibleActionObject">getAccessibleActionObject</a> methods.</p> <p>Furthermore, the object that implements this interface has to be connected implicitly or explicitly with an object that implements the the <a href="XAccessibleText.html">XAccessibleText</a> interface. The <a href="XAccessibleHyperlink.html#getStartIndex">getStartIndex</a> and <a href="XAccessibleHyperlink.html#getEndIndex">getEndIndex</a> methods return indices with respect to the text exposed by that interface.</p> </dd> <dt><b>Since </b></dt> <dd>OOo 1.1.2</dd> </dl> <a name="devmanual"> </a><dl> <dt><b>Developers Guide</b></dt> <dd><a href="http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/Accessibility/XAccessibleHyperlink">Accessibility - XAccessibleHyperlink</a></dd> </dl> </td> </tr> </table> <hr> <a name="MethodsSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Methods' Summary</td> </tr> <tr> <td class="imsum_left"><a href="#getAccessibleActionAnchor">getAccessibleActionAnchor</a></td> <td class="imsum_right">Returns an object that represents the link anchor, as appropriate for that link. </td> </tr> <tr> <td class="imsum_left"><a href="#getAccessibleActionObject">getAccessibleActionObject</a></td> <td class="imsum_right">Returns an object that represents the link anchor, as appropriate for that link. </td> </tr> <tr> <td class="imsum_left"><a href="#getStartIndex">getStartIndex</a></td> <td class="imsum_right">Returns the index at which the textual representation of the hyperlink (group) starts. </td> </tr> <tr> <td class="imsum_left"><a href="#getEndIndex">getEndIndex</a></td> <td class="imsum_right">Returns the index at which the textual representation of the hyperlink (group) ends. </td> </tr> <tr> <td class="imsum_left"><a href="#isValid">isValid</a></td> <td class="imsum_right">Returns whether the document referenced by this links is still valid. </td> </tr> </table> <a name="MethodsDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle">Methods' Details</td> </tr> <tr> <td class="imdetail"><a name="getAccessibleActionAnchor" class="membertitle">getAccessibleActionAnchor</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3">any</td> </tr> <tr> <td valign="top"><b>getAccessibleActionAnchor</b>(</td> <td valign="top">[in] long</td> <td valign="bottom"> nIndex )</td> </tr> <tr> <td valign="top" align="right">raises( </td> <td valign="top" colspan="2">::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/IndexOutOfBoundsException.html">IndexOutOfBoundsException</a> );</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>Returns an object that represents the link anchor, as appropriate for that link. </dd> <dd><p>For an HTML link for example, this method would return the string enclosed by the <&a href> tag.</p> </dd> <dt><b>Parameter nIndex</b></dt> <dd>This index identifies the anchor when, as in the case of an image map, there is more than one link represented by this object. The valid maximal index can be determined by calling the <a href="XAccessibleAction.html">XAccessibleAction</a>::<a href="XAccessibleAction.html#getActionCount">getActionCount</a> method. </dd> <dt><b>Returns</b></dt> <dd>If the index is not valid then an exception is thrown. Otherwise it returns an implementation dependent value. </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="getAccessibleActionObject" class="membertitle">getAccessibleActionObject</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3">any</td> </tr> <tr> <td valign="top"><b>getAccessibleActionObject</b>(</td> <td valign="top">[in] long</td> <td valign="bottom"> nIndex )</td> </tr> <tr> <td valign="top" align="right">raises( </td> <td valign="top" colspan="2">::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/IndexOutOfBoundsException.html">IndexOutOfBoundsException</a> );</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>Returns an object that represents the link anchor, as appropriate for that link. </dd> <dd><p>For an HTML link for example, this method would return the URL of the <&a href> tag.</p> </dd> <dt><b>Parameter nIndex</b></dt> <dd>This index identifies the action object when, as in the case of an image map, there is more than one link represented by this object. The valid maximal index can be determined by calling the <a href="XAccessibleAction.html">XAccessibleAction</a>::<a href="XAccessibleAction.html#getActionCount">getActionCount</a> method. </dd> <dt><b>Returns</b></dt> <dd>If the index is not valid then an exception is thrown. Otherwise it returns an implementation dependent value. </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="getStartIndex" class="membertitle">getStartIndex</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3">long</td> </tr> <tr> <td valign="top"><b>getStartIndex</b>();</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>Returns the index at which the textual representation of the hyperlink (group) starts. </dd> <dd><p>The returned value relates to the <a href="XAccessibleText.html">XAccessibleText</a> interface that owns this hyperlink.</p> </dd> <dt><b>Returns</b></dt> <dd>The index relates to the text exposed by the <a href="XAccessibleHypertext.html">XAccessibleHypertext</a> interface. </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="getEndIndex" class="membertitle">getEndIndex</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3">long</td> </tr> <tr> <td valign="top"><b>getEndIndex</b>();</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>Returns the index at which the textual representation of the hyperlink (group) ends. </dd> <dd><p>The returned value relates to the <a href="XAccessibleText.html">XAccessibleText</a> interface that owns this hyperlink.</p> </dd> <dt><b>Returns</b></dt> <dd>The index relates to the text exposed by the <a href="XAccessibleText.html">XAccessibleText</a> interface. </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="isValid" class="membertitle">isValid</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3">boolean</td> </tr> <tr> <td valign="top"><b>isValid</b>();</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>Returns whether the document referenced by this links is still valid. </dd> <dd><p>This is a volatile state that may change without further warning like e.g. sending an appropriate event.</p> </dd> <dt><b>Returns</b></dt> <dd>Returns <b>true</b> if the referenced document is still valid and <b>false</b> otherwise. </dd> </dl> </td> </tr> </table> </td> </tr> </table> <a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2000, 2012 LibreOffice contributors and/or their affiliates. All rights reserved.</p><p class="copyright" align="center">LibreOffice was created by The Document Foundation, based on OpenOffice.org, which is Copyright 2000, 2010 Oracle and/or its affiliates.</p><p class="copyright" align="center">The Document Foundation acknowledges all community members, please find more info <a href="http://www.libreoffice.org/about-us/credits/" target="_blank">at our website</a>.<p> </p><p class="copyright" align="center"><a href="http://www.libreoffice.org/privacy" target="_blank">Privacy Policy</a> | <a href="http://www.libreoffice.org/imprint" target="_blank">Impressum (Legal Info)</a> | Copyright information: The source code of LibreOffice is licensed under the GNU Lesser General Public License (<a href="http://www.libreoffice.org/download/license/" target="_blank">LGPLv3</a>). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our <a href="http://wiki.documentfoundation.org/TradeMark_Policy" target="_blank">trademark policy</a>.</p> </div> <!-- id="adc-idlref" --> </body> </html>