AtkHyperlink

Name

AtkHyperlink -- An ATK object which encapsulates a link or set of links in a hypertext document.

Synopsis



struct      AtkHyperlink;
gchar*      atk_hyperlink_get_uri           (AtkHyperlink *link,
                                             gint i);
AtkObject*  atk_hyperlink_get_object        (AtkHyperlink *link,
                                             gint i);
gint        atk_hyperlink_get_end_index     (AtkHyperlink *link);
gint        atk_hyperlink_get_start_index   (AtkHyperlink *link);
gboolean    atk_hyperlink_is_valid          (AtkHyperlink *link);
gint        atk_hyperlink_get_n_anchors     (AtkHyperlink *link);

Object Hierarchy


  GObject
   +----AtkHyperlink

Implemented Interfaces

AtkHyperlink implements AtkAction.

Description

An ATK object which encapsulates a link or set of links in a hypertext document. It implements the AtkAction interface.

Details

struct AtkHyperlink

struct AtkHyperlink;

The AtkHyperlink structure should not be accessed directly.


atk_hyperlink_get_uri ()

gchar*      atk_hyperlink_get_uri           (AtkHyperlink *link,
                                             gint i);

Get a the URI associated with the anchor specified by i of link.

Multiple anchors are primarily used by client-side image maps.

link :

an AtkHyperlink

i :

a (zero-index) integer specifying the desired anchor

Returns :

a string specifying the URI


atk_hyperlink_get_object ()

AtkObject*  atk_hyperlink_get_object        (AtkHyperlink *link,
                                             gint i);

Returns the item associated with this hyperlinks nth anchor. For instance, the returned AtkObject will implement AtkText if link is a text hyperlink, AtkImage if link is an image hyperlink etc.

Multiple anchors are primarily used by client-side image maps.

link :

an AtkHyperlink

i :

a (zero-index) integer specifying the desired anchor

Returns :

an AtkObject associated with this hyperlinks i-th anchor


atk_hyperlink_get_end_index ()

gint        atk_hyperlink_get_end_index     (AtkHyperlink *link);

Gets the index with the hypertext document at which this link ends.

link :

an AtkHyperlink

Returns :

the index with the hypertext document at which this link ends


atk_hyperlink_get_start_index ()

gint        atk_hyperlink_get_start_index   (AtkHyperlink *link);

Gets the index with the hypertext document at which this link begins.

link :

an AtkHyperlink

Returns :

the index with the hypertext document at which this link begins


atk_hyperlink_is_valid ()

gboolean    atk_hyperlink_is_valid          (AtkHyperlink *link);

Since the document that a link is associated with may have changed this method returns TRUE if the link is still valid (with respect to the document it references) and FALSE otherwise.

link :

an AtkHyperlink

Returns :

whether or not this link is still valid


atk_hyperlink_get_n_anchors ()

gint        atk_hyperlink_get_n_anchors     (AtkHyperlink *link);

Gets the number of anchors associated with this hyperlink.

link :

an AtkHyperlink

Returns :

the number of anchors associated with this hyperlink