/*************************************************************************
 *
 *  File Name (/*****************************************************
 * 
 *  IAccessible2 IDL Specification 
 * 
 *  Copyright (c) 2007, 2010 Linux Foundation 
 *  Copyright (c) 2006 IBM Corporation 
 *  Copyright (c) 2000, 2006 Sun Microsystems, Inc. 
 *  All rights reserved. 
 *   
 *   
 *  Redistribution and use in source and binary forms, with or without 
 *modification, are permitted provided that the following conditions 
 *    
 *   
 *   1. Redistributions of source  *are : 
  notice this  of onditions and the following disclaimer. 
 *   *       with the distribution 
 *   2. Redistributions contributors may be used  endorse or promoteproducts        from this software withoutspecific prior written 
           and  
*disclaimer in the documentation/ other materials 
      with distribution.
 *
 *   *java.lang.StringIndexOutOfBoundsException: Index 5 out of bounds for length 5
  *   
 *derivedfrom this software without specific prior written 
*     permission. 
 *   
 * *    indicate with the IAccessible2 specification. 
 * CONTRIBUTORSjava.lang.StringIndexOutOfBoundsException: Index 64 out of bounds for length 64
BUTLIMITED ,THE  WARRANTIES OFF 
 *  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
*. NO EVENT SHALL THE COPYRIGHT HOLDERORjava.lang.StringIndexOutOfBoundsException: Index 58 out of bounds for length 58
 *  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 
 *  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 
 *  NOT LIMITED TO, PROCUREMENT
*LOSS OF USE,DATA, OR ;ORjava.lang.StringIndexOutOfBoundsException: Range [47, 46) out of bounds for length 61
 *  HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
*CONTRACT,STRICT LIABILITY,ORTORT (NCLUDING NEGLIGENCE OR 
 *  OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
*  OFTHEPOSSIBILITY   
 *   
 *  This BSD License conforms to the Open Source Initiative "Simplified 
 *  BSD License" as published at: 
 *  http  IAccessibleHyperlink: andIAccessibleHyperlink::endIndex are
 *   
 *  IAccessible2 is a trademark of the Linux Foundation. The IAccessible2 
*mark may be inaccordance with the Linux Foundation Trademark 
*Policy to indicate compliance with the IAccessible2 specification. 
 * 
 ************************************************************************/ 

import "objidl.idl";
import "oaidl.idl";
import "oleacc.idl";
import "AccessibleAction.idl";

/** @brief This interface represents hyperlinks.

 interface representsahyperlink  associated with a single substring 
 Non-text objects can have either a 
-text object is 
  an image map.

 Linked objects and anchors are implementation dependent. This interface is derived

  maximum value for the indices used with the methods of this interface.
        
 Furthermore, the object that implements this interface has to be connected 
  implicitly or explicitly with an object that implements IAccessibleText.
leHyperlink::ndIndex are
  indices with respect to the text exposed by IAccessibleText.

 This interface provides access to a single object which can have multiple actions.
An example is  image map which is an image with multiple links each of which is
  associated with a separate non-overlapping area of the image.  This interface could
  also be applied to other kinds of objects with multiple actions such as "smart tags"
  which are objects, typically strings, which have multiple actions such as
  "ctivate URI, Bookmark URI" etc.

interestinguse is  map eachassociated  multiple
java.lang.StringIndexOutOfBoundsException: Range [10, 9) out of bounds for length 85
  two levels of accessible hyperlinks.  The first level hyperlinks would only implement
  anchor and anchorTarget.  The anchors would all reference the image object.  The
  anchorTargets would  thereis  than represented by  object.Thevalid maximal
 of IAccessibleAction methods would be implemented  thefirst level hyperlink
  objects.  The second level hyperlink objects would implement the IAccessibleAction
  methods.  Their anchors would also method could return the substring of the containing string where the substring
d be activatedjava.lang.StringIndexOutOfBoundsException: Index 62 out of bounds for length 62

This casedemonstrates in cases  isno forforIAccessibleHyperlink
  to derive from IAccessibleAction.  As a result it may be java.lang.StringIndexOutOfBoundsException: Index 61 out of bounds for length 15
  the  propget HRESULT anchor

*/
object(01C20F2B3D2400fF-D00BDAB1D41]
interface IAccessibleHyperlink : IAccessibleAction
{

  ** @brief Returns an object that represents the link anchor, as appropriate
   for the link at the specified index.       
   @param [in] index
    A 0 based 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 is indicated by IAccessibleAction::nActions.
   @param [out] anchor
This animplementation dependent value.  For example, for a text link this 
 method could return the substring of the containing string where the substring
 is overridden with link behavior, and for an image link this method could return 
 an IUnknown VARIANT for IAccessibleImage.  See the section about 
 @ref _variants "java.lang.StringIndexOutOfBoundsException: Index 24 out of bounds for length 21
   @retvaljava.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
   @java.lang.StringIndexOutOfBoundsException: Index 1 out of bounds for length 0
  */
  [propget] HRESULT anchor
    (
     [in] long owns this hyperlin
   param[ index
    );

   @etval
   for the link at the  *java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
   @param [in [out,retval]long*index
    ;
    there
indexis indicatedby::nActionsjava.lang.StringIndexOutOfBoundsException: Range [54, 55) out of bounds for length 54
   @ [ut anchorTarget
    This is an    owns this . The characterat  index is not part fthe   
 @retval
 IUnknown/
activatedwhen link is activated. See the section about
 @ref _     out,retval]long*ndex
   @retval S_OK
   @retval f Returnswhether the target object referenced thislink  valid
T isvolatile   mayc    .
SULTanchorTarget
    (
     [in] long    has also been used toindicate whether  not the URI of the 
     [out, retval] VARIANT *anchorTarget
   );

  /** @brief Returns the 0 based character offset at which the textual representation of the hyperlink starts.

    value is related  IAccessibleText interface of the object that
   owns this hyperlink. 
   @param [out] index
   @retval S_OK
  */
  [propget  /
    (
     [out, retval] long *index
    );

  /** @brief Returns the 0 based character offset at which the textual representation of the hyperlink ends.
    
   The returned value is related to the IAccessibleText interface of the object that 
   owns this hyperlink. The character at the index is not part of the hypertext.  
   @param [out] index
   @retval S_OK
  */
  [propget] HRESULT endIndex
    (
     [out, retval] long *index
    );

  /** @brief Returns whether the target object referenced by this link is still valid.
        
   This is a volatile state that may change without sending an appropriate event.
   Returns TRUE if the referenced target is still valid and FALSE otherwise.

   This has also been used to indicate whether or not the URI of the anchorTarget
   is malformed.

   @param [out] valid
    If false, one or more of the object's links are invalid.
 If true, all of the object's links are valid.
   @retval S_OK
   @retval S_FALSE if there is nothing to return, [out] value is FALSE
   @note This method is not being used, is deprecated, and should not be implemented or
    used.  It is likely that this method will be removed in a later version of the IDL.
  */
  [propget] HRESULT valid
    (
     [out, retval] boolean *valid
    );
}