atspi-hyperlink: libatspi Reference Manual

## atspi-hyperlink atspi-hyperlink — Instances of atspi-hyperlink are the means by which end users and clients interact with linked content. |

## Functions

gint | atspi_hyperlink_get_n_anchors ()
gchar * | atspi_hyperlink_get_uri ()
AtspiAccessible * | atspi_hyperlink_get_object ()
AtspiRange * | atspi_hyperlink_get_index_range ()
gint | atspi_hyperlink_get_start_index ()
gint | atspi_hyperlink_get_end_index ()
gboolean | atspi_hyperlink_is_valid ()

## Types and Values

| AtspiHyperlink
struct | AtspiHyperlinkClass

## Object Hierarchy

        GObject
        ╰── AtspiObject
            ╰── AtspiHyperlink

## Description

Instances of atspi-hyperlink are returned by atspi-hypertext objects, and are the means by which end users and clients interact with linked, and in some cases embedded, content. These instances may have multiple "anchors", where an anchor corresponds to a reference to a particular resource with a corresponding resource identified (URI).

## Functions

### atspi_hyperlink_get_n_anchors ()

    gint
    atspi_hyperlink_get_n_anchors (AtspiHyperlink *obj,
                                   GError **error);

Gets the total number of anchors which an AtspiHyperlink 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: atspi_hyperlink_get_uri and atspi_hyperlink_get_object.

#### Parameters

obj | a pointer to the AtspiHyperlink object on which to operate. |

#### Returns

a gint indicating the number of anchors in this hyperlink.

### atspi_hyperlink_get_uri ()

    gchar *
    atspi_hyperlink_get_uri (AtspiHyperlink *obj,
                             int i,
                             GError **error);

Gets the URI associated with a particular hyperlink anchor.

#### Parameters

obj | a pointer to the AtspiHyperlink implementor on which to operate. |
i | a (zero-index) integer indicating which hyperlink anchor to query. |

#### Returns

a UTF-8 string giving the URI of the `ith` hyperlink anchor.

### atspi_hyperlink_get_object ()

    AtspiAccessible *
    atspi_hyperlink_get_object (AtspiHyperlink *obj,
                                gint i,
                                GError **error);

Gets the object associated with a particular hyperlink anchor, as an AtspiAccessible.

#### Parameters

obj | a pointer to the AtspiHyperlink implementor on which to operate. |
i | a (zero-index) gint indicating which hyperlink anchor to query. |

#### Returns

an AtspiAccessible that represents the object associated with the `ith` anchor of the specified AtspiHyperlink.

[transfer full]

### atspi_hyperlink_get_index_range ()

    AtspiRange *
    atspi_hyperlink_get_index_range (AtspiHyperlink *obj,
                                     GError **error);

Gets the starting and ending character offsets of the text range associated with an AtspiHyperlink, in its originating AtspiHypertext.

#### Parameters

obj | a pointer to the AtspiHyperlink implementor on which to operate. |

### atspi_hyperlink_get_start_index ()

    gint
    atspi_hyperlink_get_start_index (AtspiHyperlink *obj,
                                     GError **error);

Gets the starting character offset of the text range associated with an AtspiHyperlink, in its originating AtspiHypertext.

#### Parameters

obj | a pointer to the AtspiHyperlink implementor on which to operate. |

### atspi_hyperlink_get_end_index ()

    gint
    atspi_hyperlink_get_end_index (AtspiHyperlink *obj,
                                   GError **error);

Gets the ending character offset of the text range associated with an AtspiHyperlink, in its originating AtspiHypertext.

#### Parameters

obj | a pointer to the AtspiHyperlink implementor on which to operate. |

### atspi_hyperlink_is_valid ()

    gboolean
    atspi_hyperlink_is_valid (AtspiHyperlink *obj,
                              GError **error);

Tells whether an AtspiHyperlink object is still valid with respect to its originating hypertext object.

#### Parameters

obj | a pointer to the AtspiHyperlink on which to operate. |

#### Returns

TRUE if the specified AtspiHyperlink is still valid with respect to its originating AtspiHypertext object, FALSE otherwise.

## Types and Values

### AtspiHyperlink

    typedef struct _AtspiHyperlink AtspiHyperlink;

### struct AtspiHyperlinkClass

    struct AtspiHyperlinkClass {
      AtspiObjectClass parent_class;
    };