← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gtk/xml/gtklist.xml

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-05-04 12:24:25 UTC
  • mfrom: (1.1.21 upstream)
  • Revision ID: james.westby@ubuntu.com-20070504122425-0m8midgzrp40y8w2
Tags: 2.10.12-1ubuntu1
* Sync with Debian
* New upstream version:
  Fixed bugs:
  - 379414 file chooser warnings when changing path in the entry
  - 418585 GtkFileChooserDefault sizing code is not DPI independent
  - 419568 Crash in search if start with special letter
  - 435062 build dies with icon cache validation
  - 379399 Segfault to call gtk_print_operation_run twice.
  - 387889 cups backend has problems when there are too many printers
  - 418531 invalid read to gtkicontheme.c gtk_icon_theme_lookup_icon...
  - 423916 crash in color scheme code
  - 424042 Segmentation fault while quickly pressing Alt+arrows
  - 415260 Protect against negative indices when setting values in G...
  - 419171 XGetVisualInfo() may not set nxvisuals
  - 128852 Gdk cursors don't look good on win32
  - 344657 Ctrl-H doesn't toggle "Show Hidden Files" setting
  - 345345 PrintOperation::paginate is not emitted for class handler
  - 347567 GtkPrintOperation::end-print is not emitted if it's cance...
  - 369112 gtk_ui_manager_add_ui should accept unnamed separator
  - 392015 Selected menu item invisible on Windows Vista
  - 399253 MS-Windows Theme Bottom Tab placement rendering glitches
  - 399425 gtk_input_dialog_fill_axes() adds child to gtkscrolledwin...
  - 403251 [patch] little memory leak in GtkPrintJob
  - 403267 [patch] memory leak in GtkPageSetupUnixDialog
  - 403470 MS-Windows Theme tab placement other than on top leaks a ...
  - 404506 Windows system fonts that have multi-byte font names cann...
  - 405089 Incorrect window placement for GtkEventBox private window
  - 405515 Minor leak in gtkfilesystemmodel.c
  - 405539 gdk_pixbuf_save() for PNG saver can return FALSE without ...
  - 415681 gdk_window_clear_area includes an extra line and column o...
  - 418219 GtkRecentChooser should apply filter before sorting and c...
  - 418403 Scroll to printer after selecting it from settings
  - 421985 _gtk_print_operation_platform_backend_launch_preview
  - 421990 gtk_print_job_get_surface
  - 421993 gtk_print_operation_init
  - 423064 Conditional jump or move depends on uninitialised value(s...
  - 423722 Fix printing header in gtk-demo
  - 424168 gtk_print_operation_run on async preview
  - 425655 Don't install gtk+-unix-print-2.0.pc on non-UNIX platforms
  - 425786 GDK segfaults if XineramaQueryScreens fails
  - 428665 Lpr Backend gets stuck in infinite loop during gtk_enumer...
  - 429902 GtkPrintOperation leaks cairo contextes
  - 431997 First delay of GdkPixbufAnimationIter is wrong
  - 433242 Inconsistent scroll arrow position calculations
  - 433972 Placing gtk.Expander inside a gtk.TextView() changes gtk....
  - 434261 _gtk_toolbar_elide_underscores incorrectly handles some s...
  - 383354 ctrl-L should make 'Location' entry disappear
  - 418673 gtk_recent_manager_add_item
  - 429732 gtk_accel_group_finalize accesses invalid memory
  - 435028 WM_CLIENT_LEADER is wrong on the leader_window
  - 431067 Background of the header window is not updated
  - 338843 add recent files support inside the ui manager
  - 148535 add drop shadow to menus, tooltips, etc. under Windows XP
* debian/control.in:
  - Conflicts on ubuntulooks (<= 0.9.11-1)
* debian/patches/15_default-fallback-icon-theme.patch:
  - patch from Debian, fallback on gnome icon theme

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/xml/gtklist.xml
 
1
<refentry id="GtkList">
 
2
<refmeta>
 
3
<refentrytitle role="top_of_page">GtkList</refentrytitle>
 
4
<manvolnum>3</manvolnum>
 
5
<refmiscinfo>GTK Library</refmiscinfo>
 
6
</refmeta>
 
7
 
 
8
<refnamediv>
 
9
<refname>GtkList</refname>
 
10
<refpurpose>Widget for packing a list of selectable items</refpurpose>
 
11
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
 
12
</refnamediv>
 
13
 
 
14
<refsynopsisdiv role="synopsis">
 
15
<title role="synopsis.title">Synopsis</title>
 
16
 
 
17
<synopsis>
 
18
 
 
19
#include &lt;gtk/gtk.h&gt;
 
20
 
 
21
 
 
22
                    <link linkend="GtkList-struct">GtkList</link>;
 
23
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-list-new">gtk_list_new</link>                        (void);
 
24
<link linkend="void">void</link>                <link linkend="gtk-list-insert-items">gtk_list_insert_items</link>               (<link linkend="GtkList">GtkList</link> *list,
 
25
                                                         <link linkend="GList">GList</link> *items,
 
26
                                                         <link linkend="gint">gint</link> position);
 
27
<link linkend="void">void</link>                <link linkend="gtk-list-append-items">gtk_list_append_items</link>               (<link linkend="GtkList">GtkList</link> *list,
 
28
                                                         <link linkend="GList">GList</link> *items);
 
29
<link linkend="void">void</link>                <link linkend="gtk-list-prepend-items">gtk_list_prepend_items</link>              (<link linkend="GtkList">GtkList</link> *list,
 
30
                                                         <link linkend="GList">GList</link> *items);
 
31
<link linkend="void">void</link>                <link linkend="gtk-list-remove-items">gtk_list_remove_items</link>               (<link linkend="GtkList">GtkList</link> *list,
 
32
                                                         <link linkend="GList">GList</link> *items);
 
33
<link linkend="void">void</link>                <link linkend="gtk-list-remove-items-no-unref">gtk_list_remove_items_no_unref</link>      (<link linkend="GtkList">GtkList</link> *list,
 
34
                                                         <link linkend="GList">GList</link> *items);
 
35
<link linkend="void">void</link>                <link linkend="gtk-list-clear-items">gtk_list_clear_items</link>                (<link linkend="GtkList">GtkList</link> *list,
 
36
                                                         <link linkend="gint">gint</link> start,
 
37
                                                         <link linkend="gint">gint</link> end);
 
38
<link linkend="void">void</link>                <link linkend="gtk-list-select-item">gtk_list_select_item</link>                (<link linkend="GtkList">GtkList</link> *list,
 
39
                                                         <link linkend="gint">gint</link> item);
 
40
<link linkend="void">void</link>                <link linkend="gtk-list-unselect-item">gtk_list_unselect_item</link>              (<link linkend="GtkList">GtkList</link> *list,
 
41
                                                         <link linkend="gint">gint</link> item);
 
42
<link linkend="void">void</link>                <link linkend="gtk-list-select-child">gtk_list_select_child</link>               (<link linkend="GtkList">GtkList</link> *list,
 
43
                                                         <link linkend="GtkWidget">GtkWidget</link> *child);
 
44
<link linkend="void">void</link>                <link linkend="gtk-list-unselect-child">gtk_list_unselect_child</link>             (<link linkend="GtkList">GtkList</link> *list,
 
45
                                                         <link linkend="GtkWidget">GtkWidget</link> *child);
 
46
<link linkend="gint">gint</link>                <link linkend="gtk-list-child-position">gtk_list_child_position</link>             (<link linkend="GtkList">GtkList</link> *list,
 
47
                                                         <link linkend="GtkWidget">GtkWidget</link> *child);
 
48
<link linkend="void">void</link>                <link linkend="gtk-list-set-selection-mode">gtk_list_set_selection_mode</link>         (<link linkend="GtkList">GtkList</link> *list,
 
49
                                                         <link linkend="GtkSelectionMode">GtkSelectionMode</link> mode);
 
50
<link linkend="void">void</link>                <link linkend="gtk-list-extend-selection">gtk_list_extend_selection</link>           (<link linkend="GtkList">GtkList</link> *list,
 
51
                                                         <link linkend="GtkScrollType">GtkScrollType</link> scroll_type,
 
52
                                                         <link linkend="gfloat">gfloat</link> position,
 
53
                                                         <link linkend="gboolean">gboolean</link> auto_start_selection);
 
54
<link linkend="void">void</link>                <link linkend="gtk-list-start-selection">gtk_list_start_selection</link>            (<link linkend="GtkList">GtkList</link> *list);
 
55
<link linkend="void">void</link>                <link linkend="gtk-list-end-selection">gtk_list_end_selection</link>              (<link linkend="GtkList">GtkList</link> *list);
 
56
<link linkend="void">void</link>                <link linkend="gtk-list-select-all">gtk_list_select_all</link>                 (<link linkend="GtkList">GtkList</link> *list);
 
57
<link linkend="void">void</link>                <link linkend="gtk-list-unselect-all">gtk_list_unselect_all</link>               (<link linkend="GtkList">GtkList</link> *list);
 
58
<link linkend="void">void</link>                <link linkend="gtk-list-scroll-horizontal">gtk_list_scroll_horizontal</link>          (<link linkend="GtkList">GtkList</link> *list,
 
59
                                                         <link linkend="GtkScrollType">GtkScrollType</link> scroll_type,
 
60
                                                         <link linkend="gfloat">gfloat</link> position);
 
61
<link linkend="void">void</link>                <link linkend="gtk-list-scroll-vertical">gtk_list_scroll_vertical</link>            (<link linkend="GtkList">GtkList</link> *list,
 
62
                                                         <link linkend="GtkScrollType">GtkScrollType</link> scroll_type,
 
63
                                                         <link linkend="gfloat">gfloat</link> position);
 
64
<link linkend="void">void</link>                <link linkend="gtk-list-toggle-add-mode">gtk_list_toggle_add_mode</link>            (<link linkend="GtkList">GtkList</link> *list);
 
65
<link linkend="void">void</link>                <link linkend="gtk-list-toggle-focus-row">gtk_list_toggle_focus_row</link>           (<link linkend="GtkList">GtkList</link> *list);
 
66
<link linkend="void">void</link>                <link linkend="gtk-list-toggle-row">gtk_list_toggle_row</link>                 (<link linkend="GtkList">GtkList</link> *list,
 
67
                                                         <link linkend="GtkWidget">GtkWidget</link> *item);
 
68
<link linkend="void">void</link>                <link linkend="gtk-list-undo-selection">gtk_list_undo_selection</link>             (<link linkend="GtkList">GtkList</link> *list);
 
69
<link linkend="void">void</link>                <link linkend="gtk-list-end-drag-selection">gtk_list_end_drag_selection</link>         (<link linkend="GtkList">GtkList</link> *list);
 
70
 
 
71
 
 
72
</synopsis>
 
73
</refsynopsisdiv>
 
74
 
 
75
<refsect1 role="object_hierarchy">
 
76
<title role="object_hierarchy.title">Object Hierarchy</title>
 
77
<synopsis>
 
78
 
 
79
  <link linkend="GObject">GObject</link>
 
80
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
 
81
         +----<link linkend="GtkObject">GtkObject</link>
 
82
               +----<link linkend="GtkWidget">GtkWidget</link>
 
83
                     +----<link linkend="GtkContainer">GtkContainer</link>
 
84
                           +----GtkList
 
85
</synopsis>
 
86
 
 
87
</refsect1>
 
88
 
 
89
 
 
90
 
 
91
<refsect1 role="impl_interfaces">
 
92
<title role="impl_interfaces.title">Implemented Interfaces</title>
 
93
<para>
 
94
GtkList implements
 
95
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>.</para>
 
96
 
 
97
</refsect1>
 
98
 
 
99
 
 
100
<refsect1 role="properties">
 
101
<title role="properties.title">Properties</title>
 
102
<synopsis>
 
103
 
 
104
  &quot;<link linkend="GtkList--selection-mode">selection-mode</link>&quot;           <link linkend="GtkSelectionMode">GtkSelectionMode</link>      : Read / Write
 
105
</synopsis>
 
106
</refsect1>
 
107
 
 
108
<refsect1 role="signal_proto">
 
109
<title role="signal_proto.title">Signals</title>
 
110
<synopsis>
 
111
 
 
112
  &quot;<link linkend="GtkList-select-child">select-child</link>&quot;                                   : Run First
 
113
  &quot;<link linkend="GtkList-selection-changed">selection-changed</link>&quot;                              : Run First
 
114
  &quot;<link linkend="GtkList-unselect-child">unselect-child</link>&quot;                                 : Run First
 
115
</synopsis>
 
116
</refsect1>
 
117
 
 
118
 
 
119
<refsect1 role="desc">
 
120
<title role="desc.title">Description</title>
 
121
<para>
 
122
The <link linkend="GtkList"><type>GtkList</type></link> widget is a container whose children are displayed
 
123
vertically in order, and can be selected.
 
124
 
 
125
The list has many selection modes, which are programmer selective and
 
126
depend on how many elements are able to be selected at the same time.
 
127
</para>
 
128
<para>
 
129
GtkList has been deprecated since GTK+ 2.0 and should not be used
 
130
in newly written code. Use <link linkend="GtkTreeView"><type>GtkTreeView</type></link> instead.
 
131
</para>
 
132
</refsect1>
 
133
 
 
134
<refsect1 role="details">
 
135
<title role="details.title">Details</title>
 
136
<refsect2>
 
137
<title><anchor id="GtkList-struct" role="struct"/>GtkList</title>
 
138
<indexterm role="deprecated"><primary>GtkList</primary></indexterm><programlisting>typedef struct _GtkList GtkList;</programlisting>
 
139
<warning><para><literal>GtkList</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
140
<para>
 
141
 
 
142
</para></refsect2>
 
143
<refsect2>
 
144
<title><anchor id="gtk-list-new" role="function" condition="deprecated:"/>gtk_list_new ()</title>
 
145
<indexterm role="deprecated"><primary>gtk_list_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_list_new                        (void);</programlisting>
 
146
<warning><para><literal>gtk_list_new</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
147
<para>
 
148
Creates a new <link linkend="GtkList"><type>GtkList</type></link>.
 
149
</para><variablelist role="params">
 
150
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>the newly-created <link linkend="GtkList"><type>GtkList</type></link>
 
151
 
 
152
 
 
153
</simpara></listitem></varlistentry>
 
154
</variablelist></refsect2>
 
155
<refsect2>
 
156
<title><anchor id="gtk-list-insert-items" role="function" condition="deprecated:"/>gtk_list_insert_items ()</title>
 
157
<indexterm role="deprecated"><primary>gtk_list_insert_items</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_insert_items               (<link linkend="GtkList">GtkList</link> *list,
 
158
                                                         <link linkend="GList">GList</link> *items,
 
159
                                                         <link linkend="gint">gint</link> position);</programlisting>
 
160
<warning><para><literal>gtk_list_insert_items</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
161
<para>
 
162
Inserts <parameter>items</parameter> into the <parameter>list</parameter> at the position <parameter>position</parameter>. The <link linkend="GList"><type>GList</type></link> items
 
163
must not be freed after.
 
164
</para><variablelist role="params">
 
165
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
166
<listitem><simpara>the list widget.
 
167
</simpara></listitem></varlistentry>
 
168
<varlistentry><term><parameter>items</parameter>&nbsp;:</term>
 
169
<listitem><simpara>the items.
 
170
</simpara></listitem></varlistentry>
 
171
<varlistentry><term><parameter>position</parameter>&nbsp;:</term>
 
172
<listitem><simpara>the position to insert <parameter>items</parameter>, starting at 0.
 
173
 
 
174
 
 
175
</simpara></listitem></varlistentry>
 
176
</variablelist></refsect2>
 
177
<refsect2>
 
178
<title><anchor id="gtk-list-append-items" role="function" condition="deprecated:"/>gtk_list_append_items ()</title>
 
179
<indexterm role="deprecated"><primary>gtk_list_append_items</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_append_items               (<link linkend="GtkList">GtkList</link> *list,
 
180
                                                         <link linkend="GList">GList</link> *items);</programlisting>
 
181
<warning><para><literal>gtk_list_append_items</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
182
<para>
 
183
Adds <parameter>items</parameter> to the end of the <parameter>list</parameter>.
 
184
</para><variablelist role="params">
 
185
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
186
<listitem><simpara>the list widget.
 
187
</simpara></listitem></varlistentry>
 
188
<varlistentry><term><parameter>items</parameter>&nbsp;:</term>
 
189
<listitem><simpara>the items.
 
190
 
 
191
 
 
192
</simpara></listitem></varlistentry>
 
193
</variablelist></refsect2>
 
194
<refsect2>
 
195
<title><anchor id="gtk-list-prepend-items" role="function" condition="deprecated:"/>gtk_list_prepend_items ()</title>
 
196
<indexterm role="deprecated"><primary>gtk_list_prepend_items</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_prepend_items              (<link linkend="GtkList">GtkList</link> *list,
 
197
                                                         <link linkend="GList">GList</link> *items);</programlisting>
 
198
<warning><para><literal>gtk_list_prepend_items</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
199
<para>
 
200
Inserts <parameter>items</parameter> at the beginning of the <parameter>list</parameter>.
 
201
</para><variablelist role="params">
 
202
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
203
<listitem><simpara>the list widget.
 
204
</simpara></listitem></varlistentry>
 
205
<varlistentry><term><parameter>items</parameter>&nbsp;:</term>
 
206
<listitem><simpara>the items.
 
207
 
 
208
 
 
209
</simpara></listitem></varlistentry>
 
210
</variablelist></refsect2>
 
211
<refsect2>
 
212
<title><anchor id="gtk-list-remove-items" role="function" condition="deprecated:"/>gtk_list_remove_items ()</title>
 
213
<indexterm role="deprecated"><primary>gtk_list_remove_items</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_remove_items               (<link linkend="GtkList">GtkList</link> *list,
 
214
                                                         <link linkend="GList">GList</link> *items);</programlisting>
 
215
<warning><para><literal>gtk_list_remove_items</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
216
<para>
 
217
Removes the <parameter>items</parameter> from the <parameter>list</parameter>.
 
218
</para><variablelist role="params">
 
219
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
220
<listitem><simpara>the list widget.
 
221
</simpara></listitem></varlistentry>
 
222
<varlistentry><term><parameter>items</parameter>&nbsp;:</term>
 
223
<listitem><simpara>the items to remove.
 
224
 
 
225
 
 
226
</simpara></listitem></varlistentry>
 
227
</variablelist></refsect2>
 
228
<refsect2>
 
229
<title><anchor id="gtk-list-remove-items-no-unref" role="function" condition="deprecated:"/>gtk_list_remove_items_no_unref ()</title>
 
230
<indexterm role="deprecated"><primary>gtk_list_remove_items_no_unref</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_remove_items_no_unref      (<link linkend="GtkList">GtkList</link> *list,
 
231
                                                         <link linkend="GList">GList</link> *items);</programlisting>
 
232
<warning><para><literal>gtk_list_remove_items_no_unref</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
233
<para>
 
234
Removes the <parameter>items</parameter> from the <parameter>list</parameter>, without unreferencing them. It
 
235
may be useful if you want to move the items from one list to another.
 
236
</para><variablelist role="params">
 
237
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
238
<listitem><simpara>the list widget.
 
239
</simpara></listitem></varlistentry>
 
240
<varlistentry><term><parameter>items</parameter>&nbsp;:</term>
 
241
<listitem><simpara>the items.
 
242
 
 
243
 
 
244
</simpara></listitem></varlistentry>
 
245
</variablelist></refsect2>
 
246
<refsect2>
 
247
<title><anchor id="gtk-list-clear-items" role="function" condition="deprecated:"/>gtk_list_clear_items ()</title>
 
248
<indexterm role="deprecated"><primary>gtk_list_clear_items</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_clear_items                (<link linkend="GtkList">GtkList</link> *list,
 
249
                                                         <link linkend="gint">gint</link> start,
 
250
                                                         <link linkend="gint">gint</link> end);</programlisting>
 
251
<warning><para><literal>gtk_list_clear_items</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
252
<para>
 
253
Removes the items between index <parameter>start</parameter> (included) and <parameter>end</parameter> (excluded)
 
254
from the <parameter>list</parameter>. If <parameter>end</parameter> is negative, or greater than the number of
 
255
children of <parameter>list</parameter>, it's assumed to be exactly the number of
 
256
elements. If <parameter>start</parameter> is greater than or equal to <parameter>end</parameter>, nothing is
 
257
done.
 
258
</para><variablelist role="params">
 
259
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
260
<listitem><simpara>the list widget.
 
261
</simpara></listitem></varlistentry>
 
262
<varlistentry><term><parameter>start</parameter>&nbsp;:</term>
 
263
<listitem><simpara>the index of the first item to remove.
 
264
</simpara></listitem></varlistentry>
 
265
<varlistentry><term><parameter>end</parameter>&nbsp;:</term>
 
266
<listitem><simpara>the index of the lest item to remove plus one.
 
267
 
 
268
 
 
269
</simpara></listitem></varlistentry>
 
270
</variablelist></refsect2>
 
271
<refsect2>
 
272
<title><anchor id="gtk-list-select-item" role="function" condition="deprecated:"/>gtk_list_select_item ()</title>
 
273
<indexterm role="deprecated"><primary>gtk_list_select_item</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_select_item                (<link linkend="GtkList">GtkList</link> *list,
 
274
                                                         <link linkend="gint">gint</link> item);</programlisting>
 
275
<warning><para><literal>gtk_list_select_item</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
276
<para>
 
277
Selects the child number <parameter>item</parameter> of the <parameter>list</parameter>. Nothing happens if <parameter>item</parameter>
 
278
is out of bounds. The signal GtkList::select-child will be emitted.
 
279
</para><variablelist role="params">
 
280
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
281
<listitem><simpara>the list widget.
 
282
</simpara></listitem></varlistentry>
 
283
<varlistentry><term><parameter>item</parameter>&nbsp;:</term>
 
284
<listitem><simpara>the index of the child to select.
 
285
 
 
286
 
 
287
</simpara></listitem></varlistentry>
 
288
</variablelist></refsect2>
 
289
<refsect2>
 
290
<title><anchor id="gtk-list-unselect-item" role="function" condition="deprecated:"/>gtk_list_unselect_item ()</title>
 
291
<indexterm role="deprecated"><primary>gtk_list_unselect_item</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_unselect_item              (<link linkend="GtkList">GtkList</link> *list,
 
292
                                                         <link linkend="gint">gint</link> item);</programlisting>
 
293
<warning><para><literal>gtk_list_unselect_item</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
294
<para>
 
295
Unselects the child number <parameter>item</parameter> of the <parameter>list</parameter>. Nothing happens if
 
296
<parameter>item</parameter> is out of bounds. The signal GtkList::unselect-child will be
 
297
emitted.
 
298
</para><variablelist role="params">
 
299
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
300
<listitem><simpara>the list widget.
 
301
</simpara></listitem></varlistentry>
 
302
<varlistentry><term><parameter>item</parameter>&nbsp;:</term>
 
303
<listitem><simpara>the index of the child to unselect.
 
304
 
 
305
 
 
306
</simpara></listitem></varlistentry>
 
307
</variablelist></refsect2>
 
308
<refsect2>
 
309
<title><anchor id="gtk-list-select-child" role="function" condition="deprecated:"/>gtk_list_select_child ()</title>
 
310
<indexterm role="deprecated"><primary>gtk_list_select_child</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_select_child               (<link linkend="GtkList">GtkList</link> *list,
 
311
                                                         <link linkend="GtkWidget">GtkWidget</link> *child);</programlisting>
 
312
<warning><para><literal>gtk_list_select_child</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
313
<para>
 
314
Selects the given <parameter>child</parameter>. The signal GtkList::select-child will be
 
315
emitted.
 
316
</para><variablelist role="params">
 
317
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
318
<listitem><simpara>the list widget
 
319
</simpara></listitem></varlistentry>
 
320
<varlistentry><term><parameter>child</parameter>&nbsp;:</term>
 
321
<listitem><simpara>the child to select.
 
322
 
 
323
 
 
324
</simpara></listitem></varlistentry>
 
325
</variablelist></refsect2>
 
326
<refsect2>
 
327
<title><anchor id="gtk-list-unselect-child" role="function" condition="deprecated:"/>gtk_list_unselect_child ()</title>
 
328
<indexterm role="deprecated"><primary>gtk_list_unselect_child</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_unselect_child             (<link linkend="GtkList">GtkList</link> *list,
 
329
                                                         <link linkend="GtkWidget">GtkWidget</link> *child);</programlisting>
 
330
<warning><para><literal>gtk_list_unselect_child</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
331
<para>
 
332
Unselects the given <parameter>child</parameter>. The signal GtkList::unselect-child will be
 
333
emitted.
 
334
</para><variablelist role="params">
 
335
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
336
<listitem><simpara>the list widget.
 
337
</simpara></listitem></varlistentry>
 
338
<varlistentry><term><parameter>child</parameter>&nbsp;:</term>
 
339
<listitem><simpara>the child to unselect.
 
340
 
 
341
 
 
342
</simpara></listitem></varlistentry>
 
343
</variablelist></refsect2>
 
344
<refsect2>
 
345
<title><anchor id="gtk-list-child-position" role="function" condition="deprecated:"/>gtk_list_child_position ()</title>
 
346
<indexterm role="deprecated"><primary>gtk_list_child_position</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_list_child_position             (<link linkend="GtkList">GtkList</link> *list,
 
347
                                                         <link linkend="GtkWidget">GtkWidget</link> *child);</programlisting>
 
348
<warning><para><literal>gtk_list_child_position</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
349
<para>
 
350
Searches the children of <parameter>list</parameter> for the index of <parameter>child</parameter>.
 
351
</para><variablelist role="params">
 
352
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
353
<listitem><simpara>the list widget.
 
354
</simpara></listitem></varlistentry>
 
355
<varlistentry><term><parameter>child</parameter>&nbsp;:</term>
 
356
<listitem><simpara>the child to look for.
 
357
</simpara></listitem></varlistentry>
 
358
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>the index of the child, -1 if not found.
 
359
 
 
360
 
 
361
</simpara></listitem></varlistentry>
 
362
</variablelist></refsect2>
 
363
<refsect2>
 
364
<title><anchor id="gtk-list-set-selection-mode" role="function" condition="deprecated:"/>gtk_list_set_selection_mode ()</title>
 
365
<indexterm role="deprecated"><primary>gtk_list_set_selection_mode</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_set_selection_mode         (<link linkend="GtkList">GtkList</link> *list,
 
366
                                                         <link linkend="GtkSelectionMode">GtkSelectionMode</link> mode);</programlisting>
 
367
<warning><para><literal>gtk_list_set_selection_mode</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
368
<para>
 
369
Set the list selection mode. The selection mode can be any value in
 
370
<link linkend="GtkSelectionMode--"><type>GtkSelectionMode:</type></link>
 
371
<variablelist>
 
372
<varlistentry>
 
373
<term><link linkend="GTK-SELECTION-SINGLE:CAPS"><type>GTK_SELECTION_SINGLE</type></link></term>
 
374
<listitem><para>
 
375
Zero or one element may be selected.
 
376
</para></listitem>
 
377
</varlistentry>
 
378
 
 
379
<varlistentry>
 
380
<term><link linkend="GTK-SELECTION-BROWSE:CAPS"><type>GTK_SELECTION_BROWSE</type></link></term>
 
381
<listitem><para>
 
382
Exactly one element is always selected (this can be false after you have
 
383
changed the selection mode).
 
384
</para></listitem>
 
385
</varlistentry>
 
386
 
 
387
<varlistentry>
 
388
<term><link linkend="GTK-SELECTION-MULTIPLE:CAPS"><type>GTK_SELECTION_MULTIPLE</type></link></term>
 
389
<listitem><para>
 
390
Any number of elements may be selected. Clicks toggle the state of an
 
391
item.
 
392
</para></listitem>
 
393
</varlistentry>
 
394
 
 
395
<varlistentry>
 
396
<term><link linkend="GTK-SELECTION-EXTENDED:CAPS"><type>GTK_SELECTION_EXTENDED</type></link></term>
 
397
<listitem><para>
 
398
Any number of elements may be selected. Click-drag selects a range of
 
399
elements; the Ctrl key may be used to enlarge the selection, and
 
400
Shift key to select between the focus and the child pointed to.
 
401
</para></listitem>
 
402
</varlistentry>
 
403
</variablelist>
 
404
</para><variablelist role="params">
 
405
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
406
<listitem><simpara>the list widget.
 
407
</simpara></listitem></varlistentry>
 
408
<varlistentry><term><parameter>mode</parameter>&nbsp;:</term>
 
409
<listitem><simpara>the new selection mode.
 
410
 
 
411
 
 
412
</simpara></listitem></varlistentry>
 
413
</variablelist></refsect2>
 
414
<refsect2>
 
415
<title><anchor id="gtk-list-extend-selection" role="function" condition="deprecated:"/>gtk_list_extend_selection ()</title>
 
416
<indexterm role="deprecated"><primary>gtk_list_extend_selection</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_extend_selection           (<link linkend="GtkList">GtkList</link> *list,
 
417
                                                         <link linkend="GtkScrollType">GtkScrollType</link> scroll_type,
 
418
                                                         <link linkend="gfloat">gfloat</link> position,
 
419
                                                         <link linkend="gboolean">gboolean</link> auto_start_selection);</programlisting>
 
420
<warning><para><literal>gtk_list_extend_selection</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
421
<para>
 
422
Extends the selection by moving the anchor according to <parameter>scroll_type</parameter>. Only
 
423
in <link linkend="GTK-SELECTION-EXTENDED:CAPS"><type>GTK_SELECTION_EXTENDED</type></link>.
 
424
</para><variablelist role="params">
 
425
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
426
<listitem><simpara>the list widget.
 
427
</simpara></listitem></varlistentry>
 
428
<varlistentry><term><parameter>scroll_type</parameter>&nbsp;:</term>
 
429
<listitem><simpara>the direction and length.
 
430
</simpara></listitem></varlistentry>
 
431
<varlistentry><term><parameter>position</parameter>&nbsp;:</term>
 
432
<listitem><simpara>the position if <parameter>scroll_type</parameter> is <link linkend="GTK-SCROLL-JUMP:CAPS"><type>GTK_SCROLL_JUMP</type></link>.
 
433
</simpara></listitem></varlistentry>
 
434
<varlistentry><term><parameter>auto_start_selection</parameter>&nbsp;:</term>
 
435
<listitem><simpara>if <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, <link linkend="gtk-list-start-selection"><function>gtk_list_start_selection()</function></link> is automatically
 
436
carried out before extending the selection.
 
437
 
 
438
 
 
439
</simpara></listitem></varlistentry>
 
440
</variablelist></refsect2>
 
441
<refsect2>
 
442
<title><anchor id="gtk-list-start-selection" role="function" condition="deprecated:"/>gtk_list_start_selection ()</title>
 
443
<indexterm role="deprecated"><primary>gtk_list_start_selection</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_start_selection            (<link linkend="GtkList">GtkList</link> *list);</programlisting>
 
444
<warning><para><literal>gtk_list_start_selection</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
445
<para>
 
446
Starts a selection (or part of selection) at the focused child. Only in
 
447
<link linkend="GTK-SELECTION-EXTENDED:CAPS"><type>GTK_SELECTION_EXTENDED</type></link> mode.
 
448
</para><variablelist role="params">
 
449
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
450
<listitem><simpara>the list widget.
 
451
 
 
452
 
 
453
</simpara></listitem></varlistentry>
 
454
</variablelist></refsect2>
 
455
<refsect2>
 
456
<title><anchor id="gtk-list-end-selection" role="function" condition="deprecated:"/>gtk_list_end_selection ()</title>
 
457
<indexterm role="deprecated"><primary>gtk_list_end_selection</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_end_selection              (<link linkend="GtkList">GtkList</link> *list);</programlisting>
 
458
<warning><para><literal>gtk_list_end_selection</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
459
<para>
 
460
Ends the selection. Used with <link linkend="gtk-list-extend-selection"><function>gtk_list_extend_selection()</function></link> and
 
461
<link linkend="gtk-list-start-selection"><function>gtk_list_start_selection()</function></link>. Only in <link linkend="GTK-SELECTION-EXTENDED:CAPS"><type>GTK_SELECTION_EXTENDED</type></link> mode.
 
462
</para><variablelist role="params">
 
463
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
464
<listitem><simpara>the list widget.
 
465
 
 
466
 
 
467
</simpara></listitem></varlistentry>
 
468
</variablelist></refsect2>
 
469
<refsect2>
 
470
<title><anchor id="gtk-list-select-all" role="function" condition="deprecated:"/>gtk_list_select_all ()</title>
 
471
<indexterm role="deprecated"><primary>gtk_list_select_all</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_select_all                 (<link linkend="GtkList">GtkList</link> *list);</programlisting>
 
472
<warning><para><literal>gtk_list_select_all</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
473
<para>
 
474
Selects all children of <parameter>list</parameter>. A signal will be emitted for each
 
475
newly selected child.
 
476
</para><variablelist role="params">
 
477
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
478
<listitem><simpara>the list widget.
 
479
 
 
480
 
 
481
</simpara></listitem></varlistentry>
 
482
</variablelist></refsect2>
 
483
<refsect2>
 
484
<title><anchor id="gtk-list-unselect-all" role="function" condition="deprecated:"/>gtk_list_unselect_all ()</title>
 
485
<indexterm role="deprecated"><primary>gtk_list_unselect_all</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_unselect_all               (<link linkend="GtkList">GtkList</link> *list);</programlisting>
 
486
<warning><para><literal>gtk_list_unselect_all</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
487
<para>
 
488
Unselects all children of <parameter>list</parameter>. A signal will be emitted for each
 
489
newly unselected child.
 
490
</para><variablelist role="params">
 
491
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
492
<listitem><simpara>the list widget.
 
493
 
 
494
 
 
495
</simpara></listitem></varlistentry>
 
496
</variablelist></refsect2>
 
497
<refsect2>
 
498
<title><anchor id="gtk-list-scroll-horizontal" role="function" condition="deprecated:"/>gtk_list_scroll_horizontal ()</title>
 
499
<indexterm role="deprecated"><primary>gtk_list_scroll_horizontal</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_scroll_horizontal          (<link linkend="GtkList">GtkList</link> *list,
 
500
                                                         <link linkend="GtkScrollType">GtkScrollType</link> scroll_type,
 
501
                                                         <link linkend="gfloat">gfloat</link> position);</programlisting>
 
502
<warning><para><literal>gtk_list_scroll_horizontal</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
503
<para>
 
504
Scrolls <parameter>list</parameter> horizontaly. This supposes that the list is packed into a
 
505
scrolled window or something similar, and adjustments are well
 
506
set. Step and page increment are those from the horizontal adjustment
 
507
of <parameter>list</parameter>. Backward means to the left, and forward to the
 
508
right. Out of bounds values are truncated.
 
509
<parameter>scroll_type</parameter> may be any valid <link linkend="GtkScrollType"><type>GtkScrollType</type></link>. If <parameter>scroll_type</parameter> is
 
510
<link linkend="GTK-SCROLL-NONE:CAPS"><type>GTK_SCROLL_NONE</type></link>, nothing is done. If it's <link linkend="GTK-SCROLL-JUMP:CAPS"><type>GTK_SCROLL_JUMP</type></link>, the list
 
511
scrolls to the ratio <parameter>position</parameter>: 0 is full left, 1 is full right.
 
512
</para><variablelist role="params">
 
513
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
514
<listitem><simpara>the list widget.
 
515
</simpara></listitem></varlistentry>
 
516
<varlistentry><term><parameter>scroll_type</parameter>&nbsp;:</term>
 
517
<listitem><simpara>the scrolling type.
 
518
</simpara></listitem></varlistentry>
 
519
<varlistentry><term><parameter>position</parameter>&nbsp;:</term>
 
520
<listitem><simpara>the position if <parameter>scroll_type</parameter> is <link linkend="GTK-SCROLL-JUMP:CAPS"><type>GTK_SCROLL_JUMP</type></link>
 
521
 
 
522
 
 
523
</simpara></listitem></varlistentry>
 
524
</variablelist></refsect2>
 
525
<refsect2>
 
526
<title><anchor id="gtk-list-scroll-vertical" role="function" condition="deprecated:"/>gtk_list_scroll_vertical ()</title>
 
527
<indexterm role="deprecated"><primary>gtk_list_scroll_vertical</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_scroll_vertical            (<link linkend="GtkList">GtkList</link> *list,
 
528
                                                         <link linkend="GtkScrollType">GtkScrollType</link> scroll_type,
 
529
                                                         <link linkend="gfloat">gfloat</link> position);</programlisting>
 
530
<warning><para><literal>gtk_list_scroll_vertical</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
531
<para>
 
532
Scrolls <parameter>list</parameter> vertically. This supposes that the list is packed into a
 
533
scrolled window or something similar, and adjustments are well
 
534
set. Step and page increment are those from the vertical adjustment
 
535
of <parameter>list</parameter>. Backward means up, and forward down. Out of bounds values are
 
536
truncated.
 
537
<parameter>scroll_type</parameter> may be any valid <link linkend="GtkScrollType"><type>GtkScrollType</type></link>. If <parameter>scroll_type</parameter> is
 
538
<link linkend="GTK-SCROLL-NONE:CAPS"><type>GTK_SCROLL_NONE</type></link>, nothing is done. If it's <link linkend="GTK-SCROLL-JUMP:CAPS"><type>GTK_SCROLL_JUMP</type></link>, the list
 
539
scrolls to the ratio <parameter>position</parameter>: 0 is top, 1 is bottom.
 
540
</para><variablelist role="params">
 
541
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
542
<listitem><simpara>the list widget.
 
543
</simpara></listitem></varlistentry>
 
544
<varlistentry><term><parameter>scroll_type</parameter>&nbsp;:</term>
 
545
<listitem><simpara>the scrolling type.
 
546
</simpara></listitem></varlistentry>
 
547
<varlistentry><term><parameter>position</parameter>&nbsp;:</term>
 
548
<listitem><simpara>the position if <parameter>scroll_type</parameter> is <link linkend="GTK-SCROLL-JUMP:CAPS"><type>GTK_SCROLL_JUMP</type></link>
 
549
 
 
550
 
 
551
</simpara></listitem></varlistentry>
 
552
</variablelist></refsect2>
 
553
<refsect2>
 
554
<title><anchor id="gtk-list-toggle-add-mode" role="function" condition="deprecated:"/>gtk_list_toggle_add_mode ()</title>
 
555
<indexterm role="deprecated"><primary>gtk_list_toggle_add_mode</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_toggle_add_mode            (<link linkend="GtkList">GtkList</link> *list);</programlisting>
 
556
<warning><para><literal>gtk_list_toggle_add_mode</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
557
<para>
 
558
Toggles between adding to the selection and beginning a new selection. Only
 
559
in <link linkend="GTK-SELECTION-EXTENDED:CAPS"><type>GTK_SELECTION_EXTENDED</type></link>. Useful with <link linkend="gtk-list-extend-selection"><function>gtk_list_extend_selection()</function></link>.
 
560
</para><variablelist role="params">
 
561
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
562
<listitem><simpara>the list widget.
 
563
 
 
564
 
 
565
</simpara></listitem></varlistentry>
 
566
</variablelist></refsect2>
 
567
<refsect2>
 
568
<title><anchor id="gtk-list-toggle-focus-row" role="function" condition="deprecated:"/>gtk_list_toggle_focus_row ()</title>
 
569
<indexterm role="deprecated"><primary>gtk_list_toggle_focus_row</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_toggle_focus_row           (<link linkend="GtkList">GtkList</link> *list);</programlisting>
 
570
<warning><para><literal>gtk_list_toggle_focus_row</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
571
<para>
 
572
Toggles the focus row. If the focus row is selected, it's
 
573
unselected. If the focus row is unselected, it's selected. If the
 
574
selection mode of <parameter>list</parameter> is <link linkend="GTK-SELECTION-BROWSE:CAPS"><type>GTK_SELECTION_BROWSE</type></link>, this has no effect,
 
575
as the selection is always at the focus row.
 
576
</para><variablelist role="params">
 
577
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
578
<listitem><simpara>the list widget.
 
579
 
 
580
 
 
581
</simpara></listitem></varlistentry>
 
582
</variablelist></refsect2>
 
583
<refsect2>
 
584
<title><anchor id="gtk-list-toggle-row" role="function" condition="deprecated:"/>gtk_list_toggle_row ()</title>
 
585
<indexterm role="deprecated"><primary>gtk_list_toggle_row</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_toggle_row                 (<link linkend="GtkList">GtkList</link> *list,
 
586
                                                         <link linkend="GtkWidget">GtkWidget</link> *item);</programlisting>
 
587
<warning><para><literal>gtk_list_toggle_row</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
588
<para>
 
589
Toggles the child <parameter>item</parameter> of list. If the selection mode of <parameter>list</parameter> is
 
590
<link linkend="GTK-SELECTION-BROWSE:CAPS"><type>GTK_SELECTION_BROWSE</type></link>, the item is selected, and the others are
 
591
unselected.
 
592
</para><variablelist role="params">
 
593
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
594
<listitem><simpara>the list widget.
 
595
</simpara></listitem></varlistentry>
 
596
<varlistentry><term><parameter>item</parameter>&nbsp;:</term>
 
597
<listitem><simpara>the child to toggle.
 
598
 
 
599
 
 
600
</simpara></listitem></varlistentry>
 
601
</variablelist></refsect2>
 
602
<refsect2>
 
603
<title><anchor id="gtk-list-undo-selection" role="function" condition="deprecated:"/>gtk_list_undo_selection ()</title>
 
604
<indexterm role="deprecated"><primary>gtk_list_undo_selection</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_undo_selection             (<link linkend="GtkList">GtkList</link> *list);</programlisting>
 
605
<warning><para><literal>gtk_list_undo_selection</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
606
<para>
 
607
Restores the selection in the last state, only if selection mode is
 
608
<link linkend="GTK-SELECTION-EXTENDED:CAPS"><type>GTK_SELECTION_EXTENDED</type></link>. If this function is called twice, the selection is
 
609
cleared. This function sometimes gives stranges "last states".
 
610
</para><variablelist role="params">
 
611
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
612
<listitem><simpara>the list widget.
 
613
 
 
614
 
 
615
</simpara></listitem></varlistentry>
 
616
</variablelist></refsect2>
 
617
<refsect2>
 
618
<title><anchor id="gtk-list-end-drag-selection" role="function" condition="deprecated:"/>gtk_list_end_drag_selection ()</title>
 
619
<indexterm role="deprecated"><primary>gtk_list_end_drag_selection</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_list_end_drag_selection         (<link linkend="GtkList">GtkList</link> *list);</programlisting>
 
620
<warning><para><literal>gtk_list_end_drag_selection</literal> is deprecated and should not be used in newly-written code.</para></warning>
 
621
<para>
 
622
Stops the drag selection mode and ungrabs the pointer. This has no
 
623
effect if a drag selection is not active.
 
624
</para><variablelist role="params">
 
625
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
626
<listitem><simpara>the list widget.
 
627
 
 
628
 
 
629
</simpara></listitem></varlistentry>
 
630
</variablelist></refsect2>
 
631
 
 
632
</refsect1>
 
633
<refsect1 role="property_details">
 
634
<title role="property_details.title">Property Details</title>
 
635
<refsect2><title><anchor id="GtkList--selection-mode"/>The &quot;<literal>selection-mode</literal>&quot; property</title>
 
636
<indexterm><primary>GtkList:selection-mode</primary></indexterm><programlisting>  &quot;selection-mode&quot;           <link linkend="GtkSelectionMode">GtkSelectionMode</link>      : Read / Write</programlisting>
 
637
<para></para><para>Default value: GTK_SELECTION_NONE</para>
 
638
</refsect2>
 
639
 
 
640
</refsect1>
 
641
 
 
642
<refsect1 role="signals">
 
643
<title role="signals.title">Signal Details</title>
 
644
<refsect2><title><anchor id="GtkList-select-child"/>The &quot;select-child&quot; signal</title>
 
645
<indexterm><primary>GtkList::select-child</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkList">GtkList</link>   *list,
 
646
                                                        <link linkend="GtkWidget">GtkWidget</link> *widget,
 
647
                                                        <link linkend="gpointer">gpointer</link>   user_data)      : Run First</programlisting>
 
