1
<refentry id="GtkCList">
3
<refentrytitle role="top_of_page">GtkCList</refentrytitle>
4
<manvolnum>3</manvolnum>
5
<refmiscinfo>GTK Library</refmiscinfo>
9
<refname>GtkCList</refname>
10
<refpurpose>A multi-columned scrolling list widget</refpurpose>
11
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
14
<refsynopsisdiv role="synopsis">
15
<title role="synopsis.title">Synopsis</title>
19
#include <gtk/gtk.h>
22
<link linkend="GtkCList-struct">GtkCList</link>;
23
enum <link linkend="GtkCellType">GtkCellType</link>;
24
enum <link linkend="GtkButtonAction">GtkButtonAction</link>;
25
#define <link linkend="GTK-CLIST-FLAGS:CAPS">GTK_CLIST_FLAGS</link> (clist)
26
#define <link linkend="GTK-CLIST-SET-FLAG:CAPS">GTK_CLIST_SET_FLAG</link> (clist,flag)
27
#define <link linkend="GTK-CLIST-UNSET-FLAG:CAPS">GTK_CLIST_UNSET_FLAG</link> (clist,flag)
28
#define <link linkend="GTK-CLIST-IN-DRAG:CAPS">GTK_CLIST_IN_DRAG</link> (clist)
29
#define <link linkend="GTK-CLIST-ROW-HEIGHT-SET:CAPS">GTK_CLIST_ROW_HEIGHT_SET</link> (clist)
30
#define <link linkend="GTK-CLIST-SHOW-TITLES:CAPS">GTK_CLIST_SHOW_TITLES</link> (clist)
31
#define <link linkend="GTK-CLIST-ADD-MODE:CAPS">GTK_CLIST_ADD_MODE</link> (clist)
32
#define <link linkend="GTK-CLIST-AUTO-SORT:CAPS">GTK_CLIST_AUTO_SORT</link> (clist)
33
#define <link linkend="GTK-CLIST-AUTO-RESIZE-BLOCKED:CAPS">GTK_CLIST_AUTO_RESIZE_BLOCKED</link> (clist)
34
#define <link linkend="GTK-CLIST-REORDERABLE:CAPS">GTK_CLIST_REORDERABLE</link> (clist)
35
#define <link linkend="GTK-CLIST-USE-DRAG-ICONS:CAPS">GTK_CLIST_USE_DRAG_ICONS</link> (clist)
36
#define <link linkend="GTK-CLIST-DRAW-DRAG-LINE:CAPS">GTK_CLIST_DRAW_DRAG_LINE</link> (clist)
37
#define <link linkend="GTK-CLIST-DRAW-DRAG-RECT:CAPS">GTK_CLIST_DRAW_DRAG_RECT</link> (clist)
38
#define <link linkend="GTK-CLIST-ROW:CAPS">GTK_CLIST_ROW</link> (_glist_)
39
#define <link linkend="GTK-CELL-TEXT:CAPS">GTK_CELL_TEXT</link> (cell)
40
#define <link linkend="GTK-CELL-PIXMAP:CAPS">GTK_CELL_PIXMAP</link> (cell)
41
#define <link linkend="GTK-CELL-PIXTEXT:CAPS">GTK_CELL_PIXTEXT</link> (cell)
42
#define <link linkend="GTK-CELL-WIDGET:CAPS">GTK_CELL_WIDGET</link> (cell)
43
<link linkend="gint">gint</link> (<link linkend="GtkCListCompareFunc">*GtkCListCompareFunc</link>) (<link linkend="GtkCList">GtkCList</link> *clist,
44
<link linkend="gconstpointer">gconstpointer</link> ptr1,
45
<link linkend="gconstpointer">gconstpointer</link> ptr2);
46
<link linkend="GtkCListColumn">GtkCListColumn</link>;
47
<link linkend="GtkCListRow">GtkCListRow</link>;
48
<link linkend="GtkCellText">GtkCellText</link>;
49
<link linkend="GtkCellPixmap">GtkCellPixmap</link>;
50
<link linkend="GtkCellPixText">GtkCellPixText</link>;
51
<link linkend="GtkCellWidget">GtkCellWidget</link>;
52
<link linkend="GtkCell">GtkCell</link>;
53
<link linkend="GtkCListCellInfo">GtkCListCellInfo</link>;
54
<link linkend="GtkCListDestInfo">GtkCListDestInfo</link>;
55
enum <link linkend="GtkCListDragPos">GtkCListDragPos</link>;
56
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gtk-clist-new">gtk_clist_new</link> (<link linkend="gint">gint</link> columns);
57
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gtk-clist-new-with-titles">gtk_clist_new_with_titles</link> (<link linkend="gint">gint</link> columns,
58
<link linkend="gchar">gchar</link> *titles[]);
59
<link linkend="void">void</link> <link linkend="gtk-clist-set-shadow-type">gtk_clist_set_shadow_type</link> (<link linkend="GtkCList">GtkCList</link> *clist,
60
<link linkend="GtkShadowType">GtkShadowType</link> type);
61
<link linkend="void">void</link> <link linkend="gtk-clist-set-selection-mode">gtk_clist_set_selection_mode</link> (<link linkend="GtkCList">GtkCList</link> *clist,
62
<link linkend="GtkSelectionMode">GtkSelectionMode</link> mode);
63
<link linkend="void">void</link> <link linkend="gtk-clist-freeze">gtk_clist_freeze</link> (<link linkend="GtkCList">GtkCList</link> *clist);
64
<link linkend="void">void</link> <link linkend="gtk-clist-thaw">gtk_clist_thaw</link> (<link linkend="GtkCList">GtkCList</link> *clist);
65
<link linkend="void">void</link> <link linkend="gtk-clist-column-titles-show">gtk_clist_column_titles_show</link> (<link linkend="GtkCList">GtkCList</link> *clist);
66
<link linkend="void">void</link> <link linkend="gtk-clist-column-titles-hide">gtk_clist_column_titles_hide</link> (<link linkend="GtkCList">GtkCList</link> *clist);
67
<link linkend="void">void</link> <link linkend="gtk-clist-column-title-active">gtk_clist_column_title_active</link> (<link linkend="GtkCList">GtkCList</link> *clist,
68
<link linkend="gint">gint</link> column);
69
<link linkend="void">void</link> <link linkend="gtk-clist-column-title-passive">gtk_clist_column_title_passive</link> (<link linkend="GtkCList">GtkCList</link> *clist,
70
<link linkend="gint">gint</link> column);
71
<link linkend="void">void</link> <link linkend="gtk-clist-column-titles-active">gtk_clist_column_titles_active</link> (<link linkend="GtkCList">GtkCList</link> *clist);
72
<link linkend="void">void</link> <link linkend="gtk-clist-column-titles-passive">gtk_clist_column_titles_passive</link> (<link linkend="GtkCList">GtkCList</link> *clist);
73
<link linkend="void">void</link> <link linkend="gtk-clist-set-column-title">gtk_clist_set_column_title</link> (<link linkend="GtkCList">GtkCList</link> *clist,
74
<link linkend="gint">gint</link> column,
75
const <link linkend="gchar">gchar</link> *title);
76
<link linkend="void">void</link> <link linkend="gtk-clist-set-column-widget">gtk_clist_set_column_widget</link> (<link linkend="GtkCList">GtkCList</link> *clist,
77
<link linkend="gint">gint</link> column,
78
<link linkend="GtkWidget">GtkWidget</link> *widget);
79
<link linkend="void">void</link> <link linkend="gtk-clist-set-column-justification">gtk_clist_set_column_justification</link> (<link linkend="GtkCList">GtkCList</link> *clist,
80
<link linkend="gint">gint</link> column,
81
<link linkend="GtkJustification">GtkJustification</link> justification);
82
<link linkend="void">void</link> <link linkend="gtk-clist-set-column-visibility">gtk_clist_set_column_visibility</link> (<link linkend="GtkCList">GtkCList</link> *clist,
83
<link linkend="gint">gint</link> column,
84
<link linkend="gboolean">gboolean</link> visible);
85
<link linkend="void">void</link> <link linkend="gtk-clist-set-column-resizeable">gtk_clist_set_column_resizeable</link> (<link linkend="GtkCList">GtkCList</link> *clist,
86
<link linkend="gint">gint</link> column,
87
<link linkend="gboolean">gboolean</link> resizeable);
88
<link linkend="void">void</link> <link linkend="gtk-clist-set-column-auto-resize">gtk_clist_set_column_auto_resize</link> (<link linkend="GtkCList">GtkCList</link> *clist,
89
<link linkend="gint">gint</link> column,
90
<link linkend="gboolean">gboolean</link> auto_resize);
91
<link linkend="gint">gint</link> <link linkend="gtk-clist-optimal-column-width">gtk_clist_optimal_column_width</link> (<link linkend="GtkCList">GtkCList</link> *clist,
92
<link linkend="gint">gint</link> column);
93
<link linkend="void">void</link> <link linkend="gtk-clist-set-column-width">gtk_clist_set_column_width</link> (<link linkend="GtkCList">GtkCList</link> *clist,
94
<link linkend="gint">gint</link> column,
95
<link linkend="gint">gint</link> width);
96
<link linkend="void">void</link> <link linkend="gtk-clist-set-column-min-width">gtk_clist_set_column_min_width</link> (<link linkend="GtkCList">GtkCList</link> *clist,
97
<link linkend="gint">gint</link> column,
98
<link linkend="gint">gint</link> min_width);
99
<link linkend="void">void</link> <link linkend="gtk-clist-set-column-max-width">gtk_clist_set_column_max_width</link> (<link linkend="GtkCList">GtkCList</link> *clist,
100
<link linkend="gint">gint</link> column,
101
<link linkend="gint">gint</link> max_width);
102
<link linkend="void">void</link> <link linkend="gtk-clist-set-row-height">gtk_clist_set_row_height</link> (<link linkend="GtkCList">GtkCList</link> *clist,
103
<link linkend="guint">guint</link> height);
104
<link linkend="void">void</link> <link linkend="gtk-clist-moveto">gtk_clist_moveto</link> (<link linkend="GtkCList">GtkCList</link> *clist,
105
<link linkend="gint">gint</link> row,
106
<link linkend="gint">gint</link> column,
107
<link linkend="gfloat">gfloat</link> row_align,
108
<link linkend="gfloat">gfloat</link> col_align);
109
<link linkend="GtkVisibility">GtkVisibility</link> <link linkend="gtk-clist-row-is-visible">gtk_clist_row_is_visible</link> (<link linkend="GtkCList">GtkCList</link> *clist,
110
<link linkend="gint">gint</link> row);
111
<link linkend="GtkCellType">GtkCellType</link> <link linkend="gtk-clist-get-cell-type">gtk_clist_get_cell_type</link> (<link linkend="GtkCList">GtkCList</link> *clist,
112
<link linkend="gint">gint</link> row,
113
<link linkend="gint">gint</link> column);
114
<link linkend="void">void</link> <link linkend="gtk-clist-set-text">gtk_clist_set_text</link> (<link linkend="GtkCList">GtkCList</link> *clist,
115
<link linkend="gint">gint</link> row,
116
<link linkend="gint">gint</link> column,
117
const <link linkend="gchar">gchar</link> *text);
118
<link linkend="gint">gint</link> <link linkend="gtk-clist-get-text">gtk_clist_get_text</link> (<link linkend="GtkCList">GtkCList</link> *clist,
119
<link linkend="gint">gint</link> row,
120
<link linkend="gint">gint</link> column,
121
<link linkend="gchar">gchar</link> **text);
122
<link linkend="void">void</link> <link linkend="gtk-clist-set-pixmap">gtk_clist_set_pixmap</link> (<link linkend="GtkCList">GtkCList</link> *clist,
123
<link linkend="gint">gint</link> row,
124
<link linkend="gint">gint</link> column,
125
<link linkend="GdkPixmap">GdkPixmap</link> *pixmap,
126
<link linkend="GdkBitmap">GdkBitmap</link> *mask);
127
<link linkend="gint">gint</link> <link linkend="gtk-clist-get-pixmap">gtk_clist_get_pixmap</link> (<link linkend="GtkCList">GtkCList</link> *clist,
128
<link linkend="gint">gint</link> row,
129
<link linkend="gint">gint</link> column,
130
<link linkend="GdkPixmap">GdkPixmap</link> **pixmap,
131
<link linkend="GdkBitmap">GdkBitmap</link> **mask);
132
<link linkend="void">void</link> <link linkend="gtk-clist-set-pixtext">gtk_clist_set_pixtext</link> (<link linkend="GtkCList">GtkCList</link> *clist,
133
<link linkend="gint">gint</link> row,
134
<link linkend="gint">gint</link> column,
135
const <link linkend="gchar">gchar</link> *text,
136
<link linkend="guint8">guint8</link> spacing,
137
<link linkend="GdkPixmap">GdkPixmap</link> *pixmap,
138
<link linkend="GdkBitmap">GdkBitmap</link> *mask);
139
<link linkend="gint">gint</link> <link linkend="gtk-clist-get-pixtext">gtk_clist_get_pixtext</link> (<link linkend="GtkCList">GtkCList</link> *clist,
140
<link linkend="gint">gint</link> row,
141
<link linkend="gint">gint</link> column,
142
<link linkend="gchar">gchar</link> **text,
143
<link linkend="guint8">guint8</link> *spacing,
144
<link linkend="GdkPixmap">GdkPixmap</link> **pixmap,
145
<link linkend="GdkBitmap">GdkBitmap</link> **mask);
146
<link linkend="void">void</link> <link linkend="gtk-clist-set-foreground">gtk_clist_set_foreground</link> (<link linkend="GtkCList">GtkCList</link> *clist,
147
<link linkend="gint">gint</link> row,
148
const <link linkend="GdkColor">GdkColor</link> *color);
149
<link linkend="void">void</link> <link linkend="gtk-clist-set-background">gtk_clist_set_background</link> (<link linkend="GtkCList">GtkCList</link> *clist,
150
<link linkend="gint">gint</link> row,
151
const <link linkend="GdkColor">GdkColor</link> *color);
152
<link linkend="void">void</link> <link linkend="gtk-clist-set-cell-style">gtk_clist_set_cell_style</link> (<link linkend="GtkCList">GtkCList</link> *clist,
153
<link linkend="gint">gint</link> row,
154
<link linkend="gint">gint</link> column,
155
<link linkend="GtkStyle">GtkStyle</link> *style);
156
<link linkend="GtkStyle">GtkStyle</link>* <link linkend="gtk-clist-get-cell-style">gtk_clist_get_cell_style</link> (<link linkend="GtkCList">GtkCList</link> *clist,
157
<link linkend="gint">gint</link> row,
158
<link linkend="gint">gint</link> column);
159
<link linkend="void">void</link> <link linkend="gtk-clist-set-row-style">gtk_clist_set_row_style</link> (<link linkend="GtkCList">GtkCList</link> *clist,
160
<link linkend="gint">gint</link> row,
161
<link linkend="GtkStyle">GtkStyle</link> *style);
162
<link linkend="GtkStyle">GtkStyle</link>* <link linkend="gtk-clist-get-row-style">gtk_clist_get_row_style</link> (<link linkend="GtkCList">GtkCList</link> *clist,
163
<link linkend="gint">gint</link> row);
164
<link linkend="void">void</link> <link linkend="gtk-clist-set-shift">gtk_clist_set_shift</link> (<link linkend="GtkCList">GtkCList</link> *clist,
165
<link linkend="gint">gint</link> row,
166
<link linkend="gint">gint</link> column,
167
<link linkend="gint">gint</link> vertical,
168
<link linkend="gint">gint</link> horizontal);
169
<link linkend="void">void</link> <link linkend="gtk-clist-set-selectable">gtk_clist_set_selectable</link> (<link linkend="GtkCList">GtkCList</link> *clist,
170
<link linkend="gint">gint</link> row,
171
<link linkend="gboolean">gboolean</link> selectable);
172
<link linkend="gboolean">gboolean</link> <link linkend="gtk-clist-get-selectable">gtk_clist_get_selectable</link> (<link linkend="GtkCList">GtkCList</link> *clist,
173
<link linkend="gint">gint</link> row);
174
<link linkend="gint">gint</link> <link linkend="gtk-clist-prepend">gtk_clist_prepend</link> (<link linkend="GtkCList">GtkCList</link> *clist,
175
<link linkend="gchar">gchar</link> *text[]);
176
<link linkend="gint">gint</link> <link linkend="gtk-clist-append">gtk_clist_append</link> (<link linkend="GtkCList">GtkCList</link> *clist,
177
<link linkend="gchar">gchar</link> *text[]);
178
<link linkend="gint">gint</link> <link linkend="gtk-clist-insert">gtk_clist_insert</link> (<link linkend="GtkCList">GtkCList</link> *clist,
179
<link linkend="gint">gint</link> row,
180
<link linkend="gchar">gchar</link> *text[]);
181
<link linkend="void">void</link> <link linkend="gtk-clist-remove">gtk_clist_remove</link> (<link linkend="GtkCList">GtkCList</link> *clist,
182
<link linkend="gint">gint</link> row);
183
<link linkend="void">void</link> <link linkend="gtk-clist-set-row-data">gtk_clist_set_row_data</link> (<link linkend="GtkCList">GtkCList</link> *clist,
184
<link linkend="gint">gint</link> row,
185
<link linkend="gpointer">gpointer</link> data);
186
<link linkend="void">void</link> <link linkend="gtk-clist-set-row-data-full">gtk_clist_set_row_data_full</link> (<link linkend="GtkCList">GtkCList</link> *clist,
187
<link linkend="gint">gint</link> row,
188
<link linkend="gpointer">gpointer</link> data,
189
<link linkend="GtkDestroyNotify">GtkDestroyNotify</link> destroy);
190
<link linkend="gpointer">gpointer</link> <link linkend="gtk-clist-get-row-data">gtk_clist_get_row_data</link> (<link linkend="GtkCList">GtkCList</link> *clist,
191
<link linkend="gint">gint</link> row);
192
<link linkend="gint">gint</link> <link linkend="gtk-clist-find-row-from-data">gtk_clist_find_row_from_data</link> (<link linkend="GtkCList">GtkCList</link> *clist,
193
<link linkend="gpointer">gpointer</link> data);
194
<link linkend="void">void</link> <link linkend="gtk-clist-select-row">gtk_clist_select_row</link> (<link linkend="GtkCList">GtkCList</link> *clist,
195
<link linkend="gint">gint</link> row,
196
<link linkend="gint">gint</link> column);
197
<link linkend="void">void</link> <link linkend="gtk-clist-unselect-row">gtk_clist_unselect_row</link> (<link linkend="GtkCList">GtkCList</link> *clist,
198
<link linkend="gint">gint</link> row,
199
<link linkend="gint">gint</link> column);
200
<link linkend="void">void</link> <link linkend="gtk-clist-undo-selection">gtk_clist_undo_selection</link> (<link linkend="GtkCList">GtkCList</link> *clist);
201
<link linkend="void">void</link> <link linkend="gtk-clist-clear">gtk_clist_clear</link> (<link linkend="GtkCList">GtkCList</link> *clist);
202
<link linkend="gint">gint</link> <link linkend="gtk-clist-get-selection-info">gtk_clist_get_selection_info</link> (<link linkend="GtkCList">GtkCList</link> *clist,
203
<link linkend="gint">gint</link> x,
204
<link linkend="gint">gint</link> y,
205
<link linkend="gint">gint</link> *row,
206
<link linkend="gint">gint</link> *column);
207
<link linkend="void">void</link> <link linkend="gtk-clist-select-all">gtk_clist_select_all</link> (<link linkend="GtkCList">GtkCList</link> *clist);
208
<link linkend="void">void</link> <link linkend="gtk-clist-unselect-all">gtk_clist_unselect_all</link> (<link linkend="GtkCList">GtkCList</link> *clist);
209
<link linkend="void">void</link> <link linkend="gtk-clist-swap-rows">gtk_clist_swap_rows</link> (<link linkend="GtkCList">GtkCList</link> *clist,
210
<link linkend="gint">gint</link> row1,
211
<link linkend="gint">gint</link> row2);
212
<link linkend="void">void</link> <link linkend="gtk-clist-set-compare-func">gtk_clist_set_compare_func</link> (<link linkend="GtkCList">GtkCList</link> *clist,
213
<link linkend="GtkCListCompareFunc">GtkCListCompareFunc</link> cmp_func);
214
<link linkend="void">void</link> <link linkend="gtk-clist-set-sort-column">gtk_clist_set_sort_column</link> (<link linkend="GtkCList">GtkCList</link> *clist,
215
<link linkend="gint">gint</link> column);
216
<link linkend="void">void</link> <link linkend="gtk-clist-set-sort-type">gtk_clist_set_sort_type</link> (<link linkend="GtkCList">GtkCList</link> *clist,
217
<link linkend="GtkSortType">GtkSortType</link> sort_type);
218
<link linkend="void">void</link> <link linkend="gtk-clist-sort">gtk_clist_sort</link> (<link linkend="GtkCList">GtkCList</link> *clist);
219
<link linkend="void">void</link> <link linkend="gtk-clist-set-auto-sort">gtk_clist_set_auto_sort</link> (<link linkend="GtkCList">GtkCList</link> *clist,
220
<link linkend="gboolean">gboolean</link> auto_sort);
221
<link linkend="gint">gint</link> <link linkend="gtk-clist-columns-autosize">gtk_clist_columns_autosize</link> (<link linkend="GtkCList">GtkCList</link> *clist);
222
<link linkend="gchar">gchar</link>* <link linkend="gtk-clist-get-column-title">gtk_clist_get_column_title</link> (<link linkend="GtkCList">GtkCList</link> *clist,
223
<link linkend="gint">gint</link> column);
224
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gtk-clist-get-column-widget">gtk_clist_get_column_widget</link> (<link linkend="GtkCList">GtkCList</link> *clist,
225
<link linkend="gint">gint</link> column);
226
<link linkend="GtkAdjustment">GtkAdjustment</link>* <link linkend="gtk-clist-get-hadjustment">gtk_clist_get_hadjustment</link> (<link linkend="GtkCList">GtkCList</link> *clist);
227
<link linkend="GtkAdjustment">GtkAdjustment</link>* <link linkend="gtk-clist-get-vadjustment">gtk_clist_get_vadjustment</link> (<link linkend="GtkCList">GtkCList</link> *clist);
228
<link linkend="void">void</link> <link linkend="gtk-clist-row-move">gtk_clist_row_move</link> (<link linkend="GtkCList">GtkCList</link> *clist,
229
<link linkend="gint">gint</link> source_row,
230
<link linkend="gint">gint</link> dest_row);
231
<link linkend="void">void</link> <link linkend="gtk-clist-set-button-actions">gtk_clist_set_button_actions</link> (<link linkend="GtkCList">GtkCList</link> *clist,
232
<link linkend="guint">guint</link> button,
233
<link linkend="guint8">guint8</link> button_actions);
234
<link linkend="void">void</link> <link linkend="gtk-clist-set-hadjustment">gtk_clist_set_hadjustment</link> (<link linkend="GtkCList">GtkCList</link> *clist,
235
<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);
236
<link linkend="void">void</link> <link linkend="gtk-clist-set-reorderable">gtk_clist_set_reorderable</link> (<link linkend="GtkCList">GtkCList</link> *clist,
237
<link linkend="gboolean">gboolean</link> reorderable);
238
<link linkend="void">void</link> <link linkend="gtk-clist-set-use-drag-icons">gtk_clist_set_use_drag_icons</link> (<link linkend="GtkCList">GtkCList</link> *clist,
239
<link linkend="gboolean">gboolean</link> use_icons);
240
<link linkend="void">void</link> <link linkend="gtk-clist-set-vadjustment">gtk_clist_set_vadjustment</link> (<link linkend="GtkCList">GtkCList</link> *clist,
241
<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);
247
<refsect1 role="object_hierarchy">
248
<title role="object_hierarchy.title">Object Hierarchy</title>
251
<link linkend="GObject">GObject</link>
252
+----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
253
+----<link linkend="GtkObject">GtkObject</link>
254
+----<link linkend="GtkWidget">GtkWidget</link>
255
+----<link linkend="GtkContainer">GtkContainer</link>
257
+----<link linkend="GtkCTree">GtkCTree</link>
264
<refsect1 role="impl_interfaces">
265
<title role="impl_interfaces.title">Implemented Interfaces</title>
268
<link linkend="AtkImplementorIface">AtkImplementorIface</link>.</para>
273
<refsect1 role="properties">
274
<title role="properties.title">Properties</title>
277
"<link linkend="GtkCList--n-columns">n-columns</link>" <link linkend="guint">guint</link> : Read / Write / Construct Only
278
"<link linkend="GtkCList--reorderable">reorderable</link>" <link linkend="gboolean">gboolean</link> : Read / Write
279
"<link linkend="GtkCList--row-height">row-height</link>" <link linkend="guint">guint</link> : Read / Write
280
"<link linkend="GtkCList--selection-mode">selection-mode</link>" <link linkend="GtkSelectionMode">GtkSelectionMode</link> : Read / Write
281
"<link linkend="GtkCList--shadow-type">shadow-type</link>" <link linkend="GtkShadowType">GtkShadowType</link> : Read / Write
282
"<link linkend="GtkCList--sort-type">sort-type</link>" <link linkend="GtkSortType">GtkSortType</link> : Read / Write
283
"<link linkend="GtkCList--titles-active">titles-active</link>" <link linkend="gboolean">gboolean</link> : Read / Write
284
"<link linkend="GtkCList--use-drag-icons">use-drag-icons</link>" <link linkend="gboolean">gboolean</link> : Read / Write
288
<refsect1 role="signal_proto">
289
<title role="signal_proto.title">Signals</title>
292
"<link linkend="GtkCList-abort-column-resize">abort-column-resize</link>" : Run Last / Action
293
"<link linkend="GtkCList-click-column">click-column</link>" : Run First
294
"<link linkend="GtkCList-end-selection">end-selection</link>" : Run Last / Action
295
"<link linkend="GtkCList-extend-selection">extend-selection</link>" : Run Last / Action
296
"<link linkend="GtkCList-resize-column">resize-column</link>" : Run Last
297
"<link linkend="GtkCList-row-move">row-move</link>" : Run Last
298
"<link linkend="GtkCList-scroll-horizontal">scroll-horizontal</link>" : Run Last / Action
299
"<link linkend="GtkCList-scroll-vertical">scroll-vertical</link>" : Run Last / Action
300
"<link linkend="GtkCList-select-all">select-all</link>" : Run Last / Action
301
"<link linkend="GtkCList-select-row">select-row</link>" : Run First
302
"<link linkend="GtkCList-set-scroll-adjustments">set-scroll-adjustments</link>" : Run Last
303
"<link linkend="GtkCList-start-selection">start-selection</link>" : Run Last / Action
304
"<link linkend="GtkCList-toggle-add-mode">toggle-add-mode</link>" : Run Last / Action
305
"<link linkend="GtkCList-toggle-focus-row">toggle-focus-row</link>" : Run Last / Action
306
"<link linkend="GtkCList-undo-selection">undo-selection</link>" : Run Last / Action
307
"<link linkend="GtkCList-unselect-all">unselect-all</link>" : Run Last / Action
308
"<link linkend="GtkCList-unselect-row">unselect-row</link>" : Run First
313
<refsect1 role="desc">
314
<title role="desc.title">Description</title>
316
The <link linkend="GtkCList"><type>GtkCList</type></link> widget is a very useful multi-columned scrolling list.
317
It can display data in nicely aligned vertical columns, with titles
318
at the top of the list.
321
GtkCList has been deprecated since GTK+ 2.0 and should not be used
322
in newly written code. Use <link linkend="GtkTreeView"><type>GtkTreeView</type></link> instead.
326
<refsect1 role="details">
327
<title role="details.title">Details</title>
329
<title><anchor id="GtkCList-struct" role="struct"/>GtkCList</title>
330
<indexterm role="deprecated"><primary>GtkCList</primary></indexterm><programlisting>typedef struct _GtkCList GtkCList;</programlisting>
331
<warning><para><literal>GtkCList</literal> is deprecated and should not be used in newly-written code.</para></warning>
333
This is the embodiment of the <link linkend="GtkCList"><type>GtkCList</type></link> widget. This structure contains
334
only private data, and should be accessed only via the CList API.
337
<title><anchor id="GtkCellType" role="enum" condition="deprecated:"/>enum GtkCellType</title>
338
<indexterm role="deprecated"><primary>GtkCellType</primary></indexterm><programlisting>typedef enum
347
<warning><para><literal>GtkCellType</literal> is deprecated and should not be used in newly-written code.</para></warning>
349
Identifies the type of element in the current cell of the CList. Cells can
350
contain text, pixmaps, or both. Unfortunately support for <link linkend="GTK-CELL-WIDGET:CAPS"><literal>GTK_CELL_WIDGET</literal></link>
354
<title><anchor id="GtkButtonAction" role="enum" condition="deprecated:"/>enum GtkButtonAction</title>
355
<indexterm role="deprecated"><primary>GtkButtonAction</primary></indexterm><programlisting>typedef enum
357
GTK_BUTTON_IGNORED = 0,
358
GTK_BUTTON_SELECTS = 1 << 0,
359
GTK_BUTTON_DRAGS = 1 << 1,
360
GTK_BUTTON_EXPANDS = 1 << 2
363
<warning><para><literal>GtkButtonAction</literal> is deprecated and should not be used in newly-written code.</para></warning>
365
Values for specifying what mouse button events a CList will
369
<title><anchor id="GTK-CLIST-FLAGS:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_FLAGS()</title>
370
<indexterm role="deprecated"><primary>GTK_CLIST_FLAGS</primary></indexterm><programlisting>#define GTK_CLIST_FLAGS(clist) (GTK_CLIST (clist)->flags)
372
<warning><para><literal>GTK_CLIST_FLAGS</literal> is deprecated and should not be used in newly-written code.</para></warning>
374
Reads the current flags of the specified CList.
375
</para><variablelist role="params">
376
<varlistentry><term><parameter>clist</parameter> :</term>
377
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget from which to get the flags
380
</simpara></listitem></varlistentry>
381
</variablelist></refsect2>
383
<title><anchor id="GTK-CLIST-SET-FLAG:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_SET_FLAG()</title>
384
<indexterm role="deprecated"><primary>GTK_CLIST_SET_FLAG</primary></indexterm><programlisting>#define GTK_CLIST_SET_FLAG(clist,flag) (GTK_CLIST_FLAGS (clist) |= (GTK_ ## flag))
386
<warning><para><literal>GTK_CLIST_SET_FLAG</literal> is deprecated and should not be used in newly-written code.</para></warning>
388
A macro to set a particular flag for the specified CList.
389
</para><variablelist role="params">
390
<varlistentry><term><parameter>clist</parameter> :</term>
391
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to affect.
392
</simpara></listitem></varlistentry>
393
<varlistentry><term><parameter>flag</parameter> :</term>
394
<listitem><simpara>A single <link linkend="GtkCList"><type>GtkCList</type></link> flag to set. NOTE: Do not add the GTK_ prefix.
397
</simpara></listitem></varlistentry>
398
</variablelist></refsect2>
400
<title><anchor id="GTK-CLIST-UNSET-FLAG:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_UNSET_FLAG()</title>
401
<indexterm role="deprecated"><primary>GTK_CLIST_UNSET_FLAG</primary></indexterm><programlisting>#define GTK_CLIST_UNSET_FLAG(clist,flag) (GTK_CLIST_FLAGS (clist) &= ~(GTK_ ## flag))
403
<warning><para><literal>GTK_CLIST_UNSET_FLAG</literal> is deprecated and should not be used in newly-written code.</para></warning>
405
A macro to clear a particular flag for the specified CList.
406
</para><variablelist role="params">
407
<varlistentry><term><parameter>clist</parameter> :</term>
408
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to affect.
409
</simpara></listitem></varlistentry>
410
<varlistentry><term><parameter>flag</parameter> :</term>
411
<listitem><simpara>A single <link linkend="GtkCList"><type>GtkCList</type></link> flag to clear. NOTE: Do not add the GTK_ prefix.
414
</simpara></listitem></varlistentry>
415
</variablelist></refsect2>
417
<title><anchor id="GTK-CLIST-IN-DRAG:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_IN_DRAG()</title>
418
<indexterm role="deprecated"><primary>GTK_CLIST_IN_DRAG</primary></indexterm><programlisting>#define GTK_CLIST_IN_DRAG(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_IN_DRAG)
420
<warning><para><literal>GTK_CLIST_IN_DRAG</literal> is deprecated and should not be used in newly-written code.</para></warning>
422
A macro to check whether the <link linkend="GtkCList"><type>GtkCList</type></link> is in "drag mode."
423
</para><variablelist role="params">
424
<varlistentry><term><parameter>clist</parameter> :</term>
425
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to check.
428
</simpara></listitem></varlistentry>
429
</variablelist></refsect2>
431
<title><anchor id="GTK-CLIST-ROW-HEIGHT-SET:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_ROW_HEIGHT_SET()</title>
432
<indexterm role="deprecated"><primary>GTK_CLIST_ROW_HEIGHT_SET</primary></indexterm><programlisting>#define GTK_CLIST_ROW_HEIGHT_SET(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_ROW_HEIGHT_SET)
434
<warning><para><literal>GTK_CLIST_ROW_HEIGHT_SET</literal> is deprecated and should not be used in newly-written code.</para></warning>
436
A macro to check whether the <link linkend="GtkCList"><type>GtkCList</type></link>'s row height is set.
437
</para><variablelist role="params">
438
<varlistentry><term><parameter>clist</parameter> :</term>
439
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to check.
442
</simpara></listitem></varlistentry>
443
</variablelist></refsect2>
445
<title><anchor id="GTK-CLIST-SHOW-TITLES:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_SHOW_TITLES()</title>
446
<indexterm role="deprecated"><primary>GTK_CLIST_SHOW_TITLES</primary></indexterm><programlisting>#define GTK_CLIST_SHOW_TITLES(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_SHOW_TITLES)
448
<warning><para><literal>GTK_CLIST_SHOW_TITLES</literal> is deprecated and should not be used in newly-written code.</para></warning>
450
A macro to check whether the flag for showing the
451
widget's column titles is set.
452
</para><variablelist role="params">
453
<varlistentry><term><parameter>clist</parameter> :</term>
454
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
457
</simpara></listitem></varlistentry>
458
</variablelist></refsect2>
460
<title><anchor id="GTK-CLIST-ADD-MODE:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_ADD_MODE()</title>
461
<indexterm role="deprecated"><primary>GTK_CLIST_ADD_MODE</primary></indexterm><programlisting>#define GTK_CLIST_ADD_MODE(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_ADD_MODE)
463
<warning><para><literal>GTK_CLIST_ADD_MODE</literal> is deprecated and should not be used in newly-written code.</para></warning>
465
A macro to test whether the CList is in "add mode."
466
</para><variablelist role="params">
467
<varlistentry><term><parameter>clist</parameter> :</term>
468
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
471
</simpara></listitem></varlistentry>
472
</variablelist></refsect2>
474
<title><anchor id="GTK-CLIST-AUTO-SORT:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_AUTO_SORT()</title>
475
<indexterm role="deprecated"><primary>GTK_CLIST_AUTO_SORT</primary></indexterm><programlisting>#define GTK_CLIST_AUTO_SORT(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_AUTO_SORT)
477
<warning><para><literal>GTK_CLIST_AUTO_SORT</literal> is deprecated and should not be used in newly-written code.</para></warning>
479
A macro to test whether the CList has automatic sorting
481
</para><variablelist role="params">
482
<varlistentry><term><parameter>clist</parameter> :</term>
483
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
486
</simpara></listitem></varlistentry>
487
</variablelist></refsect2>
489
<title><anchor id="GTK-CLIST-AUTO-RESIZE-BLOCKED:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_AUTO_RESIZE_BLOCKED()</title>
490
<indexterm role="deprecated"><primary>GTK_CLIST_AUTO_RESIZE_BLOCKED</primary></indexterm><programlisting>#define GTK_CLIST_AUTO_RESIZE_BLOCKED(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_AUTO_RESIZE_BLOCKED)
492
<warning><para><literal>GTK_CLIST_AUTO_RESIZE_BLOCKED</literal> is deprecated and should not be used in newly-written code.</para></warning>
494
A macro to check if automatic resizing of columns is blocked.
495
</para><variablelist role="params">
496
<varlistentry><term><parameter>clist</parameter> :</term>
497
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
500
</simpara></listitem></varlistentry>
501
</variablelist></refsect2>
503
<title><anchor id="GTK-CLIST-REORDERABLE:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_REORDERABLE()</title>
504
<indexterm role="deprecated"><primary>GTK_CLIST_REORDERABLE</primary></indexterm><programlisting>#define GTK_CLIST_REORDERABLE(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_REORDERABLE)
506
<warning><para><literal>GTK_CLIST_REORDERABLE</literal> is deprecated and should not be used in newly-written code.</para></warning>
508
A macro to test if the CList's columns are re-orderable
509
</para><variablelist role="params">
510
<varlistentry><term><parameter>clist</parameter> :</term>
511
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
514
</simpara></listitem></varlistentry>
515
</variablelist></refsect2>
517
<title><anchor id="GTK-CLIST-USE-DRAG-ICONS:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_USE_DRAG_ICONS()</title>
518
<indexterm role="deprecated"><primary>GTK_CLIST_USE_DRAG_ICONS</primary></indexterm><programlisting>#define GTK_CLIST_USE_DRAG_ICONS(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_USE_DRAG_ICONS)
520
<warning><para><literal>GTK_CLIST_USE_DRAG_ICONS</literal> is deprecated and should not be used in newly-written code.</para></warning>
522
A macro to check if the USE_DRAG_ICONS property is enabled.
523
</para><variablelist role="params">
524
<varlistentry><term><parameter>clist</parameter> :</term>
525
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
528
</simpara></listitem></varlistentry>
529
</variablelist></refsect2>
531
<title><anchor id="GTK-CLIST-DRAW-DRAG-LINE:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_DRAW_DRAG_LINE()</title>
532
<indexterm role="deprecated"><primary>GTK_CLIST_DRAW_DRAG_LINE</primary></indexterm><programlisting>#define GTK_CLIST_DRAW_DRAG_LINE(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_DRAW_DRAG_LINE)
534
<warning><para><literal>GTK_CLIST_DRAW_DRAG_LINE</literal> is deprecated and should not be used in newly-written code.</para></warning>
536
A macro to check if the DRAW_DRAG_LINE property is enabled.
537
</para><variablelist role="params">
538
<varlistentry><term><parameter>clist</parameter> :</term>
539
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
542
</simpara></listitem></varlistentry>
543
</variablelist></refsect2>
545
<title><anchor id="GTK-CLIST-DRAW-DRAG-RECT:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_DRAW_DRAG_RECT()</title>
546
<indexterm role="deprecated"><primary>GTK_CLIST_DRAW_DRAG_RECT</primary></indexterm><programlisting>#define GTK_CLIST_DRAW_DRAG_RECT(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_DRAW_DRAG_RECT)
548
<warning><para><literal>GTK_CLIST_DRAW_DRAG_RECT</literal> is deprecated and should not be used in newly-written code.</para></warning>
550
A macro to check if the DRAW_DRAG_RECT property is enabled.
551
</para><variablelist role="params">
552
<varlistentry><term><parameter>clist</parameter> :</term>
553
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
556
</simpara></listitem></varlistentry>
557
</variablelist></refsect2>
559
<title><anchor id="GTK-CLIST-ROW:CAPS" role="macro" condition="deprecated:"/>GTK_CLIST_ROW()</title>
560
<indexterm role="deprecated"><primary>GTK_CLIST_ROW</primary></indexterm><programlisting>#define GTK_CLIST_ROW(_glist_) ((GtkCListRow *)((_glist_)->data))
562
<warning><para><literal>GTK_CLIST_ROW</literal> is deprecated and should not be used in newly-written code.</para></warning>
564
A macro to cast a GList element to a CListRow pointer.
565
</para><variablelist role="params">
566
<varlistentry><term><parameter>_glist_</parameter> :</term>
567
<listitem><simpara>The GList element to convert.
570
</simpara></listitem></varlistentry>
571
</variablelist></refsect2>
573
<title><anchor id="GTK-CELL-TEXT:CAPS" role="macro" condition="deprecated:"/>GTK_CELL_TEXT()</title>
574
<indexterm role="deprecated"><primary>GTK_CELL_TEXT</primary></indexterm><programlisting>#define GTK_CELL_TEXT(cell) (((GtkCellText *) &(cell)))
576
<warning><para><literal>GTK_CELL_TEXT</literal> is deprecated and should not be used in newly-written code.</para></warning>
578
A macro to cast a generic <link linkend="GtkCList"><type>GtkCList</type></link> cell item to a GtkCellText pointer.
579
</para><variablelist role="params">
580
<varlistentry><term><parameter>cell</parameter> :</term>
581
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> cell item to convert.
584
</simpara></listitem></varlistentry>
585
</variablelist></refsect2>
587
<title><anchor id="GTK-CELL-PIXMAP:CAPS" role="macro" condition="deprecated:"/>GTK_CELL_PIXMAP()</title>
588
<indexterm role="deprecated"><primary>GTK_CELL_PIXMAP</primary></indexterm><programlisting>#define GTK_CELL_PIXMAP(cell) (((GtkCellPixmap *) &(cell)))
590
<warning><para><literal>GTK_CELL_PIXMAP</literal> is deprecated and should not be used in newly-written code.</para></warning>
592
A macro to cast a generic <link linkend="GtkCList"><type>GtkCList</type></link> cell item to a GtkCellPixmap pointer.
593
</para><variablelist role="params">
594
<varlistentry><term><parameter>cell</parameter> :</term>
595
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> cell item to convert.
598
</simpara></listitem></varlistentry>
599
</variablelist></refsect2>
601
<title><anchor id="GTK-CELL-PIXTEXT:CAPS" role="macro" condition="deprecated:"/>GTK_CELL_PIXTEXT()</title>
602
<indexterm role="deprecated"><primary>GTK_CELL_PIXTEXT</primary></indexterm><programlisting>#define GTK_CELL_PIXTEXT(cell) (((GtkCellPixText *) &(cell)))
604
<warning><para><literal>GTK_CELL_PIXTEXT</literal> is deprecated and should not be used in newly-written code.</para></warning>
606
A macro to cast a generic <link linkend="GtkCList"><type>GtkCList</type></link> cell item to a GtkCellPixText pointer.
607
</para><variablelist role="params">
608
<varlistentry><term><parameter>cell</parameter> :</term>
609
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> cell item to convert.
612
</simpara></listitem></varlistentry>
613
</variablelist></refsect2>
615
<title><anchor id="GTK-CELL-WIDGET:CAPS" role="macro" condition="deprecated:"/>GTK_CELL_WIDGET()</title>
616
<indexterm role="deprecated"><primary>GTK_CELL_WIDGET</primary></indexterm><programlisting>#define GTK_CELL_WIDGET(cell) (((GtkCellWidget *) &(cell)))
618
<warning><para><literal>GTK_CELL_WIDGET</literal> is deprecated and should not be used in newly-written code.</para></warning>
620
A macro to cast a generic <link linkend="GtkCList"><type>GtkCList</type></link> cell item to a GtkCellWidget pointer.
621
</para><variablelist role="params">
622
<varlistentry><term><parameter>cell</parameter> :</term>
623
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> cell item to convert.
626
</simpara></listitem></varlistentry>
627
</variablelist></refsect2>
629
<title><anchor id="GtkCListCompareFunc" role="function" condition="deprecated:"/>GtkCListCompareFunc ()</title>
630
<indexterm role="deprecated"><primary>GtkCListCompareFunc</primary></indexterm><programlisting><link linkend="gint">gint</link> (*GtkCListCompareFunc) (<link linkend="GtkCList">GtkCList</link> *clist,
631
<link linkend="gconstpointer">gconstpointer</link> ptr1,
632
<link linkend="gconstpointer">gconstpointer</link> ptr2);</programlisting>
633
<warning><para><literal>GtkCListCompareFunc</literal> is deprecated and should not be used in newly-written code.</para></warning>
635
Function prototype for the compare function callback.
636
</para><variablelist role="params">
637
<varlistentry><term><parameter>clist</parameter> :</term>
638
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> that is affected.
639
</simpara></listitem></varlistentry>
640
<varlistentry><term><parameter>ptr1</parameter> :</term>
641
<listitem><simpara>A <link linkend="gconstpointer"><type>gconstpointer</type></link> to the first node to compare.
642
</simpara></listitem></varlistentry>
643
<varlistentry><term><parameter>ptr2</parameter> :</term>
644
<listitem><simpara>A <link linkend="gconstpointer"><type>gconstpointer</type></link> to the second node to compare.
645
</simpara></listitem></varlistentry>
646
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>0 if the nodes are equal, less than 0 if the first node should
647
come before the second, and greater than 1 if the second come before the
651
</simpara></listitem></varlistentry>
652
</variablelist></refsect2>
654
<title><anchor id="GtkCListColumn" role="struct" condition="deprecated:"/>GtkCListColumn</title>
655
<indexterm role="deprecated"><primary>GtkCListColumn</primary></indexterm><programlisting>typedef struct {
665
GtkJustification justification;
669
guint resizeable : 1;
670
guint auto_resize : 1;
671
guint button_passive : 1;
674
<warning><para><literal>GtkCListColumn</literal> is deprecated and should not be used in newly-written code.</para></warning>
676
A structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to keep track of information
680
<title><anchor id="GtkCListRow" role="struct" condition="deprecated:"/>GtkCListRow</title>
681
<indexterm role="deprecated"><primary>GtkCListRow</primary></indexterm><programlisting>typedef struct {
691
GtkDestroyNotify destroy;
695
guint selectable : 1;
698
<warning><para><literal>GtkCListRow</literal> is deprecated and should not be used in newly-written code.</para></warning>
700
A structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to keep track of information
704
<title><anchor id="GtkCellText" role="struct" condition="deprecated:"/>GtkCellText</title>
705
<indexterm role="deprecated"><primary>GtkCellText</primary></indexterm><programlisting>typedef struct {
716
<warning><para><literal>GtkCellText</literal> is deprecated and should not be used in newly-written code.</para></warning>
718
A structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to keep track of <link linkend="GtkCList"><type>GtkCList</type></link> cells
722
<title><anchor id="GtkCellPixmap" role="struct" condition="deprecated:"/>GtkCellPixmap</title>
723
<indexterm role="deprecated"><primary>GtkCellPixmap</primary></indexterm><programlisting>typedef struct {
735
<warning><para><literal>GtkCellPixmap</literal> is deprecated and should not be used in newly-written code.</para></warning>
737
A structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to keep track of <link linkend="GtkCList"><type>GtkCList</type></link> cells
738
that contain a GdkPixmap.
741
<title><anchor id="GtkCellPixText" role="struct" condition="deprecated:"/>GtkCellPixText</title>
742
<indexterm role="deprecated"><primary>GtkCellPixText</primary></indexterm><programlisting>typedef struct {
756
<warning><para><literal>GtkCellPixText</literal> is deprecated and should not be used in newly-written code.</para></warning>
758
A structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to keep track of <link linkend="GtkCList"><type>GtkCList</type></link> cells
759
that contain a combination of text and a GdkPixmap.
762
<title><anchor id="GtkCellWidget" role="struct" condition="deprecated:"/>GtkCellWidget</title>
763
<indexterm role="deprecated"><primary>GtkCellWidget</primary></indexterm><programlisting>typedef struct {
774
<warning><para><literal>GtkCellWidget</literal> is deprecated and should not be used in newly-written code.</para></warning>
776
A structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to keep track of <link linkend="GtkCList"><type>GtkCList</type></link> cells
777
that contain another widget.
780
<title><anchor id="GtkCell" role="struct" condition="deprecated:"/>GtkCell</title>
781
<indexterm role="deprecated"><primary>GtkCell</primary></indexterm><programlisting>typedef struct {
808
<warning><para><literal>GtkCell</literal> is deprecated and should not be used in newly-written code.</para></warning>
810
A generic structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to keep track of the
811
contents of each of its cells.
814
<title><anchor id="GtkCListCellInfo" role="struct" condition="deprecated:"/>GtkCListCellInfo</title>
815
<indexterm role="deprecated"><primary>GtkCListCellInfo</primary></indexterm><programlisting>typedef struct {
820
<warning><para><literal>GtkCListCellInfo</literal> is deprecated and should not be used in newly-written code.</para></warning>
822
A simple structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to keep track
823
of the location of a cell.
826
<title><anchor id="GtkCListDestInfo" role="struct" condition="deprecated:"/>GtkCListDestInfo</title>
827
<indexterm role="deprecated"><primary>GtkCListDestInfo</primary></indexterm><programlisting>typedef struct {
828
GtkCListCellInfo cell;
829
GtkCListDragPos insert_pos;
832
<warning><para><literal>GtkCListDestInfo</literal> is deprecated and should not be used in newly-written code.</para></warning>
834
A simple structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to track
835
a cell for a drag operation.
838
<title><anchor id="GtkCListDragPos" role="enum" condition="deprecated:"/>enum GtkCListDragPos</title>
839
<indexterm role="deprecated"><primary>GtkCListDragPos</primary></indexterm><programlisting>typedef enum
842
GTK_CLIST_DRAG_BEFORE,
847
<warning><para><literal>GtkCListDragPos</literal> is deprecated and should not be used in newly-written code.</para></warning>
849
An enumeration for drag operations.
852
<title><anchor id="gtk-clist-new" role="function" condition="deprecated:"/>gtk_clist_new ()</title>
853
<indexterm role="deprecated"><primary>gtk_clist_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gtk_clist_new (<link linkend="gint">gint</link> columns);</programlisting>
854
<warning><para><literal>gtk_clist_new</literal> is deprecated and should not be used in newly-written code.</para></warning>
856
Creates a new <link linkend="GtkCList"><type>GtkCList</type></link> widget for use.
857
</para><variablelist role="params">
858
<varlistentry><term><parameter>columns</parameter> :</term>
859
<listitem><simpara>The number of columns the <link linkend="GtkCList"><type>GtkCList</type></link> should have.
860
</simpara></listitem></varlistentry>
861
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>A pointer to a new GtkCList object.
864
</simpara></listitem></varlistentry>
865
</variablelist></refsect2>
867
<title><anchor id="gtk-clist-new-with-titles" role="function" condition="deprecated:"/>gtk_clist_new_with_titles ()</title>
868
<indexterm role="deprecated"><primary>gtk_clist_new_with_titles</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gtk_clist_new_with_titles (<link linkend="gint">gint</link> columns,
869
<link linkend="gchar">gchar</link> *titles[]);</programlisting>
870
<warning><para><literal>gtk_clist_new_with_titles</literal> is deprecated and should not be used in newly-written code.</para></warning>
872
Creates a new <link linkend="GtkCList"><type>GtkCList</type></link> widget with column titles for use.
873
</para><variablelist role="params">
874
<varlistentry><term><parameter>columns</parameter> :</term>
875
<listitem><simpara>The number of columns the <link linkend="GtkCList"><type>GtkCList</type></link> should have.
876
</simpara></listitem></varlistentry>
877
<varlistentry><term><parameter>titles</parameter> :</term>
878
<listitem><simpara>A string array of titles for the widget. There should be
879
enough strings in the array for the specified number of columns.
880
</simpara></listitem></varlistentry>
881
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>A pointer to a new GtkCList object.
884
</simpara></listitem></varlistentry>
885
</variablelist></refsect2>
887
<title><anchor id="gtk-clist-set-shadow-type" role="function" condition="deprecated:"/>gtk_clist_set_shadow_type ()</title>
888
<indexterm role="deprecated"><primary>gtk_clist_set_shadow_type</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_shadow_type (<link linkend="GtkCList">GtkCList</link> *clist,
889
<link linkend="GtkShadowType">GtkShadowType</link> type);</programlisting>
890
<warning><para><literal>gtk_clist_set_shadow_type</literal> is deprecated and should not be used in newly-written code.</para></warning>
892
Sets the shadow type for the specified CList. Changing this value
893
will cause the <link linkend="GtkCList"><type>GtkCList</type></link> to update its visuals.
894
</para><variablelist role="params">
895
<varlistentry><term><parameter>clist</parameter> :</term>
896
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
897
</simpara></listitem></varlistentry>
898
<varlistentry><term><parameter>type</parameter> :</term>
899
<listitem><simpara>The GtkShadowType desired.
902
</simpara></listitem></varlistentry>
903
</variablelist></refsect2>
905
<title><anchor id="gtk-clist-set-selection-mode" role="function" condition="deprecated:"/>gtk_clist_set_selection_mode ()</title>
906
<indexterm role="deprecated"><primary>gtk_clist_set_selection_mode</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_selection_mode (<link linkend="GtkCList">GtkCList</link> *clist,
907
<link linkend="GtkSelectionMode">GtkSelectionMode</link> mode);</programlisting>
908
<warning><para><literal>gtk_clist_set_selection_mode</literal> is deprecated and should not be used in newly-written code.</para></warning>
910
Sets the selection mode for the specified CList. This allows you to
911
set whether only one or more than one item can be selected at a time
912
in the widget. Note that setting the widget's selection mode to one
913
of GTK_SELECTION_BROWSE or GTK_SELECTION_SINGLE will cause all the
914
items in the <link linkend="GtkCList"><type>GtkCList</type></link> to become deselected.
915
</para><variablelist role="params">
916
<varlistentry><term><parameter>clist</parameter> :</term>
917
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
918
</simpara></listitem></varlistentry>
919
<varlistentry><term><parameter>mode</parameter> :</term>
920
<listitem><simpara>The GtkSelectionMode type to set for this CList.
923
</simpara></listitem></varlistentry>
924
</variablelist></refsect2>
926
<title><anchor id="gtk-clist-freeze" role="function" condition="deprecated:"/>gtk_clist_freeze ()</title>
927
<indexterm role="deprecated"><primary>gtk_clist_freeze</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_freeze (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
928
<warning><para><literal>gtk_clist_freeze</literal> is deprecated and should not be used in newly-written code.</para></warning>
930
Causes the <link linkend="GtkCList"><type>GtkCList</type></link> to stop updating its visuals until a matching call to
931
<link linkend="gtk-clist-thaw"><function>gtk_clist_thaw()</function></link> is made. This function is useful if a lot of changes
932
will be made to the widget that may cause a lot of visual updating to
933
occur. Note that calls to <link linkend="gtk-clist-freeze"><function>gtk_clist_freeze()</function></link> can be nested.
934
</para><variablelist role="params">
935
<varlistentry><term><parameter>clist</parameter> :</term>
936
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to freeze.
939
</simpara></listitem></varlistentry>
940
</variablelist></refsect2>
942
<title><anchor id="gtk-clist-thaw" role="function" condition="deprecated:"/>gtk_clist_thaw ()</title>
943
<indexterm role="deprecated"><primary>gtk_clist_thaw</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_thaw (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
944
<warning><para><literal>gtk_clist_thaw</literal> is deprecated and should not be used in newly-written code.</para></warning>
946
Causes the specified <link linkend="GtkCList"><type>GtkCList</type></link> to allow visual updates.
947
</para><variablelist role="params">
948
<varlistentry><term><parameter>clist</parameter> :</term>
949
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to thaw.
952
</simpara></listitem></varlistentry>
953
</variablelist></refsect2>
955
<title><anchor id="gtk-clist-column-titles-show" role="function" condition="deprecated:"/>gtk_clist_column_titles_show ()</title>
956
<indexterm role="deprecated"><primary>gtk_clist_column_titles_show</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_column_titles_show (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
957
<warning><para><literal>gtk_clist_column_titles_show</literal> is deprecated and should not be used in newly-written code.</para></warning>
959
This function causes the <link linkend="GtkCList"><type>GtkCList</type></link> to show its column titles, if
960
they are not already showing.
961
</para><variablelist role="params">
962
<varlistentry><term><parameter>clist</parameter> :</term>
963
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
966
</simpara></listitem></varlistentry>
967
</variablelist></refsect2>
969
<title><anchor id="gtk-clist-column-titles-hide" role="function" condition="deprecated:"/>gtk_clist_column_titles_hide ()</title>
970
<indexterm role="deprecated"><primary>gtk_clist_column_titles_hide</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_column_titles_hide (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
971
<warning><para><literal>gtk_clist_column_titles_hide</literal> is deprecated and should not be used in newly-written code.</para></warning>
973
Causes the <link linkend="GtkCList"><type>GtkCList</type></link> to hide its column titles, if they are currently
975
</para><variablelist role="params">
976
<varlistentry><term><parameter>clist</parameter> :</term>
977
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
980
</simpara></listitem></varlistentry>
981
</variablelist></refsect2>
983
<title><anchor id="gtk-clist-column-title-active" role="function" condition="deprecated:"/>gtk_clist_column_title_active ()</title>
984
<indexterm role="deprecated"><primary>gtk_clist_column_title_active</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_column_title_active (<link linkend="GtkCList">GtkCList</link> *clist,
985
<link linkend="gint">gint</link> column);</programlisting>
986
<warning><para><literal>gtk_clist_column_title_active</literal> is deprecated and should not be used in newly-written code.</para></warning>
988
Sets the specified column in the <link linkend="GtkCList"><type>GtkCList</type></link> to become selectable. You can
989
then respond to events from the user clicking on a title button, and take
991
</para><variablelist role="params">
992
<varlistentry><term><parameter>clist</parameter> :</term>
993
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
994
</simpara></listitem></varlistentry>
995
<varlistentry><term><parameter>column</parameter> :</term>
996
<listitem><simpara>The column to make active, counting from 0.
999
</simpara></listitem></varlistentry>
1000
</variablelist></refsect2>
1002
<title><anchor id="gtk-clist-column-title-passive" role="function" condition="deprecated:"/>gtk_clist_column_title_passive ()</title>
1003
<indexterm role="deprecated"><primary>gtk_clist_column_title_passive</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_column_title_passive (<link linkend="GtkCList">GtkCList</link> *clist,
1004
<link linkend="gint">gint</link> column);</programlisting>
1005
<warning><para><literal>gtk_clist_column_title_passive</literal> is deprecated and should not be used in newly-written code.</para></warning>
1007
Causes the specified column title button to become passive, i.e., does
1008
not respond to events, such as the user clicking on it.
1009
</para><variablelist role="params">
1010
<varlistentry><term><parameter>clist</parameter> :</term>
1011
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1012
</simpara></listitem></varlistentry>
1013
<varlistentry><term><parameter>column</parameter> :</term>
1014
<listitem><simpara>The column to make passive, counting from 0.
1017
</simpara></listitem></varlistentry>
1018
</variablelist></refsect2>
1020
<title><anchor id="gtk-clist-column-titles-active" role="function" condition="deprecated:"/>gtk_clist_column_titles_active ()</title>
1021
<indexterm role="deprecated"><primary>gtk_clist_column_titles_active</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_column_titles_active (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
1022
<warning><para><literal>gtk_clist_column_titles_active</literal> is deprecated and should not be used in newly-written code.</para></warning>
1024
Causes all column title buttons to become active. This is the same
1025
as calling <link linkend="gtk-clist-column-title-active"><function>gtk_clist_column_title_active()</function></link> for each column.
1026
</para><variablelist role="params">
1027
<varlistentry><term><parameter>clist</parameter> :</term>
1028
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1031
</simpara></listitem></varlistentry>
1032
</variablelist></refsect2>
1034
<title><anchor id="gtk-clist-column-titles-passive" role="function" condition="deprecated:"/>gtk_clist_column_titles_passive ()</title>
1035
<indexterm role="deprecated"><primary>gtk_clist_column_titles_passive</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_column_titles_passive (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
1036
<warning><para><literal>gtk_clist_column_titles_passive</literal> is deprecated and should not be used in newly-written code.</para></warning>
1038
Causes all column title buttons to become passive. This is the same
1039
as calling <link linkend="gtk-clist-column-title-passive"><function>gtk_clist_column_title_passive()</function></link> for each column.
1040
</para><variablelist role="params">
1041
<varlistentry><term><parameter>clist</parameter> :</term>
1042
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1045
</simpara></listitem></varlistentry>
1046
</variablelist></refsect2>
1048
<title><anchor id="gtk-clist-set-column-title" role="function" condition="deprecated:"/>gtk_clist_set_column_title ()</title>
1049
<indexterm role="deprecated"><primary>gtk_clist_set_column_title</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_column_title (<link linkend="GtkCList">GtkCList</link> *clist,
1050
<link linkend="gint">gint</link> column,
1051
const <link linkend="gchar">gchar</link> *title);</programlisting>
1052
<warning><para><literal>gtk_clist_set_column_title</literal> is deprecated and should not be used in newly-written code.</para></warning>
1054
Sets the title for the specified column.
1055
</para><variablelist role="params">
1056
<varlistentry><term><parameter>clist</parameter> :</term>
1057
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1058
</simpara></listitem></varlistentry>
1059
<varlistentry><term><parameter>column</parameter> :</term>
1060
<listitem><simpara>The column whose title should be changed.
1061
</simpara></listitem></varlistentry>
1062
<varlistentry><term><parameter>title</parameter> :</term>
1063
<listitem><simpara>A string to be the column's title.
1066
</simpara></listitem></varlistentry>
1067
</variablelist></refsect2>
1069
<title><anchor id="gtk-clist-set-column-widget" role="function" condition="deprecated:"/>gtk_clist_set_column_widget ()</title>
1070
<indexterm role="deprecated"><primary>gtk_clist_set_column_widget</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_column_widget (<link linkend="GtkCList">GtkCList</link> *clist,
1071
<link linkend="gint">gint</link> column,
1072
<link linkend="GtkWidget">GtkWidget</link> *widget);</programlisting>
1073
<warning><para><literal>gtk_clist_set_column_widget</literal> is deprecated and should not be used in newly-written code.</para></warning>
1075
Sets a widget to be used as the specified column's title. This
1076
can be used to place a pixmap or something else as the column
1077
title, instead of the standard text.
1078
</para><variablelist role="params">
1079
<varlistentry><term><parameter>clist</parameter> :</term>
1080
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1081
</simpara></listitem></varlistentry>
1082
<varlistentry><term><parameter>column</parameter> :</term>
1083
<listitem><simpara>The column whose title should be a widget.
1084
</simpara></listitem></varlistentry>
1085
<varlistentry><term><parameter>widget</parameter> :</term>
1086
<listitem><simpara>A pointer to a previously create widget.
1089
</simpara></listitem></varlistentry>
1090
</variablelist></refsect2>
1092
<title><anchor id="gtk-clist-set-column-justification" role="function" condition="deprecated:"/>gtk_clist_set_column_justification ()</title>
1093
<indexterm role="deprecated"><primary>gtk_clist_set_column_justification</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_column_justification (<link linkend="GtkCList">GtkCList</link> *clist,
1094
<link linkend="gint">gint</link> column,
1095
<link linkend="GtkJustification">GtkJustification</link> justification);</programlisting>
1096
<warning><para><literal>gtk_clist_set_column_justification</literal> is deprecated and should not be used in newly-written code.</para></warning>
1098
Sets the justification to be used for all text in the specified
1100
</para><variablelist role="params">
1101
<varlistentry><term><parameter>clist</parameter> :</term>
1102
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1103
</simpara></listitem></varlistentry>
1104
<varlistentry><term><parameter>column</parameter> :</term>
1105
<listitem><simpara>The column which should be affected.
1106
</simpara></listitem></varlistentry>
1107
<varlistentry><term><parameter>justification</parameter> :</term>
1108
<listitem><simpara>A GtkJustification value for the column.
1111
</simpara></listitem></varlistentry>
1112
</variablelist></refsect2>
1114
<title><anchor id="gtk-clist-set-column-visibility" role="function" condition="deprecated:"/>gtk_clist_set_column_visibility ()</title>
1115
<indexterm role="deprecated"><primary>gtk_clist_set_column_visibility</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_column_visibility (<link linkend="GtkCList">GtkCList</link> *clist,
1116
<link linkend="gint">gint</link> column,
1117
<link linkend="gboolean">gboolean</link> visible);</programlisting>
1118
<warning><para><literal>gtk_clist_set_column_visibility</literal> is deprecated and should not be used in newly-written code.</para></warning>
1120
Allows you to set whether a specified column in the <link linkend="GtkCList"><type>GtkCList</type></link> should
1121
be hidden or shown. Note that at least one column must always be
1122
showing, so attempting to hide the last visible column will be
1124
</para><variablelist role="params">
1125
<varlistentry><term><parameter>clist</parameter> :</term>
1126
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1127
</simpara></listitem></varlistentry>
1128
<varlistentry><term><parameter>column</parameter> :</term>
1129
<listitem><simpara>The column to set visibility.
1130
</simpara></listitem></varlistentry>
1131
<varlistentry><term><parameter>visible</parameter> :</term>
1132
<listitem><simpara><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
1135
</simpara></listitem></varlistentry>
1136
</variablelist></refsect2>
1138
<title><anchor id="gtk-clist-set-column-resizeable" role="function" condition="deprecated:"/>gtk_clist_set_column_resizeable ()</title>
1139
<indexterm role="deprecated"><primary>gtk_clist_set_column_resizeable</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_column_resizeable (<link linkend="GtkCList">GtkCList</link> *clist,
1140
<link linkend="gint">gint</link> column,
1141
<link linkend="gboolean">gboolean</link> resizeable);</programlisting>
1142
<warning><para><literal>gtk_clist_set_column_resizeable</literal> is deprecated and should not be used in newly-written code.</para></warning>
1144
Lets you specify whether a specified column should be resizeable
1145
by the user. Note that turning on resizeability for the column will
1146
automatically shut off auto-resizing, but turning off resizeability
1147
will NOT turn on auto-resizing. This must be done manually via a
1148
call to <link linkend="gtk-clist-set-column-auto-resize"><function>gtk_clist_set_column_auto_resize()</function></link>.
1149
</para><variablelist role="params">
1150
<varlistentry><term><parameter>clist</parameter> :</term>
1151
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1152
</simpara></listitem></varlistentry>
1153
<varlistentry><term><parameter>column</parameter> :</term>
1154
<listitem><simpara>The column on which to set resizeability.
1155
</simpara></listitem></varlistentry>
1156
<varlistentry><term><parameter>resizeable</parameter> :</term>
1157
<listitem><simpara><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
1160
</simpara></listitem></varlistentry>
1161
</variablelist></refsect2>
1163
<title><anchor id="gtk-clist-set-column-auto-resize" role="function" condition="deprecated:"/>gtk_clist_set_column_auto_resize ()</title>
1164
<indexterm role="deprecated"><primary>gtk_clist_set_column_auto_resize</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_column_auto_resize (<link linkend="GtkCList">GtkCList</link> *clist,
1165
<link linkend="gint">gint</link> column,
1166
<link linkend="gboolean">gboolean</link> auto_resize);</programlisting>
1167
<warning><para><literal>gtk_clist_set_column_auto_resize</literal> is deprecated and should not be used in newly-written code.</para></warning>
1169
Lets you specify whether a column should be automatically resized
1170
by the widget when data is added or removed. Enabling auto-resize
1171
on a column explicity disallows user-resizing of the column.
1172
</para><variablelist role="params">
1173
<varlistentry><term><parameter>clist</parameter> :</term>
1174
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1175
</simpara></listitem></varlistentry>
1176
<varlistentry><term><parameter>column</parameter> :</term>
1177
<listitem><simpara>The column on which to set auto-resizing.
1178
</simpara></listitem></varlistentry>
1179
<varlistentry><term><parameter>auto_resize</parameter> :</term>
1180
<listitem><simpara><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
1183
</simpara></listitem></varlistentry>
1184
</variablelist></refsect2>
1186
<title><anchor id="gtk-clist-optimal-column-width" role="function" condition="deprecated:"/>gtk_clist_optimal_column_width ()</title>
1187
<indexterm role="deprecated"><primary>gtk_clist_optimal_column_width</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_clist_optimal_column_width (<link linkend="GtkCList">GtkCList</link> *clist,
1188
<link linkend="gint">gint</link> column);</programlisting>
1189
<warning><para><literal>gtk_clist_optimal_column_width</literal> is deprecated and should not be used in newly-written code.</para></warning>
1191
Gets the required width in pixels that is needed to show
1192
everything in the specified column.
1193
</para><variablelist role="params">
1194
<varlistentry><term><parameter>clist</parameter> :</term>
1195
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to check.
1196
</simpara></listitem></varlistentry>
1197
<varlistentry><term><parameter>column</parameter> :</term>
1198
<listitem><simpara>The column to check.
1199
</simpara></listitem></varlistentry>
1200
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>The required width in pixels for the column.
1203
</simpara></listitem></varlistentry>
1204
</variablelist></refsect2>
1206
<title><anchor id="gtk-clist-set-column-width" role="function" condition="deprecated:"/>gtk_clist_set_column_width ()</title>
1207
<indexterm role="deprecated"><primary>gtk_clist_set_column_width</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_column_width (<link linkend="GtkCList">GtkCList</link> *clist,
1208
<link linkend="gint">gint</link> column,
1209
<link linkend="gint">gint</link> width);</programlisting>
1210
<warning><para><literal>gtk_clist_set_column_width</literal> is deprecated and should not be used in newly-written code.</para></warning>
1212
Causes the column specified for the <link linkend="GtkCList"><type>GtkCList</type></link> to be set to
1214
</para><variablelist role="params">
1215
<varlistentry><term><parameter>clist</parameter> :</term>
1216
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1217
</simpara></listitem></varlistentry>
1218
<varlistentry><term><parameter>column</parameter> :</term>
1219
<listitem><simpara>The column to set the width.
1220
</simpara></listitem></varlistentry>
1221
<varlistentry><term><parameter>width</parameter> :</term>
1222
<listitem><simpara>The width, in pixels.
1225
</simpara></listitem></varlistentry>
1226
</variablelist></refsect2>
1228
<title><anchor id="gtk-clist-set-column-min-width" role="function" condition="deprecated:"/>gtk_clist_set_column_min_width ()</title>
1229
<indexterm role="deprecated"><primary>gtk_clist_set_column_min_width</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_column_min_width (<link linkend="GtkCList">GtkCList</link> *clist,
1230
<link linkend="gint">gint</link> column,
1231
<link linkend="gint">gint</link> min_width);</programlisting>
1232
<warning><para><literal>gtk_clist_set_column_min_width</literal> is deprecated and should not be used in newly-written code.</para></warning>
1234
Causes the column specified to have a minimum width, preventing
1235
the user from resizing it smaller than that specified.
1236
</para><variablelist role="params">
1237
<varlistentry><term><parameter>clist</parameter> :</term>
1238
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1239
</simpara></listitem></varlistentry>
1240
<varlistentry><term><parameter>column</parameter> :</term>
1241
<listitem><simpara>The column to set the minimum width.
1242
</simpara></listitem></varlistentry>
1243
<varlistentry><term><parameter>min_width</parameter> :</term>
1244
<listitem><simpara>The width, in pixels.
1247
</simpara></listitem></varlistentry>
1248
</variablelist></refsect2>
1250
<title><anchor id="gtk-clist-set-column-max-width" role="function" condition="deprecated:"/>gtk_clist_set_column_max_width ()</title>
1251
<indexterm role="deprecated"><primary>gtk_clist_set_column_max_width</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_column_max_width (<link linkend="GtkCList">GtkCList</link> *clist,
1252
<link linkend="gint">gint</link> column,
1253
<link linkend="gint">gint</link> max_width);</programlisting>
1254
<warning><para><literal>gtk_clist_set_column_max_width</literal> is deprecated and should not be used in newly-written code.</para></warning>
1256
Causes the column specified to have a maximum width, preventing
1257
the user from resizing it larger than that specified.
1258
</para><variablelist role="params">
1259
<varlistentry><term><parameter>clist</parameter> :</term>
1260
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1261
</simpara></listitem></varlistentry>
1262
<varlistentry><term><parameter>column</parameter> :</term>
1263
<listitem><simpara>The column to set the maximum width.
1264
</simpara></listitem></varlistentry>
1265
<varlistentry><term><parameter>max_width</parameter> :</term>
1266
<listitem><simpara>The width, in pixels.
1269
</simpara></listitem></varlistentry>
1270
</variablelist></refsect2>
1272
<title><anchor id="gtk-clist-set-row-height" role="function" condition="deprecated:"/>gtk_clist_set_row_height ()</title>
1273
<indexterm role="deprecated"><primary>gtk_clist_set_row_height</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_row_height (<link linkend="GtkCList">GtkCList</link> *clist,
1274
<link linkend="guint">guint</link> height);</programlisting>
1275
<warning><para><literal>gtk_clist_set_row_height</literal> is deprecated and should not be used in newly-written code.</para></warning>
1277
Causes the <link linkend="GtkCList"><type>GtkCList</type></link> to have a specified height for its
1278
rows. Setting the row height to 0 allows the <link linkend="GtkCList"><type>GtkCList</type></link> to adjust
1279
automatically to data in the row.
1280
</para><variablelist role="params">
1281
<varlistentry><term><parameter>clist</parameter> :</term>
1282
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1283
</simpara></listitem></varlistentry>
1284
<varlistentry><term><parameter>height</parameter> :</term>
1285
<listitem><simpara>The height, in pixels.
1288
</simpara></listitem></varlistentry>
1289
</variablelist></refsect2>
1291
<title><anchor id="gtk-clist-moveto" role="function" condition="deprecated:"/>gtk_clist_moveto ()</title>
1292
<indexterm role="deprecated"><primary>gtk_clist_moveto</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_moveto (<link linkend="GtkCList">GtkCList</link> *clist,
1293
<link linkend="gint">gint</link> row,
1294
<link linkend="gint">gint</link> column,
1295
<link linkend="gfloat">gfloat</link> row_align,
1296
<link linkend="gfloat">gfloat</link> col_align);</programlisting>
1297
<warning><para><literal>gtk_clist_moveto</literal> is deprecated and should not be used in newly-written code.</para></warning>
1299
Tells the CList widget to visually move to the specified
1301
</para><variablelist role="params">
1302
<varlistentry><term><parameter>clist</parameter> :</term>
1303
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1304
</simpara></listitem></varlistentry>
1305
<varlistentry><term><parameter>row</parameter> :</term>
1306
<listitem><simpara>The row to which to move.
1307
</simpara></listitem></varlistentry>
1308
<varlistentry><term><parameter>column</parameter> :</term>
1309
<listitem><simpara>The column to which to move.
1310
</simpara></listitem></varlistentry>
1311
<varlistentry><term><parameter>row_align</parameter> :</term>
1312
<listitem><simpara>A value between 0 and 1 that describes the positioning of
1313
the row in relation to the viewable area of the CList's contents.
1314
</simpara></listitem></varlistentry>
1315
<varlistentry><term><parameter>col_align</parameter> :</term>
1316
<listitem><simpara>A value between 0 and 1 that describes the positioning of
1317
the column in relation to the viewable area of the CList's contents.
1320
</simpara></listitem></varlistentry>
1321
</variablelist></refsect2>
1323
<title><anchor id="gtk-clist-row-is-visible" role="function" condition="deprecated:"/>gtk_clist_row_is_visible ()</title>
1324
<indexterm role="deprecated"><primary>gtk_clist_row_is_visible</primary></indexterm><programlisting><link linkend="GtkVisibility">GtkVisibility</link> gtk_clist_row_is_visible (<link linkend="GtkCList">GtkCList</link> *clist,
1325
<link linkend="gint">gint</link> row);</programlisting>
1326
<warning><para><literal>gtk_clist_row_is_visible</literal> is deprecated and should not be used in newly-written code.</para></warning>
1328
Checks how the specified row is visible.
1329
</para><variablelist role="params">
1330
<varlistentry><term><parameter>clist</parameter> :</term>
1331
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1332
</simpara></listitem></varlistentry>
1333
<varlistentry><term><parameter>row</parameter> :</term>
1334
<listitem><simpara>The row to query.
1335
</simpara></listitem></varlistentry>
1336
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>A <link linkend="GtkVisibility"><type>GtkVisibility</type></link> value that tells you how the row is visible.
1339
</simpara></listitem></varlistentry>
1340
</variablelist></refsect2>
1342
<title><anchor id="gtk-clist-get-cell-type" role="function" condition="deprecated:"/>gtk_clist_get_cell_type ()</title>
1343
<indexterm role="deprecated"><primary>gtk_clist_get_cell_type</primary></indexterm><programlisting><link linkend="GtkCellType">GtkCellType</link> gtk_clist_get_cell_type (<link linkend="GtkCList">GtkCList</link> *clist,
1344
<link linkend="gint">gint</link> row,
1345
<link linkend="gint">gint</link> column);</programlisting>
1346
<warning><para><literal>gtk_clist_get_cell_type</literal> is deprecated and should not be used in newly-written code.</para></warning>
1348
Checks the type of cell at the location specified.
1349
</para><variablelist role="params">
1350
<varlistentry><term><parameter>clist</parameter> :</term>
1351
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1352
</simpara></listitem></varlistentry>
1353
<varlistentry><term><parameter>row</parameter> :</term>
1354
<listitem><simpara>The row of the cell.
1355
</simpara></listitem></varlistentry>
1356
<varlistentry><term><parameter>column</parameter> :</term>
1357
<listitem><simpara>The column of the cell.
1358
</simpara></listitem></varlistentry>
1359
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>A <link linkend="GtkCellType"><type>GtkCellType</type></link> value describing the cell.
1362
</simpara></listitem></varlistentry>
1363
</variablelist></refsect2>
1365
<title><anchor id="gtk-clist-set-text" role="function" condition="deprecated:"/>gtk_clist_set_text ()</title>
1366
<indexterm role="deprecated"><primary>gtk_clist_set_text</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_text (<link linkend="GtkCList">GtkCList</link> *clist,
1367
<link linkend="gint">gint</link> row,
1368
<link linkend="gint">gint</link> column,
1369
const <link linkend="gchar">gchar</link> *text);</programlisting>
1370
<warning><para><literal>gtk_clist_set_text</literal> is deprecated and should not be used in newly-written code.</para></warning>
1372
Sets the displayed text in the specified cell.
1373
</para><variablelist role="params">
1374
<varlistentry><term><parameter>clist</parameter> :</term>
1375
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1376
</simpara></listitem></varlistentry>
1377
<varlistentry><term><parameter>row</parameter> :</term>
1378
<listitem><simpara>The row of the cell.
1379
</simpara></listitem></varlistentry>
1380
<varlistentry><term><parameter>column</parameter> :</term>
1381
<listitem><simpara>The column of the cell.
1382
</simpara></listitem></varlistentry>
1383
<varlistentry><term><parameter>text</parameter> :</term>
1384
<listitem><simpara>The text to set in the cell.
1387
</simpara></listitem></varlistentry>
1388
</variablelist></refsect2>
1390
<title><anchor id="gtk-clist-get-text" role="function" condition="deprecated:"/>gtk_clist_get_text ()</title>
1391
<indexterm role="deprecated"><primary>gtk_clist_get_text</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_clist_get_text (<link linkend="GtkCList">GtkCList</link> *clist,
1392
<link linkend="gint">gint</link> row,
1393
<link linkend="gint">gint</link> column,
1394
<link linkend="gchar">gchar</link> **text);</programlisting>
1395
<warning><para><literal>gtk_clist_get_text</literal> is deprecated and should not be used in newly-written code.</para></warning>
1397
Gets the text for the specified cell.
1398
</para><variablelist role="params">
1399
<varlistentry><term><parameter>clist</parameter> :</term>
1400
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1401
</simpara></listitem></varlistentry>
1402
<varlistentry><term><parameter>row</parameter> :</term>
1403
<listitem><simpara>The row to query.
1404
</simpara></listitem></varlistentry>
1405
<varlistentry><term><parameter>column</parameter> :</term>
1406
<listitem><simpara>The column to query.
1407
</simpara></listitem></varlistentry>
1408
<varlistentry><term><parameter>text</parameter> :</term>
1409
<listitem><simpara>A pointer to a pointer to store the text.
1410
</simpara></listitem></varlistentry>
1411
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>1 if the cell's text could be retrieved, 0 otherwise.
1414
</simpara></listitem></varlistentry>
1415
</variablelist></refsect2>
1417
<title><anchor id="gtk-clist-set-pixmap" role="function" condition="deprecated:"/>gtk_clist_set_pixmap ()</title>
1418
<indexterm role="deprecated"><primary>gtk_clist_set_pixmap</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_pixmap (<link linkend="GtkCList">GtkCList</link> *clist,
1419
<link linkend="gint">gint</link> row,
1420
<link linkend="gint">gint</link> column,
1421
<link linkend="GdkPixmap">GdkPixmap</link> *pixmap,
1422
<link linkend="GdkBitmap">GdkBitmap</link> *mask);</programlisting>
1423
<warning><para><literal>gtk_clist_set_pixmap</literal> is deprecated and should not be used in newly-written code.</para></warning>
1425
Sets a pixmap for the specified cell.
1426
</para><variablelist role="params">
1427
<varlistentry><term><parameter>clist</parameter> :</term>
1428
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1429
</simpara></listitem></varlistentry>
1430
<varlistentry><term><parameter>row</parameter> :</term>
1431
<listitem><simpara>The row of the cell.
1432
</simpara></listitem></varlistentry>
1433
<varlistentry><term><parameter>column</parameter> :</term>
1434
<listitem><simpara>The column of the cell.
1435
</simpara></listitem></varlistentry>
1436
<varlistentry><term><parameter>pixmap</parameter> :</term>
1437
<listitem><simpara>A pointer to a <link linkend="GdkPixmap"><type>GdkPixmap</type></link> to place in the cell.
1438
</simpara></listitem></varlistentry>
1439
<varlistentry><term><parameter>mask</parameter> :</term>
1440
<listitem><simpara>A pointer to a <link linkend="GdkBitmap"><type>GdkBitmap</type></link> mask for the cell.
1443
</simpara></listitem></varlistentry>
1444
</variablelist></refsect2>
1446
<title><anchor id="gtk-clist-get-pixmap" role="function" condition="deprecated:"/>gtk_clist_get_pixmap ()</title>
1447
<indexterm role="deprecated"><primary>gtk_clist_get_pixmap</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_clist_get_pixmap (<link linkend="GtkCList">GtkCList</link> *clist,
1448
<link linkend="gint">gint</link> row,
1449
<link linkend="gint">gint</link> column,
1450
<link linkend="GdkPixmap">GdkPixmap</link> **pixmap,
1451
<link linkend="GdkBitmap">GdkBitmap</link> **mask);</programlisting>
1452
<warning><para><literal>gtk_clist_get_pixmap</literal> is deprecated and should not be used in newly-written code.</para></warning>
1454
Gets the pixmap and bitmap mask of the specified cell. The returned mask value can be NULL.
1455
</para><variablelist role="params">
1456
<varlistentry><term><parameter>clist</parameter> :</term>
1457
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1458
</simpara></listitem></varlistentry>
1459
<varlistentry><term><parameter>row</parameter> :</term>
1460
<listitem><simpara>The row of the cell.
1461
</simpara></listitem></varlistentry>
1462
<varlistentry><term><parameter>column</parameter> :</term>
1463
<listitem><simpara>The column of the cell.
1464
</simpara></listitem></varlistentry>
1465
<varlistentry><term><parameter>pixmap</parameter> :</term>
1466
<listitem><simpara>A pointer to a pointer to store the cell's <link linkend="GdkPixmap"><type>GdkPixmap</type></link>.
1467
</simpara></listitem></varlistentry>
1468
<varlistentry><term><parameter>mask</parameter> :</term>
1469
<listitem><simpara>A pointer to a pointer to store the cell's <link linkend="GdkBitmap"><type>GdkBitmap</type></link> mask.
1470
</simpara></listitem></varlistentry>
1471
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>1 if the cell's pixmap could be retrieved, 0 otherwise.
1474
</simpara></listitem></varlistentry>
1475
</variablelist></refsect2>
1477
<title><anchor id="gtk-clist-set-pixtext" role="function" condition="deprecated:"/>gtk_clist_set_pixtext ()</title>
1478
<indexterm role="deprecated"><primary>gtk_clist_set_pixtext</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_pixtext (<link linkend="GtkCList">GtkCList</link> *clist,
1479
<link linkend="gint">gint</link> row,
1480
<link linkend="gint">gint</link> column,
1481
const <link linkend="gchar">gchar</link> *text,
1482
<link linkend="guint8">guint8</link> spacing,
1483
<link linkend="GdkPixmap">GdkPixmap</link> *pixmap,
1484
<link linkend="GdkBitmap">GdkBitmap</link> *mask);</programlisting>
1485
<warning><para><literal>gtk_clist_set_pixtext</literal> is deprecated and should not be used in newly-written code.</para></warning>
1487
Sets text and a pixmap/bitmap on the specified cell.
1488
</para><variablelist role="params">
1489
<varlistentry><term><parameter>clist</parameter> :</term>
1490
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1491
</simpara></listitem></varlistentry>
1492
<varlistentry><term><parameter>row</parameter> :</term>
1493
<listitem><simpara>The row of the cell.
1494
</simpara></listitem></varlistentry>
1495
<varlistentry><term><parameter>column</parameter> :</term>
1496
<listitem><simpara>The column of the cell.
1497
</simpara></listitem></varlistentry>
1498
<varlistentry><term><parameter>text</parameter> :</term>
1499
<listitem><simpara>The text to set in the cell.
1500
</simpara></listitem></varlistentry>
1501
<varlistentry><term><parameter>spacing</parameter> :</term>
1502
<listitem><simpara>The spacing between the cell's text and pixmap.
1503
</simpara></listitem></varlistentry>
1504
<varlistentry><term><parameter>pixmap</parameter> :</term>
1505
<listitem><simpara>A pointer to a <link linkend="GdkPixmap"><type>GdkPixmap</type></link> for the cell.
1506
</simpara></listitem></varlistentry>
1507
<varlistentry><term><parameter>mask</parameter> :</term>
1508
<listitem><simpara>A pointer to a <link linkend="GdkBitmap"><type>GdkBitmap</type></link> mask for the cell.
1511
</simpara></listitem></varlistentry>
1512
</variablelist></refsect2>
1514
<title><anchor id="gtk-clist-get-pixtext" role="function" condition="deprecated:"/>gtk_clist_get_pixtext ()</title>
1515
<indexterm role="deprecated"><primary>gtk_clist_get_pixtext</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_clist_get_pixtext (<link linkend="GtkCList">GtkCList</link> *clist,
1516
<link linkend="gint">gint</link> row,
1517
<link linkend="gint">gint</link> column,
1518
<link linkend="gchar">gchar</link> **text,
1519
<link linkend="guint8">guint8</link> *spacing,
1520
<link linkend="GdkPixmap">GdkPixmap</link> **pixmap,
1521
<link linkend="GdkBitmap">GdkBitmap</link> **mask);</programlisting>
1522
<warning><para><literal>gtk_clist_get_pixtext</literal> is deprecated and should not be used in newly-written code.</para></warning>
1524
Gets the text, pixmap and bitmap mask for the specified cell.
1525
</para><variablelist role="params">
1526
<varlistentry><term><parameter>clist</parameter> :</term>
1527
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1528
</simpara></listitem></varlistentry>
1529
<varlistentry><term><parameter>row</parameter> :</term>
1530
<listitem><simpara>The row to query.
1531
</simpara></listitem></varlistentry>
1532
<varlistentry><term><parameter>column</parameter> :</term>
1533
<listitem><simpara>The column to query.
1534
</simpara></listitem></varlistentry>
1535
<varlistentry><term><parameter>text</parameter> :</term>
1536
<listitem><simpara>A pointer to a pointer to store the text.
1537
</simpara></listitem></varlistentry>
1538
<varlistentry><term><parameter>spacing</parameter> :</term>
1539
<listitem><simpara>A pointer to a <link linkend="guint8"><type>guint8</type></link> to store the spacing.
1540
</simpara></listitem></varlistentry>
1541
<varlistentry><term><parameter>pixmap</parameter> :</term>
1542
<listitem><simpara>A pointer to a <link linkend="GdkPixmap"><type>GdkPixmap</type></link> pointer to store the cell's pixmap.
1543
</simpara></listitem></varlistentry>
1544
<varlistentry><term><parameter>mask</parameter> :</term>
1545
<listitem><simpara>A pointer to a <link linkend="GdkBitmap"><type>GdkBitmap</type></link> pointer to store the cell's bitmap mask.
1546
</simpara></listitem></varlistentry>
1547
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>1 if the retrieval was successful, 0 otherwise.
1550
</simpara></listitem></varlistentry>
1551
</variablelist></refsect2>
1553
<title><anchor id="gtk-clist-set-foreground" role="function" condition="deprecated:"/>gtk_clist_set_foreground ()</title>
1554
<indexterm role="deprecated"><primary>gtk_clist_set_foreground</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_foreground (<link linkend="GtkCList">GtkCList</link> *clist,
1555
<link linkend="gint">gint</link> row,
1556
const <link linkend="GdkColor">GdkColor</link> *color);</programlisting>
1557
<warning><para><literal>gtk_clist_set_foreground</literal> is deprecated and should not be used in newly-written code.</para></warning>
1559
Sets the foreground color for the specified row.
1560
</para><variablelist role="params">
1561
<varlistentry><term><parameter>clist</parameter> :</term>
1562
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1563
</simpara></listitem></varlistentry>
1564
<varlistentry><term><parameter>row</parameter> :</term>
1565
<listitem><simpara>The row to affect.
1566
</simpara></listitem></varlistentry>
1567
<varlistentry><term><parameter>color</parameter> :</term>
1568
<listitem><simpara>A pointer to a <link linkend="GdkColor"><type>GdkColor</type></link> structure.
1571
</simpara></listitem></varlistentry>
1572
</variablelist></refsect2>
1574
<title><anchor id="gtk-clist-set-background" role="function" condition="deprecated:"/>gtk_clist_set_background ()</title>
1575
<indexterm role="deprecated"><primary>gtk_clist_set_background</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_background (<link linkend="GtkCList">GtkCList</link> *clist,
1576
<link linkend="gint">gint</link> row,
1577
const <link linkend="GdkColor">GdkColor</link> *color);</programlisting>
1578
<warning><para><literal>gtk_clist_set_background</literal> is deprecated and should not be used in newly-written code.</para></warning>
1580
Sets the background color for the specified row.
1581
</para><variablelist role="params">
1582
<varlistentry><term><parameter>clist</parameter> :</term>
1583
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1584
</simpara></listitem></varlistentry>
1585
<varlistentry><term><parameter>row</parameter> :</term>
1586
<listitem><simpara>The row to affect.
1587
</simpara></listitem></varlistentry>
1588
<varlistentry><term><parameter>color</parameter> :</term>
1589
<listitem><simpara>A pointer to a <link linkend="GdkColor"><type>GdkColor</type></link> structure.
1592
</simpara></listitem></varlistentry>
1593
</variablelist></refsect2>
1595
<title><anchor id="gtk-clist-set-cell-style" role="function" condition="deprecated:"/>gtk_clist_set_cell_style ()</title>
1596
<indexterm role="deprecated"><primary>gtk_clist_set_cell_style</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_cell_style (<link linkend="GtkCList">GtkCList</link> *clist,
1597
<link linkend="gint">gint</link> row,
1598
<link linkend="gint">gint</link> column,
1599
<link linkend="GtkStyle">GtkStyle</link> *style);</programlisting>
1600
<warning><para><literal>gtk_clist_set_cell_style</literal> is deprecated and should not be used in newly-written code.</para></warning>
1602
Sets the style for the specified cell.
1603
</para><variablelist role="params">
1604
<varlistentry><term><parameter>clist</parameter> :</term>
1605
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1606
</simpara></listitem></varlistentry>
1607
<varlistentry><term><parameter>row</parameter> :</term>
1608
<listitem><simpara>The row of the cell.
1609
</simpara></listitem></varlistentry>
1610
<varlistentry><term><parameter>column</parameter> :</term>
1611
<listitem><simpara>The column of the cell.
1612
</simpara></listitem></varlistentry>
1613
<varlistentry><term><parameter>style</parameter> :</term>
1614
<listitem><simpara>A pointer to a <link linkend="GtkStyle"><type>GtkStyle</type></link> structure.
1617
</simpara></listitem></varlistentry>
1618
</variablelist></refsect2>
1620
<title><anchor id="gtk-clist-get-cell-style" role="function" condition="deprecated:"/>gtk_clist_get_cell_style ()</title>
1621
<indexterm role="deprecated"><primary>gtk_clist_get_cell_style</primary></indexterm><programlisting><link linkend="GtkStyle">GtkStyle</link>* gtk_clist_get_cell_style (<link linkend="GtkCList">GtkCList</link> *clist,
1622
<link linkend="gint">gint</link> row,
1623
<link linkend="gint">gint</link> column);</programlisting>
1624
<warning><para><literal>gtk_clist_get_cell_style</literal> is deprecated and should not be used in newly-written code.</para></warning>
1626
Gets the current style of the specified cell.
1627
</para><variablelist role="params">
1628
<varlistentry><term><parameter>clist</parameter> :</term>
1629
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1630
</simpara></listitem></varlistentry>
1631
<varlistentry><term><parameter>row</parameter> :</term>
1632
<listitem><simpara>The row of the cell.
1633
</simpara></listitem></varlistentry>
1634
<varlistentry><term><parameter>column</parameter> :</term>
1635
<listitem><simpara>The column of the cell.
1636
</simpara></listitem></varlistentry>
1637
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>A <link linkend="GtkStyle"><type>GtkStyle</type></link> object.
1640
</simpara></listitem></varlistentry>
1641
</variablelist></refsect2>
1643
<title><anchor id="gtk-clist-set-row-style" role="function" condition="deprecated:"/>gtk_clist_set_row_style ()</title>
1644
<indexterm role="deprecated"><primary>gtk_clist_set_row_style</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_row_style (<link linkend="GtkCList">GtkCList</link> *clist,
1645
<link linkend="gint">gint</link> row,
1646
<link linkend="GtkStyle">GtkStyle</link> *style);</programlisting>
1647
<warning><para><literal>gtk_clist_set_row_style</literal> is deprecated and should not be used in newly-written code.</para></warning>
1649
Sets the style for all cells in the specified row.
1650
</para><variablelist role="params">
1651
<varlistentry><term><parameter>clist</parameter> :</term>
1652
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1653
</simpara></listitem></varlistentry>
1654
<varlistentry><term><parameter>row</parameter> :</term>
1655
<listitem><simpara>The row to affect.
1656
</simpara></listitem></varlistentry>
1657
<varlistentry><term><parameter>style</parameter> :</term>
1658
<listitem><simpara>A pointer to a <link linkend="GtkStyle"><type>GtkStyle</type></link> to set.
1661
</simpara></listitem></varlistentry>
1662
</variablelist></refsect2>
1664
<title><anchor id="gtk-clist-get-row-style" role="function" condition="deprecated:"/>gtk_clist_get_row_style ()</title>
1665
<indexterm role="deprecated"><primary>gtk_clist_get_row_style</primary></indexterm><programlisting><link linkend="GtkStyle">GtkStyle</link>* gtk_clist_get_row_style (<link linkend="GtkCList">GtkCList</link> *clist,
1666
<link linkend="gint">gint</link> row);</programlisting>
1667
<warning><para><literal>gtk_clist_get_row_style</literal> is deprecated and should not be used in newly-written code.</para></warning>
1669
Gets the style set for the specified row.
1670
</para><variablelist role="params">
1671
<varlistentry><term><parameter>clist</parameter> :</term>
1672
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1673
</simpara></listitem></varlistentry>
1674
<varlistentry><term><parameter>row</parameter> :</term>
1675
<listitem><simpara>The row to query.
1676
</simpara></listitem></varlistentry>
1677
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>The <link linkend="GtkStyle"><type>GtkStyle</type></link> of the row.
1680
</simpara></listitem></varlistentry>
1681
</variablelist></refsect2>
1683
<title><anchor id="gtk-clist-set-shift" role="function" condition="deprecated:"/>gtk_clist_set_shift ()</title>
1684
<indexterm role="deprecated"><primary>gtk_clist_set_shift</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_shift (<link linkend="GtkCList">GtkCList</link> *clist,
1685
<link linkend="gint">gint</link> row,
1686
<link linkend="gint">gint</link> column,
1687
<link linkend="gint">gint</link> vertical,
1688
<link linkend="gint">gint</link> horizontal);</programlisting>
1689
<warning><para><literal>gtk_clist_set_shift</literal> is deprecated and should not be used in newly-written code.</para></warning>
1691
Sets the vertical and horizontal shift of the specified cell.
1692
</para><variablelist role="params">
1693
<varlistentry><term><parameter>clist</parameter> :</term>
1694
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1695
</simpara></listitem></varlistentry>
1696
<varlistentry><term><parameter>row</parameter> :</term>
1697
<listitem><simpara>The row of the cell.
1698
</simpara></listitem></varlistentry>
1699
<varlistentry><term><parameter>column</parameter> :</term>
1700
<listitem><simpara>The column of the cell.
1701
</simpara></listitem></varlistentry>
1702
<varlistentry><term><parameter>vertical</parameter> :</term>
1703
<listitem><simpara>The value to set for the vertical shift.
1704
</simpara></listitem></varlistentry>
1705
<varlistentry><term><parameter>horizontal</parameter> :</term>
1706
<listitem><simpara>The value to set for the vertical shift.
1709
</simpara></listitem></varlistentry>
1710
</variablelist></refsect2>
1712
<title><anchor id="gtk-clist-set-selectable" role="function" condition="deprecated:"/>gtk_clist_set_selectable ()</title>
1713
<indexterm role="deprecated"><primary>gtk_clist_set_selectable</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_selectable (<link linkend="GtkCList">GtkCList</link> *clist,
1714
<link linkend="gint">gint</link> row,
1715
<link linkend="gboolean">gboolean</link> selectable);</programlisting>
1716
<warning><para><literal>gtk_clist_set_selectable</literal> is deprecated and should not be used in newly-written code.</para></warning>
1718
Sets whether the specified row is selectable or not.
1719
</para><variablelist role="params">
1720
<varlistentry><term><parameter>clist</parameter> :</term>
1721
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1722
</simpara></listitem></varlistentry>
1723
<varlistentry><term><parameter>row</parameter> :</term>
1724
<listitem><simpara>The row to affect.
1725
</simpara></listitem></varlistentry>
1726
<varlistentry><term><parameter>selectable</parameter> :</term>
1727
<listitem><simpara><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
1730
</simpara></listitem></varlistentry>
1731
</variablelist></refsect2>
1733
<title><anchor id="gtk-clist-get-selectable" role="function" condition="deprecated:"/>gtk_clist_get_selectable ()</title>
1734
<indexterm role="deprecated"><primary>gtk_clist_get_selectable</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gtk_clist_get_selectable (<link linkend="GtkCList">GtkCList</link> *clist,
1735
<link linkend="gint">gint</link> row);</programlisting>
1736
<warning><para><literal>gtk_clist_get_selectable</literal> is deprecated and should not be used in newly-written code.</para></warning>
1738
Gets whether the specified row is selectable or not.
1739
</para><variablelist role="params">
1740
<varlistentry><term><parameter>clist</parameter> :</term>
1741
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1742
</simpara></listitem></varlistentry>
1743
<varlistentry><term><parameter>row</parameter> :</term>
1744
<listitem><simpara>The row to query.
1745
</simpara></listitem></varlistentry>
1746
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>A <link linkend="gboolean"><type>gboolean</type></link> value.
1749
</simpara></listitem></varlistentry>
1750
</variablelist></refsect2>
1752
<title><anchor id="gtk-clist-prepend" role="function" condition="deprecated:"/>gtk_clist_prepend ()</title>
1753
<indexterm role="deprecated"><primary>gtk_clist_prepend</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_clist_prepend (<link linkend="GtkCList">GtkCList</link> *clist,
1754
<link linkend="gchar">gchar</link> *text[]);</programlisting>
1755
<warning><para><literal>gtk_clist_prepend</literal> is deprecated and should not be used in newly-written code.</para></warning>
1757
Adds a row to the CList at the top.
1758
</para><variablelist role="params">
1759
<varlistentry><term><parameter>clist</parameter> :</term>
1760
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1761
</simpara></listitem></varlistentry>
1762
<varlistentry><term><parameter>text</parameter> :</term>
1763
<listitem><simpara>An array of strings to add.
1764
</simpara></listitem></varlistentry>
1765
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>The number of the row added.
1768
</simpara></listitem></varlistentry>
1769
</variablelist></refsect2>
1771
<title><anchor id="gtk-clist-append" role="function" condition="deprecated:"/>gtk_clist_append ()</title>
1772
<indexterm role="deprecated"><primary>gtk_clist_append</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_clist_append (<link linkend="GtkCList">GtkCList</link> *clist,
1773
<link linkend="gchar">gchar</link> *text[]);</programlisting>
1774
<warning><para><literal>gtk_clist_append</literal> is deprecated and should not be used in newly-written code.</para></warning>
1776
Adds a row to the CList at the bottom.
1777
</para><variablelist role="params">
1778
<varlistentry><term><parameter>clist</parameter> :</term>
1779
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1780
</simpara></listitem></varlistentry>
1781
<varlistentry><term><parameter>text</parameter> :</term>
1782
<listitem><simpara>An array of strings to add.
1783
</simpara></listitem></varlistentry>
1784
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>The number of the row added.
1787
</simpara></listitem></varlistentry>
1788
</variablelist></refsect2>
1790
<title><anchor id="gtk-clist-insert" role="function" condition="deprecated:"/>gtk_clist_insert ()</title>
1791
<indexterm role="deprecated"><primary>gtk_clist_insert</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_clist_insert (<link linkend="GtkCList">GtkCList</link> *clist,
1792
<link linkend="gint">gint</link> row,
1793
<link linkend="gchar">gchar</link> *text[]);</programlisting>
1794
<warning><para><literal>gtk_clist_insert</literal> is deprecated and should not be used in newly-written code.</para></warning>
1796
Adds a row of text to the CList at the specified position.
1797
</para><variablelist role="params">
1798
<varlistentry><term><parameter>clist</parameter> :</term>
1799
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1800
</simpara></listitem></varlistentry>
1801
<varlistentry><term><parameter>row</parameter> :</term>
1802
<listitem><simpara>The row where the text should be inserted.
1803
</simpara></listitem></varlistentry>
1804
<varlistentry><term><parameter>text</parameter> :</term>
1805
<listitem><simpara>An array of string to add.
1806
</simpara></listitem></varlistentry>
1807
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>The number of the row added.
1810
</simpara></listitem></varlistentry>
1811
</variablelist></refsect2>
1813
<title><anchor id="gtk-clist-remove" role="function" condition="deprecated:"/>gtk_clist_remove ()</title>
1814
<indexterm role="deprecated"><primary>gtk_clist_remove</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_remove (<link linkend="GtkCList">GtkCList</link> *clist,
1815
<link linkend="gint">gint</link> row);</programlisting>
1816
<warning><para><literal>gtk_clist_remove</literal> is deprecated and should not be used in newly-written code.</para></warning>
1818
Removes the specified row from the CList.
1819
</para><variablelist role="params">
1820
<varlistentry><term><parameter>clist</parameter> :</term>
1821
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1822
</simpara></listitem></varlistentry>
1823
<varlistentry><term><parameter>row</parameter> :</term>
1824
<listitem><simpara>The row to remove.
1827
</simpara></listitem></varlistentry>
1828
</variablelist></refsect2>
1830
<title><anchor id="gtk-clist-set-row-data" role="function" condition="deprecated:"/>gtk_clist_set_row_data ()</title>
1831
<indexterm role="deprecated"><primary>gtk_clist_set_row_data</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_row_data (<link linkend="GtkCList">GtkCList</link> *clist,
1832
<link linkend="gint">gint</link> row,
1833
<link linkend="gpointer">gpointer</link> data);</programlisting>
1834
<warning><para><literal>gtk_clist_set_row_data</literal> is deprecated and should not be used in newly-written code.</para></warning>
1836
Sets data for the specified row. This is the same as calling gtk_clist_set_row_data_full(clist, row, data, NULL).
1837
</para><variablelist role="params">
1838
<varlistentry><term><parameter>clist</parameter> :</term>
1839
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1840
</simpara></listitem></varlistentry>
1841
<varlistentry><term><parameter>row</parameter> :</term>
1842
<listitem><simpara>The row to affect.
1843
</simpara></listitem></varlistentry>
1844
<varlistentry><term><parameter>data</parameter> :</term>
1845
<listitem><simpara>The data to set for the row.
1848
</simpara></listitem></varlistentry>
1849
</variablelist></refsect2>
1851
<title><anchor id="gtk-clist-set-row-data-full" role="function" condition="deprecated:"/>gtk_clist_set_row_data_full ()</title>
1852
<indexterm role="deprecated"><primary>gtk_clist_set_row_data_full</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_row_data_full (<link linkend="GtkCList">GtkCList</link> *clist,
1853
<link linkend="gint">gint</link> row,
1854
<link linkend="gpointer">gpointer</link> data,
1855
<link linkend="GtkDestroyNotify">GtkDestroyNotify</link> destroy);</programlisting>
1856
<warning><para><literal>gtk_clist_set_row_data_full</literal> is deprecated and should not be used in newly-written code.</para></warning>
1858
Sets the data for specified row, with a callback when the row is destroyed.
1859
</para><variablelist role="params">
1860
<varlistentry><term><parameter>clist</parameter> :</term>
1861
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1862
</simpara></listitem></varlistentry>
1863
<varlistentry><term><parameter>row</parameter> :</term>
1864
<listitem><simpara>The row to affect.
1865
</simpara></listitem></varlistentry>
1866
<varlistentry><term><parameter>data</parameter> :</term>
1867
<listitem><simpara>The data to set for the row.
1868
</simpara></listitem></varlistentry>
1869
<varlistentry><term><parameter>destroy</parameter> :</term>
1870
<listitem><simpara>A <link linkend="GtkDestroyNotify"><type>GtkDestroyNotify</type></link> function to be called when the row is destroyed.
1873
</simpara></listitem></varlistentry>
1874
</variablelist></refsect2>
1876
<title><anchor id="gtk-clist-get-row-data" role="function" condition="deprecated:"/>gtk_clist_get_row_data ()</title>
1877
<indexterm role="deprecated"><primary>gtk_clist_get_row_data</primary></indexterm><programlisting><link linkend="gpointer">gpointer</link> gtk_clist_get_row_data (<link linkend="GtkCList">GtkCList</link> *clist,
1878
<link linkend="gint">gint</link> row);</programlisting>
1879
<warning><para><literal>gtk_clist_get_row_data</literal> is deprecated and should not be used in newly-written code.</para></warning>
1881
Gets the currently set data for the specified row.
1882
</para><variablelist role="params">
1883
<varlistentry><term><parameter>clist</parameter> :</term>
1884
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1885
</simpara></listitem></varlistentry>
1886
<varlistentry><term><parameter>row</parameter> :</term>
1887
<listitem><simpara>The row to query.
1888
</simpara></listitem></varlistentry>
1889
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>The data set for the row.
1892
</simpara></listitem></varlistentry>
1893
</variablelist></refsect2>
1895
<title><anchor id="gtk-clist-find-row-from-data" role="function" condition="deprecated:"/>gtk_clist_find_row_from_data ()</title>
1896
<indexterm role="deprecated"><primary>gtk_clist_find_row_from_data</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_clist_find_row_from_data (<link linkend="GtkCList">GtkCList</link> *clist,
1897
<link linkend="gpointer">gpointer</link> data);</programlisting>
1898
<warning><para><literal>gtk_clist_find_row_from_data</literal> is deprecated and should not be used in newly-written code.</para></warning>
1900
Searches the CList for the row with the specified data.
1901
</para><variablelist role="params">
1902
<varlistentry><term><parameter>clist</parameter> :</term>
1903
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to search.
1904
</simpara></listitem></varlistentry>
1905
<varlistentry><term><parameter>data</parameter> :</term>
1906
<listitem><simpara>The data to search for a match.
1907
</simpara></listitem></varlistentry>
1908
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>The number of the matching row, or -1 if no match could be found.
1911
</simpara></listitem></varlistentry>
1912
</variablelist></refsect2>
1914
<title><anchor id="gtk-clist-select-row" role="function" condition="deprecated:"/>gtk_clist_select_row ()</title>
1915
<indexterm role="deprecated"><primary>gtk_clist_select_row</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_select_row (<link linkend="GtkCList">GtkCList</link> *clist,
1916
<link linkend="gint">gint</link> row,
1917
<link linkend="gint">gint</link> column);</programlisting>
1918
<warning><para><literal>gtk_clist_select_row</literal> is deprecated and should not be used in newly-written code.</para></warning>
1920
Selects the specified row. Causes the "select-row" signal to be emitted for the specified row and column.
1921
</para><variablelist role="params">
1922
<varlistentry><term><parameter>clist</parameter> :</term>
1923
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1924
</simpara></listitem></varlistentry>
1925
<varlistentry><term><parameter>row</parameter> :</term>
1926
<listitem><simpara>The row to select.
1927
</simpara></listitem></varlistentry>
1928
<varlistentry><term><parameter>column</parameter> :</term>
1929
<listitem><simpara>The column to select.
1932
</simpara></listitem></varlistentry>
1933
</variablelist></refsect2>
1935
<title><anchor id="gtk-clist-unselect-row" role="function" condition="deprecated:"/>gtk_clist_unselect_row ()</title>
1936
<indexterm role="deprecated"><primary>gtk_clist_unselect_row</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_unselect_row (<link linkend="GtkCList">GtkCList</link> *clist,
1937
<link linkend="gint">gint</link> row,
1938
<link linkend="gint">gint</link> column);</programlisting>
1939
<warning><para><literal>gtk_clist_unselect_row</literal> is deprecated and should not be used in newly-written code.</para></warning>
1941
Unselects the specified row. Causes the "unselect-row" signal to be emitted for the specified row and column.
1942
</para><variablelist role="params">
1943
<varlistentry><term><parameter>clist</parameter> :</term>
1944
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1945
</simpara></listitem></varlistentry>
1946
<varlistentry><term><parameter>row</parameter> :</term>
1947
<listitem><simpara>The row to select.
1948
</simpara></listitem></varlistentry>
1949
<varlistentry><term><parameter>column</parameter> :</term>
1950
<listitem><simpara>The column to select.
1953
</simpara></listitem></varlistentry>
1954
</variablelist></refsect2>
1956
<title><anchor id="gtk-clist-undo-selection" role="function" condition="deprecated:"/>gtk_clist_undo_selection ()</title>
1957
<indexterm role="deprecated"><primary>gtk_clist_undo_selection</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_undo_selection (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
1958
<warning><para><literal>gtk_clist_undo_selection</literal> is deprecated and should not be used in newly-written code.</para></warning>
1960
Undoes the last selection for an "extended selection mode" CList.
1961
</para><variablelist role="params">
1962
<varlistentry><term><parameter>clist</parameter> :</term>
1963
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1966
</simpara></listitem></varlistentry>
1967
</variablelist></refsect2>
1969
<title><anchor id="gtk-clist-clear" role="function" condition="deprecated:"/>gtk_clist_clear ()</title>
1970
<indexterm role="deprecated"><primary>gtk_clist_clear</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_clear (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
1971
<warning><para><literal>gtk_clist_clear</literal> is deprecated and should not be used in newly-written code.</para></warning>
1973
Removes all the CList's rows.
1974
</para><variablelist role="params">
1975
<varlistentry><term><parameter>clist</parameter> :</term>
1976
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1979
</simpara></listitem></varlistentry>
1980
</variablelist></refsect2>
1982
<title><anchor id="gtk-clist-get-selection-info" role="function" condition="deprecated:"/>gtk_clist_get_selection_info ()</title>
1983
<indexterm role="deprecated"><primary>gtk_clist_get_selection_info</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_clist_get_selection_info (<link linkend="GtkCList">GtkCList</link> *clist,
1984
<link linkend="gint">gint</link> x,
1985
<link linkend="gint">gint</link> y,
1986
<link linkend="gint">gint</link> *row,
1987
<link linkend="gint">gint</link> *column);</programlisting>
1988
<warning><para><literal>gtk_clist_get_selection_info</literal> is deprecated and should not be used in newly-written code.</para></warning>
1990
Gets the row and column at the specified pixel position in the CList.
1991
</para><variablelist role="params">
1992
<varlistentry><term><parameter>clist</parameter> :</term>
1993
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
1994
</simpara></listitem></varlistentry>
1995
<varlistentry><term><parameter>x</parameter> :</term>
1996
<listitem><simpara>The horizontal pixel position to check.
1997
</simpara></listitem></varlistentry>
1998
<varlistentry><term><parameter>y</parameter> :</term>
1999
<listitem><simpara>The vertical pixel position to check..
2000
</simpara></listitem></varlistentry>
2001
<varlistentry><term><parameter>row</parameter> :</term>
2002
<listitem><simpara>Pointer to a <link linkend="gint"><type>gint</type></link> to store the row value.
2003
</simpara></listitem></varlistentry>
2004
<varlistentry><term><parameter>column</parameter> :</term>
2005
<listitem><simpara>Pointer to a <link linkend="gint"><type>gint</type></link> to store the column value.
2006
</simpara></listitem></varlistentry>
2007
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>1 if row/column is returned and in range, 0 otherwise.
2010
</simpara></listitem></varlistentry>
2011
</variablelist></refsect2>
2013
<title><anchor id="gtk-clist-select-all" role="function" condition="deprecated:"/>gtk_clist_select_all ()</title>
2014
<indexterm role="deprecated"><primary>gtk_clist_select_all</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_select_all (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
2015
<warning><para><literal>gtk_clist_select_all</literal> is deprecated and should not be used in newly-written code.</para></warning>
2017
Selects all rows in the CList. This function has no affect for a
2018
CList in "single" or "browse" selection mode.
2019
</para><variablelist role="params">
2020
<varlistentry><term><parameter>clist</parameter> :</term>
2021
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2024
</simpara></listitem></varlistentry>
2025
</variablelist></refsect2>
2027
<title><anchor id="gtk-clist-unselect-all" role="function" condition="deprecated:"/>gtk_clist_unselect_all ()</title>
2028
<indexterm role="deprecated"><primary>gtk_clist_unselect_all</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_unselect_all (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
2029
<warning><para><literal>gtk_clist_unselect_all</literal> is deprecated and should not be used in newly-written code.</para></warning>
2031
Unselects all rows in the CList.
2032
</para><variablelist role="params">
2033
<varlistentry><term><parameter>clist</parameter> :</term>
2034
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2037
</simpara></listitem></varlistentry>
2038
</variablelist></refsect2>
2040
<title><anchor id="gtk-clist-swap-rows" role="function" condition="deprecated:"/>gtk_clist_swap_rows ()</title>
2041
<indexterm role="deprecated"><primary>gtk_clist_swap_rows</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_swap_rows (<link linkend="GtkCList">GtkCList</link> *clist,
2042
<link linkend="gint">gint</link> row1,
2043
<link linkend="gint">gint</link> row2);</programlisting>
2044
<warning><para><literal>gtk_clist_swap_rows</literal> is deprecated and should not be used in newly-written code.</para></warning>
2046
Swaps the two specified rows with each other.
2047
</para><variablelist role="params">
2048
<varlistentry><term><parameter>clist</parameter> :</term>
2049
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2050
</simpara></listitem></varlistentry>
2051
<varlistentry><term><parameter>row1</parameter> :</term>
2052
<listitem><simpara>Number of the first row.
2053
</simpara></listitem></varlistentry>
2054
<varlistentry><term><parameter>row2</parameter> :</term>
2055
<listitem><simpara>Number of the second row.
2058
</simpara></listitem></varlistentry>
2059
</variablelist></refsect2>
2061
<title><anchor id="gtk-clist-set-compare-func" role="function" condition="deprecated:"/>gtk_clist_set_compare_func ()</title>
2062
<indexterm role="deprecated"><primary>gtk_clist_set_compare_func</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_compare_func (<link linkend="GtkCList">GtkCList</link> *clist,
2063
<link linkend="GtkCListCompareFunc">GtkCListCompareFunc</link> cmp_func);</programlisting>
2064
<warning><para><literal>gtk_clist_set_compare_func</literal> is deprecated and should not be used in newly-written code.</para></warning>
2066
Sets the compare function of the <link linkend="GtkClist"><type>GtkClist</type></link> to <parameter>cmp_func</parameter>. If <parameter>cmp_func</parameter> is NULL,
2067
then the default compare function is used. The default compare function sorts
2068
ascending or with the type set by <link linkend="gtk-clist-set-sort-type"><function>gtk_clist_set_sort_type()</function></link> by the column set
2069
by <link linkend="gtk-clist-set-sort-column"><function>gtk_clist_set_sort_column()</function></link>.
2070
</para><variablelist role="params">
2071
<varlistentry><term><parameter>clist</parameter> :</term>
2072
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2073
</simpara></listitem></varlistentry>
2074
<varlistentry><term><parameter>cmp_func</parameter> :</term>
2075
<listitem><simpara>The <link linkend="GtkCompareFunction"><type>GtkCompareFunction</type></link> to use.
2078
</simpara></listitem></varlistentry>
2079
</variablelist></refsect2>
2081
<title><anchor id="gtk-clist-set-sort-column" role="function" condition="deprecated:"/>gtk_clist_set_sort_column ()</title>
2082
<indexterm role="deprecated"><primary>gtk_clist_set_sort_column</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_sort_column (<link linkend="GtkCList">GtkCList</link> *clist,
2083
<link linkend="gint">gint</link> column);</programlisting>
2084
<warning><para><literal>gtk_clist_set_sort_column</literal> is deprecated and should not be used in newly-written code.</para></warning>
2086
Sets the sort column of the clist. The sort column is used by the
2087
default compare function to determine which column to sort by.
2088
</para><variablelist role="params">
2089
<varlistentry><term><parameter>clist</parameter> :</term>
2090
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2091
</simpara></listitem></varlistentry>
2092
<varlistentry><term><parameter>column</parameter> :</term>
2093
<listitem><simpara>The column to sort by
2096
</simpara></listitem></varlistentry>
2097
</variablelist></refsect2>
2099
<title><anchor id="gtk-clist-set-sort-type" role="function" condition="deprecated:"/>gtk_clist_set_sort_type ()</title>
2100
<indexterm role="deprecated"><primary>gtk_clist_set_sort_type</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_sort_type (<link linkend="GtkCList">GtkCList</link> *clist,
2101
<link linkend="GtkSortType">GtkSortType</link> sort_type);</programlisting>
2102
<warning><para><literal>gtk_clist_set_sort_type</literal> is deprecated and should not be used in newly-written code.</para></warning>
2104
Sets the sort type of the <link linkend="GtkClist"><type>GtkClist</type></link>. This is either GTK_SORT_ASCENDING for
2105
ascening sort or GTK_SORT_DESCENDING for descending sort.
2106
</para><variablelist role="params">
2107
<varlistentry><term><parameter>clist</parameter> :</term>
2108
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2109
</simpara></listitem></varlistentry>
2110
<varlistentry><term><parameter>sort_type</parameter> :</term>
2111
<listitem><simpara>the <link linkend="GtkSortType"><type>GtkSortType</type></link> to use
2114
</simpara></listitem></varlistentry>
2115
</variablelist></refsect2>
2117
<title><anchor id="gtk-clist-sort" role="function" condition="deprecated:"/>gtk_clist_sort ()</title>
2118
<indexterm role="deprecated"><primary>gtk_clist_sort</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_sort (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
2119
<warning><para><literal>gtk_clist_sort</literal> is deprecated and should not be used in newly-written code.</para></warning>
2121
Sorts the <link linkend="GtkClist"><type>GtkClist</type></link> according to the current compare function, which
2122
can be set with the <link linkend="gtk-clist-set-compare-func"><function>gtk_clist_set_compare_func()</function></link> function.
2123
</para><variablelist role="params">
2124
<varlistentry><term><parameter>clist</parameter> :</term>
2125
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to sort.
2128
</simpara></listitem></varlistentry>
2129
</variablelist></refsect2>
2131
<title><anchor id="gtk-clist-set-auto-sort" role="function" condition="deprecated:"/>gtk_clist_set_auto_sort ()</title>
2132
<indexterm role="deprecated"><primary>gtk_clist_set_auto_sort</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_auto_sort (<link linkend="GtkCList">GtkCList</link> *clist,
2133
<link linkend="gboolean">gboolean</link> auto_sort);</programlisting>
2134
<warning><para><literal>gtk_clist_set_auto_sort</literal> is deprecated and should not be used in newly-written code.</para></warning>
2136
Turns on or off auto sort of the <link linkend="GtkCList"><type>GtkCList</type></link>. If auto sort is on, then the CList will be resorted when a row is inserted into the CList.
2137
</para><variablelist role="params">
2138
<varlistentry><term><parameter>clist</parameter> :</term>
2139
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2140
</simpara></listitem></varlistentry>
2141
<varlistentry><term><parameter>auto_sort</parameter> :</term>
2142
<listitem><simpara>whether auto sort should be on or off
2145
</simpara></listitem></varlistentry>
2146
</variablelist></refsect2>
2148
<title><anchor id="gtk-clist-columns-autosize" role="function" condition="deprecated:"/>gtk_clist_columns_autosize ()</title>
2149
<indexterm role="deprecated"><primary>gtk_clist_columns_autosize</primary></indexterm><programlisting><link linkend="gint">gint</link> gtk_clist_columns_autosize (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
2150
<warning><para><literal>gtk_clist_columns_autosize</literal> is deprecated and should not be used in newly-written code.</para></warning>
2152
Auto-sizes all columns in the CList and returns the total width of the CList.
2153
</para><variablelist role="params">
2154
<varlistentry><term><parameter>clist</parameter> :</term>
2155
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2156
</simpara></listitem></varlistentry>
2157
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>The total width of the CList.
2160
</simpara></listitem></varlistentry>
2161
</variablelist></refsect2>
2163
<title><anchor id="gtk-clist-get-column-title" role="function" condition="deprecated:"/>gtk_clist_get_column_title ()</title>
2164
<indexterm role="deprecated"><primary>gtk_clist_get_column_title</primary></indexterm><programlisting><link linkend="gchar">gchar</link>* gtk_clist_get_column_title (<link linkend="GtkCList">GtkCList</link> *clist,
2165
<link linkend="gint">gint</link> column);</programlisting>
2166
<warning><para><literal>gtk_clist_get_column_title</literal> is deprecated and should not be used in newly-written code.</para></warning>
2168
Gets the current title of the specified column
2169
</para><variablelist role="params">
2170
<varlistentry><term><parameter>clist</parameter> :</term>
2171
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2172
</simpara></listitem></varlistentry>
2173
<varlistentry><term><parameter>column</parameter> :</term>
2174
<listitem><simpara>The column to query.
2175
</simpara></listitem></varlistentry>
2176
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>The title of the column.
2179
</simpara></listitem></varlistentry>
2180
</variablelist></refsect2>
2182
<title><anchor id="gtk-clist-get-column-widget" role="function" condition="deprecated:"/>gtk_clist_get_column_widget ()</title>
2183
<indexterm role="deprecated"><primary>gtk_clist_get_column_widget</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gtk_clist_get_column_widget (<link linkend="GtkCList">GtkCList</link> *clist,
2184
<link linkend="gint">gint</link> column);</programlisting>
2185
<warning><para><literal>gtk_clist_get_column_widget</literal> is deprecated and should not be used in newly-written code.</para></warning>
2187
Gets the widget in the column header for the specified column.
2188
</para><variablelist role="params">
2189
<varlistentry><term><parameter>clist</parameter> :</term>
2190
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2191
</simpara></listitem></varlistentry>
2192
<varlistentry><term><parameter>column</parameter> :</term>
2193
<listitem><simpara>The column to query.
2194
</simpara></listitem></varlistentry>
2195
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>Pointer to a <link linkend="GtkWidget"><type>GtkWidget</type></link> for the column header.
2198
</simpara></listitem></varlistentry>
2199
</variablelist></refsect2>
2201
<title><anchor id="gtk-clist-get-hadjustment" role="function" condition="deprecated:"/>gtk_clist_get_hadjustment ()</title>
2202
<indexterm role="deprecated"><primary>gtk_clist_get_hadjustment</primary></indexterm><programlisting><link linkend="GtkAdjustment">GtkAdjustment</link>* gtk_clist_get_hadjustment (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
2203
<warning><para><literal>gtk_clist_get_hadjustment</literal> is deprecated and should not be used in newly-written code.</para></warning>
2205
Gets the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> currently being used for the horizontal
2207
</para><variablelist role="params">
2208
<varlistentry><term><parameter>clist</parameter> :</term>
2209
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to check.
2210
</simpara></listitem></varlistentry>
2211
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>A <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> object, or NULL if none is currently
2215
</simpara></listitem></varlistentry>
2216
</variablelist></refsect2>
2218
<title><anchor id="gtk-clist-get-vadjustment" role="function" condition="deprecated:"/>gtk_clist_get_vadjustment ()</title>
2219
<indexterm role="deprecated"><primary>gtk_clist_get_vadjustment</primary></indexterm><programlisting><link linkend="GtkAdjustment">GtkAdjustment</link>* gtk_clist_get_vadjustment (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
2220
<warning><para><literal>gtk_clist_get_vadjustment</literal> is deprecated and should not be used in newly-written code.</para></warning>
2222
Gets the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> currently being used for the vertical
2224
</para><variablelist role="params">
2225
<varlistentry><term><parameter>clist</parameter> :</term>
2226
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to check.
2227
</simpara></listitem></varlistentry>
2228
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>A <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> object, or NULL if none is currently
2232
</simpara></listitem></varlistentry>
2233
</variablelist></refsect2>
2235
<title><anchor id="gtk-clist-row-move" role="function" condition="deprecated:"/>gtk_clist_row_move ()</title>
2236
<indexterm role="deprecated"><primary>gtk_clist_row_move</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_row_move (<link linkend="GtkCList">GtkCList</link> *clist,
2237
<link linkend="gint">gint</link> source_row,
2238
<link linkend="gint">gint</link> dest_row);</programlisting>
2239
<warning><para><literal>gtk_clist_row_move</literal> is deprecated and should not be used in newly-written code.</para></warning>
2241
Allows you to move a row from one position to another in the
2243
</para><variablelist role="params">
2244
<varlistentry><term><parameter>clist</parameter> :</term>
2245
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2246
</simpara></listitem></varlistentry>
2247
<varlistentry><term><parameter>source_row</parameter> :</term>
2248
<listitem><simpara>The original position of the row to move.
2249
</simpara></listitem></varlistentry>
2250
<varlistentry><term><parameter>dest_row</parameter> :</term>
2251
<listitem><simpara>The position to which the row should be moved.
2254
</simpara></listitem></varlistentry>
2255
</variablelist></refsect2>
2257
<title><anchor id="gtk-clist-set-button-actions" role="function" condition="deprecated:"/>gtk_clist_set_button_actions ()</title>
2258
<indexterm role="deprecated"><primary>gtk_clist_set_button_actions</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_button_actions (<link linkend="GtkCList">GtkCList</link> *clist,
2259
<link linkend="guint">guint</link> button,
2260
<link linkend="guint8">guint8</link> button_actions);</programlisting>
2261
<warning><para><literal>gtk_clist_set_button_actions</literal> is deprecated and should not be used in newly-written code.</para></warning>
2263
Sets the action(s) that the specified mouse button will have
2265
</para><variablelist role="params">
2266
<varlistentry><term><parameter>clist</parameter> :</term>
2267
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2268
</simpara></listitem></varlistentry>
2269
<varlistentry><term><parameter>button</parameter> :</term>
2270
<listitem><simpara>The mouse button to set. The values here, unlike in the
2271
rest of GTK+ start from 0. For instance, the right mouse
2272
button, which is 3 elsewhere, should be given as 2 here.
2273
</simpara></listitem></varlistentry>
2274
<varlistentry><term><parameter>button_actions</parameter> :</term>
2275
<listitem><simpara>A logically OR'd value of <link linkend="GtkButtonAction"><type>GtkButtonAction</type></link> values
2279
</simpara></listitem></varlistentry>
2280
</variablelist></refsect2>
2282
<title><anchor id="gtk-clist-set-hadjustment" role="function" condition="deprecated:"/>gtk_clist_set_hadjustment ()</title>
2283
<indexterm role="deprecated"><primary>gtk_clist_set_hadjustment</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_hadjustment (<link linkend="GtkCList">GtkCList</link> *clist,
2284
<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);</programlisting>
2285
<warning><para><literal>gtk_clist_set_hadjustment</literal> is deprecated and should not be used in newly-written code.</para></warning>
2287
Allows you to set the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> to be used for the horizontal
2288
aspect of the <link linkend="GtkCList"><type>GtkCList</type></link> widget.
2289
</para><variablelist role="params">
2290
<varlistentry><term><parameter>clist</parameter> :</term>
2291
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2292
</simpara></listitem></varlistentry>
2293
<varlistentry><term><parameter>adjustment</parameter> :</term>
2294
<listitem><simpara>A pointer to a <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> widget, or NULL.
2297
</simpara></listitem></varlistentry>
2298
</variablelist></refsect2>
2300
<title><anchor id="gtk-clist-set-reorderable" role="function" condition="deprecated:"/>gtk_clist_set_reorderable ()</title>
2301
<indexterm role="deprecated"><primary>gtk_clist_set_reorderable</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_reorderable (<link linkend="GtkCList">GtkCList</link> *clist,
2302
<link linkend="gboolean">gboolean</link> reorderable);</programlisting>
2303
<warning><para><literal>gtk_clist_set_reorderable</literal> is deprecated and should not be used in newly-written code.</para></warning>
2305
Sets whether the CList's rows are re-orderable using drag-and-drop.
2306
</para><variablelist role="params">
2307
<varlistentry><term><parameter>clist</parameter> :</term>
2308
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2309
</simpara></listitem></varlistentry>
2310
<varlistentry><term><parameter>reorderable</parameter> :</term>
2311
<listitem><simpara><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
2314
</simpara></listitem></varlistentry>
2315
</variablelist></refsect2>
2317
<title><anchor id="gtk-clist-set-use-drag-icons" role="function" condition="deprecated:"/>gtk_clist_set_use_drag_icons ()</title>
2318
<indexterm role="deprecated"><primary>gtk_clist_set_use_drag_icons</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_use_drag_icons (<link linkend="GtkCList">GtkCList</link> *clist,
2319
<link linkend="gboolean">gboolean</link> use_icons);</programlisting>
2320
<warning><para><literal>gtk_clist_set_use_drag_icons</literal> is deprecated and should not be used in newly-written code.</para></warning>
2322
Determines whether the <link linkend="GtkClist"><type>GtkClist</type></link> should use icons when
2323
doing drag-and-drop operations.
2324
</para><variablelist role="params">
2325
<varlistentry><term><parameter>clist</parameter> :</term>
2326
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2327
</simpara></listitem></varlistentry>
2328
<varlistentry><term><parameter>use_icons</parameter> :</term>
2329
<listitem><simpara><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
2332
</simpara></listitem></varlistentry>
2333
</variablelist></refsect2>
2335
<title><anchor id="gtk-clist-set-vadjustment" role="function" condition="deprecated:"/>gtk_clist_set_vadjustment ()</title>
2336
<indexterm role="deprecated"><primary>gtk_clist_set_vadjustment</primary></indexterm><programlisting><link linkend="void">void</link> gtk_clist_set_vadjustment (<link linkend="GtkCList">GtkCList</link> *clist,
2337
<link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);</programlisting>
2338
<warning><para><literal>gtk_clist_set_vadjustment</literal> is deprecated and should not be used in newly-written code.</para></warning>
2340
Allows you to set the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> to be used for the vertical
2341
aspect of the <link linkend="GtkCList"><type>GtkCList</type></link> widget.
2342
</para><variablelist role="params">
2343
<varlistentry><term><parameter>clist</parameter> :</term>
2344
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
2345
</simpara></listitem></varlistentry>
2346
<varlistentry><term><parameter>adjustment</parameter> :</term>
2347
<listitem><simpara>A pointer to a <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> widget, or NULL.
2350
</simpara></listitem></varlistentry>
2351
</variablelist></refsect2>
2354
<refsect1 role="property_details">
2355
<title role="property_details.title">Property Details</title>
2356
<refsect2><title><anchor id="GtkCList--n-columns"/>The "<literal>n-columns</literal>" property</title>
2357
<indexterm><primary>GtkCList:n-columns</primary></indexterm><programlisting> "n-columns" <link linkend="guint">guint</link> : Read / Write / Construct Only</programlisting>
2359
An integer value for a column.
2360
</para><para>Default value: 0</para>
2362
<refsect2><title><anchor id="GtkCList--reorderable"/>The "<literal>reorderable</literal>" property</title>
2363
<indexterm><primary>GtkCList:reorderable</primary></indexterm><programlisting> "reorderable" <link linkend="gboolean">gboolean</link> : Read / Write</programlisting>
2365
A boolean value for determining if the user can re-order the CList's
2367
</para><para>Default value: FALSE</para>
2369
<refsect2><title><anchor id="GtkCList--row-height"/>The "<literal>row-height</literal>" property</title>
2370
<indexterm><primary>GtkCList:row-height</primary></indexterm><programlisting> "row-height" <link linkend="guint">guint</link> : Read / Write</programlisting>
2372
An integer value representing the height of a row in pixels.
2373
</para><para>Default value: 0</para>
2375
<refsect2><title><anchor id="GtkCList--selection-mode"/>The "<literal>selection-mode</literal>" property</title>
2376
<indexterm><primary>GtkCList:selection-mode</primary></indexterm><programlisting> "selection-mode" <link linkend="GtkSelectionMode">GtkSelectionMode</link> : Read / Write</programlisting>
2378
Sets the type of selection mode for the CList.
2379
</para><para>Default value: GTK_SELECTION_NONE</para>
2381
<refsect2><title><anchor id="GtkCList--shadow-type"/>The "<literal>shadow-type</literal>" property</title>
2382
<indexterm><primary>GtkCList:shadow-type</primary></indexterm><programlisting> "shadow-type" <link linkend="GtkShadowType">GtkShadowType</link> : Read / Write</programlisting>
2384
Sets the shadowing for the CList.
2385
</para><para>Default value: GTK_SHADOW_NONE</para>
2387
<refsect2><title><anchor id="GtkCList--sort-type"/>The "<literal>sort-type</literal>" property</title>
2388
<indexterm><primary>GtkCList:sort-type</primary></indexterm><programlisting> "sort-type" <link linkend="GtkSortType">GtkSortType</link> : Read / Write</programlisting>
2389
<para></para><para>Default value: GTK_SORT_ASCENDING</para>
2391
<refsect2><title><anchor id="GtkCList--titles-active"/>The "<literal>titles-active</literal>" property</title>
2392
<indexterm><primary>GtkCList:titles-active</primary></indexterm><programlisting> "titles-active" <link linkend="gboolean">gboolean</link> : Read / Write</programlisting>
2394
A boolean value for setting whether the column titles can be
2396
</para><para>Default value: FALSE</para>
2398
<refsect2><title><anchor id="GtkCList--use-drag-icons"/>The "<literal>use-drag-icons</literal>" property</title>
2399
<indexterm><primary>GtkCList:use-drag-icons</primary></indexterm><programlisting> "use-drag-icons" <link linkend="gboolean">gboolean</link> : Read / Write</programlisting>
2401
A boolean value for setting whether to use icons during drag
2403
</para><para>Default value: FALSE</para>
2408
<refsect1 role="signals">
2409
<title role="signals.title">Signal Details</title>
2410
<refsect2><title><anchor id="GtkCList-abort-column-resize"/>The "abort-column-resize" signal</title>
2411
<indexterm><primary>GtkCList::abort-column-resize</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2412
<link linkend="gpointer">gpointer</link> user_data) : Run Last / Action</programlisting>
2414
This signal is emitted when a column resize is aborted.
2415
</para><variablelist role="params">
2416
<varlistentry><term><parameter>clist</parameter> :</term>
2417
<listitem><simpara>the object which received the signal.
2419
</simpara></listitem></varlistentry>
2420
<varlistentry><term><parameter>user_data</parameter> :</term>
2421
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2422
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-click-column"/>The "click-column" signal</title>
2423
<indexterm><primary>GtkCList::click-column</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2424
<link linkend="gint">gint</link> column,
2425
<link linkend="gpointer">gpointer</link> user_data) : Run First</programlisting>
2427
This signal is emitted when a column title is clicked.
2428
</para><variablelist role="params">
2429
<varlistentry><term><parameter>clist</parameter> :</term>
2430
<listitem><simpara>The object which received the signal.
2431
</simpara></listitem></varlistentry>
2432
<varlistentry><term><parameter>column</parameter> :</term>
2433
<listitem><simpara>The number of the column.
2435
</simpara></listitem></varlistentry>
2436
<varlistentry><term><parameter>user_data</parameter> :</term>
2437
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2438
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-end-selection"/>The "end-selection" signal</title>
2439
<indexterm><primary>GtkCList::end-selection</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2440
<link linkend="gpointer">gpointer</link> user_data) : Run Last / Action</programlisting>
2442
This signal is emitted when a selection ends in a
2443
multiple selection CList.
2444
</para><variablelist role="params">
2445
<varlistentry><term><parameter>clist</parameter> :</term>
2446
<listitem><simpara>the object which received the signal.
2448
</simpara></listitem></varlistentry>
2449
<varlistentry><term><parameter>user_data</parameter> :</term>
2450
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2451
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-extend-selection"/>The "extend-selection" signal</title>
2452
<indexterm><primary>GtkCList::extend-selection</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2453
<link linkend="GtkScrollType">GtkScrollType</link> scroll_type,
2454
<link linkend="gfloat">gfloat</link> position,
2455
<link linkend="gboolean">gboolean</link> auto_start_selection,
2456
<link linkend="gpointer">gpointer</link> user_data) : Run Last / Action</programlisting>
2458
This signal is emitted when the selection is extended.
2459
</para><variablelist role="params">
2460
<varlistentry><term><parameter>clist</parameter> :</term>
2461
<listitem><simpara>the object which received the signal.
2462
</simpara></listitem></varlistentry>
2463
<varlistentry><term><parameter>scroll_type</parameter> :</term>
2464
<listitem><simpara>A <link linkend="GtkScrollType"><type>GtkScrollType</type></link> value of any scrolling operation the
2465
occured during the selection.
2466
</simpara></listitem></varlistentry>
2467
<varlistentry><term><parameter>position</parameter> :</term>
2468
<listitem><simpara>A value between 0.0 and 1.0.
2469
</simpara></listitem></varlistentry>
2470
<varlistentry><term><parameter>auto_start_selection</parameter> :</term>
2471
<listitem><simpara><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
2473
</simpara></listitem></varlistentry>
2474
<varlistentry><term><parameter>user_data</parameter> :</term>
2475
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2476
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-resize-column"/>The "resize-column" signal</title>
2477
<indexterm><primary>GtkCList::resize-column</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2478
<link linkend="gint">gint</link> column,
2479
<link linkend="gint">gint</link> width,
2480
<link linkend="gpointer">gpointer</link> user_data) : Run Last</programlisting>
2482
This signal is emitted when a column is resized.
2483
</para><variablelist role="params">
2484
<varlistentry><term><parameter>clist</parameter> :</term>
2485
<listitem><simpara>The object which received the signal.
2486
</simpara></listitem></varlistentry>
2487
<varlistentry><term><parameter>column</parameter> :</term>
2488
<listitem><simpara>The number of the column
2489
</simpara></listitem></varlistentry>
2490
<varlistentry><term><parameter>width</parameter> :</term>
2491
<listitem><simpara>The new width of the column.
2493
</simpara></listitem></varlistentry>
2494
<varlistentry><term><parameter>user_data</parameter> :</term>
2495
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2496
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-row-move"/>The "row-move" signal</title>
2497
<indexterm><primary>GtkCList::row-move</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2498
<link linkend="gint">gint</link> arg1,
2499
<link linkend="gint">gint</link> arg2,
2500
<link linkend="gpointer">gpointer</link> user_data) : Run Last</programlisting>
2502
This signal is emitted when a row is moved.
2503
</para><variablelist role="params">
2504
<varlistentry><term><parameter>clist</parameter> :</term>
2505
<listitem><simpara>The object which received the signal.
2506
</simpara></listitem></varlistentry>
2507
<varlistentry><term><parameter>arg1</parameter> :</term>
2508
<listitem><simpara>The source position of the row.
2509
</simpara></listitem></varlistentry>
2510
<varlistentry><term><parameter>arg2</parameter> :</term>
2511
<listitem><simpara>The destination position of the row.
2513
</simpara></listitem></varlistentry>
2514
<varlistentry><term><parameter>user_data</parameter> :</term>
2515
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2516
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-scroll-horizontal"/>The "scroll-horizontal" signal</title>
2517
<indexterm><primary>GtkCList::scroll-horizontal</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2518
<link linkend="GtkScrollType">GtkScrollType</link> scroll_type,
2519
<link linkend="gfloat">gfloat</link> position,
2520
<link linkend="gpointer">gpointer</link> user_data) : Run Last / Action</programlisting>
2522
This signal is emitted when the CList is scrolled horizontally.
2523
</para><variablelist role="params">
2524
<varlistentry><term><parameter>clist</parameter> :</term>
2525
<listitem><simpara>the object which received the signal.
2526
</simpara></listitem></varlistentry>
2527
<varlistentry><term><parameter>scroll_type</parameter> :</term>
2528
<listitem><simpara>A <link linkend="GtkScrollType"><type>GtkScrollType</type></link> value of how the scroll operation occured.
2529
</simpara></listitem></varlistentry>
2530
<varlistentry><term><parameter>position</parameter> :</term>
2531
<listitem><simpara>a value between 0.0 and 1.0.
2533
</simpara></listitem></varlistentry>
2534
<varlistentry><term><parameter>user_data</parameter> :</term>
2535
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2536
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-scroll-vertical"/>The "scroll-vertical" signal</title>
2537
<indexterm><primary>GtkCList::scroll-vertical</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2538
<link linkend="GtkScrollType">GtkScrollType</link> scroll_type,
2539
<link linkend="gfloat">gfloat</link> position,
2540
<link linkend="gpointer">gpointer</link> user_data) : Run Last / Action</programlisting>
2542
This signal is emitted when the CList is scrolled vertically.
2543
</para><variablelist role="params">
2544
<varlistentry><term><parameter>clist</parameter> :</term>
2545
<listitem><simpara>the object which received the signal.
2546
</simpara></listitem></varlistentry>
2547
<varlistentry><term><parameter>scroll_type</parameter> :</term>
2548
<listitem><simpara>A <link linkend="GtkScrollType"><type>GtkScrollType</type></link> value of how the scroll operation occured.
2549
</simpara></listitem></varlistentry>
2550
<varlistentry><term><parameter>position</parameter> :</term>
2551
<listitem><simpara>A value between 0.0 and 1.0.
2553
</simpara></listitem></varlistentry>
2554
<varlistentry><term><parameter>user_data</parameter> :</term>
2555
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2556
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-select-all"/>The "select-all" signal</title>
2557
<indexterm><primary>GtkCList::select-all</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2558
<link linkend="gpointer">gpointer</link> user_data) : Run Last / Action</programlisting>
2560
This signal is emitted when all the rows are selected in a CList.
2561
</para><variablelist role="params">
2562
<varlistentry><term><parameter>clist</parameter> :</term>
2563
<listitem><simpara>the object which received the signal.
2565
</simpara></listitem></varlistentry>
2566
<varlistentry><term><parameter>user_data</parameter> :</term>
2567
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2568
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-select-row"/>The "select-row" signal</title>
2569
<indexterm><primary>GtkCList::select-row</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2570
<link linkend="gint">gint</link> row,
2571
<link linkend="gint">gint</link> column,
2572
<link linkend="GdkEventButton">GdkEventButton</link> *event,
2573
<link linkend="gpointer">gpointer</link> user_data) : Run First</programlisting>
2575
This signal is emitted when the user selects a row in the list.
2576
It is emitted for every row that is selected in a multi-selection or
2577
by calling <link linkend="gtk-clist-select-all"><function>gtk_clist_select_all()</function></link>.
2578
</para><variablelist role="params">
2579
<varlistentry><term><parameter>clist</parameter> :</term>
2580
<listitem><simpara>The object which received the signal.
2581
</simpara></listitem></varlistentry>
2582
<varlistentry><term><parameter>row</parameter> :</term>
2583
<listitem><simpara>The row selected.
2584
</simpara></listitem></varlistentry>
2585
<varlistentry><term><parameter>column</parameter> :</term>
2586
<listitem><simpara>The column where the selection occured.
2587
</simpara></listitem></varlistentry>
2588
<varlistentry><term><parameter>event</parameter> :</term>
2589
<listitem><simpara>A <link linkend="GdkEvent"><type>GdkEvent</type></link> structure for the selection.
2591
</simpara></listitem></varlistentry>
2592
<varlistentry><term><parameter>user_data</parameter> :</term>
2593
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2594
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-set-scroll-adjustments"/>The "set-scroll-adjustments" signal</title>
2595
<indexterm><primary>GtkCList::set-scroll-adjustments</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2596
<link linkend="GtkAdjustment">GtkAdjustment</link> *arg1,
2597
<link linkend="GtkAdjustment">GtkAdjustment</link> *arg2,
2598
<link linkend="gpointer">gpointer</link> user_data) : Run Last</programlisting>
2601
</para><variablelist role="params">
2602
<varlistentry><term><parameter>clist</parameter> :</term>
2603
<listitem><simpara>the object which received the signal.
2604
</simpara></listitem></varlistentry>
2605
<varlistentry><term><parameter>arg1</parameter> :</term>
2607
</simpara></listitem></varlistentry>
2608
<varlistentry><term><parameter>arg2</parameter> :</term>
2611
</simpara></listitem></varlistentry>
2612
<varlistentry><term><parameter>user_data</parameter> :</term>
2613
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2614
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-start-selection"/>The "start-selection" signal</title>
2615
<indexterm><primary>GtkCList::start-selection</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2616
<link linkend="gpointer">gpointer</link> user_data) : Run Last / Action</programlisting>
2618
This signal is emitted when a drag-selection is started in
2619
a multiple-selection CList.
2620
</para><variablelist role="params">
2621
<varlistentry><term><parameter>clist</parameter> :</term>
2622
<listitem><simpara>the object which received the signal.
2624
</simpara></listitem></varlistentry>
2625
<varlistentry><term><parameter>user_data</parameter> :</term>
2626
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2627
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-toggle-add-mode"/>The "toggle-add-mode" signal</title>
2628
<indexterm><primary>GtkCList::toggle-add-mode</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2629
<link linkend="gpointer">gpointer</link> user_data) : Run Last / Action</programlisting>
2631
This signal is emitted when "add mode" is toggled.
2632
</para><variablelist role="params">
2633
<varlistentry><term><parameter>clist</parameter> :</term>
2634
<listitem><simpara>the object which received the signal.
2636
</simpara></listitem></varlistentry>
2637
<varlistentry><term><parameter>user_data</parameter> :</term>
2638
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2639
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-toggle-focus-row"/>The "toggle-focus-row" signal</title>
2640
<indexterm><primary>GtkCList::toggle-focus-row</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2641
<link linkend="gpointer">gpointer</link> user_data) : Run Last / Action</programlisting>
2644
</para><variablelist role="params">
2645
<varlistentry><term><parameter>clist</parameter> :</term>
2646
<listitem><simpara>The object which received the signal.
2648
</simpara></listitem></varlistentry>
2649
<varlistentry><term><parameter>user_data</parameter> :</term>
2650
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2651
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-undo-selection"/>The "undo-selection" signal</title>
2652
<indexterm><primary>GtkCList::undo-selection</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2653
<link linkend="gpointer">gpointer</link> user_data) : Run Last / Action</programlisting>
2655
This signal is emitted when an undo selection occurs in the CList,
2656
probably via calling <link linkend="gtk-clist-undo-selection"><function>gtk_clist_undo_selection()</function></link>.
2657
</para><variablelist role="params">
2658
<varlistentry><term><parameter>clist</parameter> :</term>
2659
<listitem><simpara>the object which received the signal.
2661
</simpara></listitem></varlistentry>
2662
<varlistentry><term><parameter>user_data</parameter> :</term>
2663
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2664
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-unselect-all"/>The "unselect-all" signal</title>
2665
<indexterm><primary>GtkCList::unselect-all</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2666
<link linkend="gpointer">gpointer</link> user_data) : Run Last / Action</programlisting>
2668
This signal is emitted when all rows are unselected in a CList.
2669
</para><variablelist role="params">
2670
<varlistentry><term><parameter>clist</parameter> :</term>
2671
<listitem><simpara>the object which received the signal.
2673
</simpara></listitem></varlistentry>
2674
<varlistentry><term><parameter>user_data</parameter> :</term>
2675
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2676
</variablelist></refsect2><refsect2><title><anchor id="GtkCList-unselect-row"/>The "unselect-row" signal</title>
2677
<indexterm><primary>GtkCList::unselect-row</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GtkCList">GtkCList</link> *clist,
2678
<link linkend="gint">gint</link> row,
2679
<link linkend="gint">gint</link> column,
2680
<link linkend="GdkEventButton">GdkEventButton</link> *event,
2681
<link linkend="gpointer">gpointer</link> user_data) : Run First</programlisting>
2683
This signal is emitted when the user unselects a row in the list.
2684
It is emitted for every row that is unselected in a multi-selection or
2685
by calling <link linkend="gtk-clist-unselect-all"><function>gtk_clist_unselect_all()</function></link>. It is also emitted for the
2686
previously selected row in a "single" or "browse" mode CList.
2687
</para><variablelist role="params">
2688
<varlistentry><term><parameter>clist</parameter> :</term>
2689
<listitem><simpara>The object which received the signal.
2690
</simpara></listitem></varlistentry>
2691
<varlistentry><term><parameter>row</parameter> :</term>
2692
<listitem><simpara>The selected row
2693
</simpara></listitem></varlistentry>
2694
<varlistentry><term><parameter>column</parameter> :</term>
2695
<listitem><simpara>The column where the selection occured.
2696
</simpara></listitem></varlistentry>
2697
<varlistentry><term><parameter>event</parameter> :</term>
2700
</simpara></listitem></varlistentry>
2701
<varlistentry><term><parameter>user_data</parameter> :</term>
2702
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
2703
</variablelist></refsect2>