## AccessibleHyperlink Interface

AccessibleHyperlink Interface —

##

# Synopsis

    void        AccessibleHyperlink_ref         (AccessibleHyperlink *obj);
    void        AccessibleHyperlink_unref       (AccessibleHyperlink *obj);
    long        AccessibleHyperlink_getNAnchors (AccessibleHyperlink *obj);
    void        AccessibleHyperlink_getIndexRange
                                                (AccessibleHyperlink *obj,
                                                 long int *startIndex,
                                                 long int *endIndex);
    Accessible* AccessibleHyperlink_getObject   (AccessibleHyperlink *obj,
                                                 long int i);
    char*       AccessibleHyperlink_getURI      (AccessibleHyperlink *obj,
                                                 long int i);
    SPIBoolean  AccessibleHyperlink_isValid     (AccessibleHyperlink *obj);

## Description

## Details

### AccessibleHyperlink_ref ()

    void        AccessibleHyperlink_ref         (AccessibleHyperlink *obj);

Increment the reference count for an AccessibleHyperlink object.

`obj` : | a pointer to the AccessibleHyperlink object on which to operate.

### AccessibleHyperlink_unref ()

    void        AccessibleHyperlink_unref       (AccessibleHyperlink *obj);

Decrement the reference count for an AccessibleHyperlink object.

`obj` : | a pointer to the AccessibleHyperlink object on which to operate.

### AccessibleHyperlink_getNAnchors ()

    long        AccessibleHyperlink_getNAnchors (AccessibleHyperlink *obj);

Get the total number of anchors which an AccessibleHyperlink implementor has. Though typical hyperlinks have only one anchor, client-side image maps and other hypertext objects may potentially activate or refer to multiple URIs. For each anchor there is a corresponding URI and object. `see` AccessibleHyperlink_getURI() and AccessibleHyperlink_getObject().

`obj` : | a pointer to the AccessibleHyperlink object on which to operate.
Returns : | a long indicating the number of anchors in this hyperlink.

### AccessibleHyperlink_getIndexRange ()

    void        AccessibleHyperlink_getIndexRange
                                                (AccessibleHyperlink *obj,
                                                 long int *startIndex,
                                                 long int *endIndex);

Get the starting and ending character offsets of the text range associated with a AccessibleHyperlink, in its originating AccessibleHypertext.

`obj` : | a pointer to the AccessibleHyperlink implementor on which to operate.
`startIndex` : | a pointer to a long integer into which the starting offset of the text associated with this AccessibleHyperlink is returned.
`endIndex` : | a pointer to a long integer into which the offset of the first character after the text associated with this AccessibleHyperlink is returned.

### AccessibleHyperlink_getObject ()

    Accessible* AccessibleHyperlink_getObject   (AccessibleHyperlink *obj,
                                                 long int i);

Get the object associated with a particular hyperlink anchor, as an Accessible.

`obj` : | a pointer to the AccessibleHyperlink implementor on which to operate.
`i` : | a (zero-index) long integer indicating which hyperlink anchor to query.
Returns : | an Accessible that represents the object associated with the `ith` anchor of the specified AccessibleHyperlink.

### AccessibleHyperlink_getURI ()

    char*       AccessibleHyperlink_getURI      (AccessibleHyperlink *obj,
                                                 long int i);

Get the URI associated with a particular hyperlink anchor.

`obj` : | a pointer to the AccessibleHyperlink implementor on which to operate.
`i` : | a (zero-index) long integer indicating which hyperlink anchor to query.
Returns : | a UTF-8 string giving the URI of the `ith` hyperlink anchor.

### AccessibleHyperlink_isValid ()

    SPIBoolean  AccessibleHyperlink_isValid     (AccessibleHyperlink *obj);

Tell whether an AccessibleHyperlink object is still valid with respect to its originating hypertext object.

`obj` : | a pointer to the AccessibleHyperlink on which to operate.
Returns : | TRUE of the specified AccessibleHyperlink is still valid with respect to its originating AccessibleHypertext object, FALSE otherwise.