648
<para>
 
649
The child <parameter>widget</parameter> has just been selected.
 
650
</para><variablelist role="params">
 
651
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
652
<listitem><simpara>the object which received the signal.
 
653
</simpara></listitem></varlistentry>
 
654
<varlistentry><term><parameter>widget</parameter>&nbsp;:</term>
 
655
<listitem><simpara>the newly selected child.
 
656
 
 
657
</simpara></listitem></varlistentry>
 
658
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
 
659
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
 
660
</variablelist></refsect2><refsect2><title><anchor id="GtkList-selection-changed"/>The &quot;selection-changed&quot; signal</title>
 
661
<indexterm><primary>GtkList::selection-changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkList">GtkList</link> *list,
 
662
                                                        <link linkend="gpointer">gpointer</link> user_data)      : Run First</programlisting>
 
663
<para>
 
664
The selection of the widget has just changed.
 
665
</para><variablelist role="params">
 
666
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
667
<listitem><simpara>the object which received the signal.
 
668
 
 
669
</simpara></listitem></varlistentry>
 
670
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
 
671
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
 
672
</variablelist></refsect2><refsect2><title><anchor id="GtkList-unselect-child"/>The &quot;unselect-child&quot; signal</title>
 
673
<indexterm><primary>GtkList::unselect-child</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkList">GtkList</link>   *list,
 
