atk.Hypertext — the ATK interface which provides standard mechanism for manipulating hyperlinks.


class atk.Hypertext(gobject.GInterface):
    def get_link(link_index)
def get_n_links()
def get_link_index(char_index)

atk.Hypertext Signal Prototypes


def callback(atkhypertext, index, user_param1, ...)


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



    def get_link(link_index)

link_index :

an integer specifying the desired link

Returns :

the link in this hypertext document at index link_index

Gets the link in this hypertext document at index link_index


    def get_n_links()

Returns :

the number of links within this hypertext document

Gets the number of links within this hypertext document.


    def get_link_index(char_index)

char_index :

a character index

Returns :

an index into the array of hyperlinks in the hypertext

Gets the index into the array of hyperlinks that is associated with the character specified by char_index, or -1 if there is no hyperlink associated with this character.


The "link-selected" atk.Hypertext Signal

    def callback(atkhypertext, index, user_param1, ...)

atkhypertext :

the object which received the signal.

index :

the index of the hyperlink which is selected

user_param1 :

the first user parameter (if any) specified with the connect() method

... :

additional user parameters (if any)

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