atk.Hypertext — the ATK interface which provides standard mechanism for manipulating hyperlinks.
class atk.Hypertext(gobject.GInterface): |
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
)
| 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
)
| 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.
def callback(atkhypertext
, index
, user_param1
, ...
)
| the object which received the signal. |
| the index of the hyperlink which is selected |
| the first user parameter (if any) specified
with the connect () |
| 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.