674
                                                        <link linkend="GtkWidget">GtkWidget</link> *widget,
 
675
                                                        <link linkend="gpointer">gpointer</link>   user_data)      : Run First</programlisting>
 
676
<para>
 
677
The child <parameter>widget</parameter> has just been unselected.
 
678
</para><variablelist role="params">
 
679
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
680
<listitem><simpara>the object which received the signal.
 
681
</simpara></listitem></varlistentry>
 
682
<varlistentry><term><parameter>widget</parameter>&nbsp;:</term>
 
683
<listitem><simpara>the newly unselected child.
 
684
 
 
685
</simpara></listitem></varlistentry>
 
686
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
 
687
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
 
688
</variablelist></refsect2>
 
689
</refsect1>
 
690
 
 
691
 
 
692
<refsect1>
 
693
<title>See Also</title>
 
694
<para>
 
695
<variablelist>
 
696
<varlistentry>
 
697
<term><link linkend="GtkContainer"><type>GtkContainer</type></link></term>
 
698
<listitem><para>For functions that apply to every <link linkend="GtkContainer"><type>GtkContainer</type></link>
 
699
(like <link linkend="GtkList"><type>GtkList</type></link>).</para></listitem>
 
700
</varlistentry>
 
701
<varlistentry>
 
702
<term><link linkend="GtkListitem"><type>GtkListitem</type></link></term>
 
703
<listitem><para>Children of a <link linkend="GtkList"><type>GtkList</type></link> widget must be of this
 
704
type.</para></listitem>
 
705
</varlistentry>
 
706
</variablelist>
 
707
</para>
 
708
</refsect1>
 
709
 
 
710
</refentry>