Release atk 1.32.0
[atk.git] / docs / tmpl / atkhypertext.sgml
blobc3f1c01e56ceba5f237131a4ede8e30268bcf546
1 <!-- ##### SECTION Title ##### -->
2 AtkHypertext
4 <!-- ##### SECTION Short_Description ##### -->
5 The ATK interface which provides standard mechanism for manipulating hyperlinks.
7 <!-- ##### SECTION Long_Description ##### -->
8 <para>
9 An interface used for objects which implement linking between multiple
10 resource or content locations, or multiple 'markers' within a single
11 document. A Hypertext instance is associated with one or more Hyperlinks,
12 which are associated with particular offsets within the Hypertext's included
13 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.
14 </para>
16 <!-- ##### SECTION See_Also ##### -->
17 <para>
18 AtkHyperlink
19 </para>
21 <!-- ##### SECTION Stability_Level ##### -->
24 <!-- ##### SECTION Image ##### -->
27 <!-- ##### STRUCT AtkHypertext ##### -->
28 <para>
29 The AtkHypertext structure does not contain any fields.
30 </para>
33 <!-- ##### SIGNAL AtkHypertext::link-selected ##### -->
34 <para>
35 The "link-selected" signal is emitted by an AtkHyperText object when one of
36 the hyperlinks associated with the object is selected.
37 </para>
39 @atkhypertext: the object which received the signal.
40 @arg1: the index of the hyperlink which is selected
42 <!-- ##### FUNCTION atk_hypertext_get_link ##### -->
43 <para>
45 </para>
47 @hypertext:
48 @link_index:
49 @Returns:
52 <!-- ##### FUNCTION atk_hypertext_get_n_links ##### -->
53 <para>
55 </para>
57 @hypertext:
58 @Returns:
61 <!-- ##### FUNCTION atk_hypertext_get_link_index ##### -->
62 <para>
64 </para>
66 @hypertext:
67 @char_index:
68 @Returns: