Added descriptive documentation of the ATK interfaces, primarily
[atk.git] / docs / tmpl / atkselection.sgml
blob2ace0a41727de21b0a6c8f8405d7abf7483ddec7
1 <!-- ##### SECTION Title ##### -->
2 AtkSelection
4 <!-- ##### SECTION Short_Description ##### -->
6 ATK Interface implemented by container objects whose #AtkObject children
7 can be selected.
8 <!-- ##### SECTION Long_Description ##### -->
9 <para>
10 #AtkSelection should be implemented by UI components with children which
11 are exposed by #atk_object_ref_child and #atk_object_get_n_children, if
12 the use of the parent UI component ordinarily involves selection of one
13 or more of the objects corresponding to those #AtkObject children - for
14 example, selectable lists.
15 </para>
16 <para>
17 Note that other types of "selection" (for instance text selection) are
18 accomplished a other ATK interfaces - #AtkSelection is limited to the
19 selection/deselection of children.
20 </para>
21 <!-- ##### SECTION See_Also ##### -->
22 <para>
23 #AtkText
24 </para>
26 <!-- ##### STRUCT AtkSelection ##### -->
27 <para>
29 </para>
32 <!-- ##### STRUCT AtkSelectionIface ##### -->
33 <para>
35 </para>
37 @parent:
38 @add_selection:
39 @clear_selection:
40 @ref_selection:
41 @get_selection_count:
42 @is_child_selected:
43 @remove_selection:
44 @select_all_selection:
45 @selection_changed:
47 <!-- ##### FUNCTION atk_selection_add_selection ##### -->
48 <para>
50 </para>
52 @selection:
53 @i:
54 @Returns:
57 <!-- ##### FUNCTION atk_selection_clear_selection ##### -->
58 <para>
60 </para>
62 @selection:
63 @Returns:
66 <!-- ##### FUNCTION atk_selection_ref_selection ##### -->
67 <para>
69 </para>
71 @selection:
72 @i:
73 @Returns:
76 <!-- ##### FUNCTION atk_selection_get_selection_count ##### -->
77 <para>
79 </para>
81 @selection:
82 @Returns:
85 <!-- ##### FUNCTION atk_selection_is_child_selected ##### -->
86 <para>
88 </para>
90 @selection:
91 @i:
92 @Returns:
95 <!-- ##### FUNCTION atk_selection_remove_selection ##### -->
96 <para>
98 </para>
100 @selection:
101 @i:
102 @Returns:
105 <!-- ##### FUNCTION atk_selection_select_all_selection ##### -->
106 <para>
108 </para>
110 @selection:
111 @Returns: