AtkHypertext

AtkHypertext — The ATK interface which provides standard mechanism for manipulating hyperlinks.

Synopsis




            AtkHypertext;
AtkHyperlink* atk_hypertext_get_link        (AtkHypertext *hypertext,
                                             gint link_index);
gint        atk_hypertext_get_n_links       (AtkHypertext *hypertext);
gint        atk_hypertext_get_link_index    (AtkHypertext *hypertext,
                                             gint char_index);

Object Hierarchy


  GInterface
   +----AtkHypertext

Known Implementations

AtkHypertext is implemented by AtkNoOpObject.

Signals


"link-selected"
            void        user_function      (AtkHypertext *atkhypertext,
                                            gint          arg1,
                                            gpointer      user_data)         : Run last

Description

An interface used for objects which implement linking between multiple resource or content locations, or multiple 'markers' within a single document. A Hypertext instance is associated with one or more Hyperlinks, which are associated with particular offsets within the Hypertext's included content. While this interface is derived from Text, there is no requirement that Hypertext instances have textual content; they may implement Image as well, and Hyperlinks need not have non-zero text offsets.

Details

AtkHypertext

typedef struct _AtkHypertext AtkHypertext;

The AtkHypertext structure does not contain any fields.


atk_hypertext_get_link ()

AtkHyperlink* atk_hypertext_get_link        (AtkHypertext *hypertext,
                                             gint link_index);

Gets the link in this hypertext document at index link_index

hypertext : an AtkHypertext
link_index : an integer specifying the desired link
Returns : the link in this hypertext document at index link_index

atk_hypertext_get_n_links ()

gint        atk_hypertext_get_n_links       (AtkHypertext *hypertext);

Gets the number of links within this hypertext document.

hypertext : an AtkHypertext
Returns : the number of links within this hypertext document

atk_hypertext_get_link_index ()

gint        atk_hypertext_get_link_index    (AtkHypertext *hypertext,
                                             gint char_index);

Gets the index into the array of hyperlinks that is associated with the character specified by char_index.

hypertext : an AtkHypertext
char_index : a character index
Returns : an index into the array of hyperlinks in hypertext, or -1 if there is no hyperlink associated with this character.

Signal Details

The "link-selected" signal

void        user_function                  (AtkHypertext *atkhypertext,
                                            gint          arg1,
                                            gpointer      user_data)         : Run last

The "link-selected" signal is emitted by an AtkHyperText object when one of the hyperlinks associated with the object is selected.

atkhypertext : the object which received the signal.
arg1 : the index of the hyperlink which is selected
user_data : user data set when the signal handler was connected.

See Also

AtkHyperlink