<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<!--ENTITY index-Objects-Grouped SYSTEM "objects_grouped.sgml"-->
<refentry id="GtkCList">
<refmeta>
<refentrytitle role="top_of_page" id="GtkCList.top_of_page">GtkCList</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkCList</refname>
<refpurpose>A multi-columned scrolling list widget</refpurpose>
</refnamediv>

<refsynopsisdiv id="GtkCList.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;gtk/gtk.h&gt;

                    <link linkend="GtkCList-struct">GtkCList</link>;
enum                <link linkend="GtkCellType">GtkCellType</link>;
enum                <link linkend="GtkButtonAction">GtkButtonAction</link>;
#define             <link linkend="GTK-CLIST-FLAGS--CAPS">GTK_CLIST_FLAGS</link>                     (clist)
#define             <link linkend="GTK-CLIST-SET-FLAG--CAPS">GTK_CLIST_SET_FLAG</link>                  (clist,flag)
#define             <link linkend="GTK-CLIST-UNSET-FLAG--CAPS">GTK_CLIST_UNSET_FLAG</link>                (clist,flag)
#define             <link linkend="GTK-CLIST-IN-DRAG--CAPS">GTK_CLIST_IN_DRAG</link>                   (clist)
#define             <link linkend="GTK-CLIST-ROW-HEIGHT-SET--CAPS">GTK_CLIST_ROW_HEIGHT_SET</link>            (clist)
#define             <link linkend="GTK-CLIST-SHOW-TITLES--CAPS">GTK_CLIST_SHOW_TITLES</link>               (clist)
#define             <link linkend="GTK-CLIST-ADD-MODE--CAPS">GTK_CLIST_ADD_MODE</link>                  (clist)
#define             <link linkend="GTK-CLIST-AUTO-SORT--CAPS">GTK_CLIST_AUTO_SORT</link>                 (clist)
#define             <link linkend="GTK-CLIST-AUTO-RESIZE-BLOCKED--CAPS">GTK_CLIST_AUTO_RESIZE_BLOCKED</link>       (clist)
#define             <link linkend="GTK-CLIST-REORDERABLE--CAPS">GTK_CLIST_REORDERABLE</link>               (clist)
#define             <link linkend="GTK-CLIST-USE-DRAG-ICONS--CAPS">GTK_CLIST_USE_DRAG_ICONS</link>            (clist)
#define             <link linkend="GTK-CLIST-DRAW-DRAG-LINE--CAPS">GTK_CLIST_DRAW_DRAG_LINE</link>            (clist)
#define             <link linkend="GTK-CLIST-DRAW-DRAG-RECT--CAPS">GTK_CLIST_DRAW_DRAG_RECT</link>            (clist)
#define             <link linkend="GTK-CLIST-ROW--CAPS">GTK_CLIST_ROW</link>                       (_glist_)
#define             <link linkend="GTK-CELL-TEXT--CAPS">GTK_CELL_TEXT</link>                       (cell)
#define             <link linkend="GTK-CELL-PIXMAP--CAPS">GTK_CELL_PIXMAP</link>                     (cell)
#define             <link linkend="GTK-CELL-PIXTEXT--CAPS">GTK_CELL_PIXTEXT</link>                    (cell)
#define             <link linkend="GTK-CELL-WIDGET--CAPS">GTK_CELL_WIDGET</link>                     (cell)
<link linkend="gint">gint</link>                (<link linkend="GtkCListCompareFunc">*GtkCListCompareFunc</link>)              (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gconstpointer">gconstpointer</link> ptr1,
                                                         <link linkend="gconstpointer">gconstpointer</link> ptr2);
                    <link linkend="GtkCListColumn">GtkCListColumn</link>;
                    <link linkend="GtkCListRow">GtkCListRow</link>;
                    <link linkend="GtkCellText">GtkCellText</link>;
                    <link linkend="GtkCellPixmap">GtkCellPixmap</link>;
                    <link linkend="GtkCellPixText">GtkCellPixText</link>;
                    <link linkend="GtkCellWidget">GtkCellWidget</link>;
                    <link linkend="GtkCell">GtkCell</link>;
                    <link linkend="GtkCListCellInfo">GtkCListCellInfo</link>;
                    <link linkend="GtkCListDestInfo">GtkCListDestInfo</link>;
enum                <link linkend="GtkCListDragPos">GtkCListDragPos</link>;
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-clist-new">gtk_clist_new</link>                       (<link linkend="gint">gint</link> columns);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-clist-new-with-titles">gtk_clist_new_with_titles</link>           (<link linkend="gint">gint</link> columns,
                                                         <link linkend="gchar">gchar</link> *titles[]);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-shadow-type">gtk_clist_set_shadow_type</link>           (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="GtkShadowType">GtkShadowType</link> type);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-selection-mode">gtk_clist_set_selection_mode</link>        (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="GtkSelectionMode">GtkSelectionMode</link> mode);
<link linkend="void">void</link>                <link linkend="gtk-clist-freeze">gtk_clist_freeze</link>                    (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="void">void</link>                <link linkend="gtk-clist-thaw">gtk_clist_thaw</link>                      (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="void">void</link>                <link linkend="gtk-clist-column-titles-show">gtk_clist_column_titles_show</link>        (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="void">void</link>                <link linkend="gtk-clist-column-titles-hide">gtk_clist_column_titles_hide</link>        (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="void">void</link>                <link linkend="gtk-clist-column-title-active">gtk_clist_column_title_active</link>       (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column);
<link linkend="void">void</link>                <link linkend="gtk-clist-column-title-passive">gtk_clist_column_title_passive</link>      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column);
<link linkend="void">void</link>                <link linkend="gtk-clist-column-titles-active">gtk_clist_column_titles_active</link>      (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="void">void</link>                <link linkend="gtk-clist-column-titles-passive">gtk_clist_column_titles_passive</link>     (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-column-title">gtk_clist_set_column_title</link>          (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column,
                                                         const <link linkend="gchar">gchar</link> *title);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-column-widget">gtk_clist_set_column_widget</link>         (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-column-justification">gtk_clist_set_column_justification</link>  (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="GtkJustification">GtkJustification</link> justification);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-column-visibility">gtk_clist_set_column_visibility</link>     (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gboolean">gboolean</link> visible);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-column-resizeable">gtk_clist_set_column_resizeable</link>     (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gboolean">gboolean</link> resizeable);
<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,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gboolean">gboolean</link> auto_resize);
<link linkend="gint">gint</link>                <link linkend="gtk-clist-optimal-column-width">gtk_clist_optimal_column_width</link>      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-column-width">gtk_clist_set_column_width</link>          (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gint">gint</link> width);
<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,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gint">gint</link> min_width);
<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,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gint">gint</link> max_width);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-row-height">gtk_clist_set_row_height</link>            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="guint">guint</link> height);
<link linkend="void">void</link>                <link linkend="gtk-clist-moveto">gtk_clist_moveto</link>                    (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gfloat">gfloat</link> row_align,
                                                         <link linkend="gfloat">gfloat</link> col_align);
<link linkend="GtkVisibility">GtkVisibility</link>       <link linkend="gtk-clist-row-is-visible">gtk_clist_row_is_visible</link>            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row);
<link linkend="GtkCellType">GtkCellType</link>         <link linkend="gtk-clist-get-cell-type">gtk_clist_get_cell_type</link>             (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-text">gtk_clist_set_text</link>                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         const <link linkend="gchar">gchar</link> *text);
<link linkend="gint">gint</link>                <link linkend="gtk-clist-get-text">gtk_clist_get_text</link>                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gchar">gchar</link> **text);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-pixmap">gtk_clist_set_pixmap</link>                (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="GdkPixmap">GdkPixmap</link> *pixmap,
                                                         <link linkend="GdkBitmap">GdkBitmap</link> *mask);
<link linkend="gint">gint</link>                <link linkend="gtk-clist-get-pixmap">gtk_clist_get_pixmap</link>                (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="GdkPixmap">GdkPixmap</link> **pixmap,
                                                         <link linkend="GdkBitmap">GdkBitmap</link> **mask);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-pixtext">gtk_clist_set_pixtext</link>               (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         const <link linkend="gchar">gchar</link> *text,
                                                         <link linkend="guint8">guint8</link> spacing,
                                                         <link linkend="GdkPixmap">GdkPixmap</link> *pixmap,
                                                         <link linkend="GdkBitmap">GdkBitmap</link> *mask);
<link linkend="gint">gint</link>                <link linkend="gtk-clist-get-pixtext">gtk_clist_get_pixtext</link>               (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gchar">gchar</link> **text,
                                                         <link linkend="guint8">guint8</link> *spacing,
                                                         <link linkend="GdkPixmap">GdkPixmap</link> **pixmap,
                                                         <link linkend="GdkBitmap">GdkBitmap</link> **mask);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-foreground">gtk_clist_set_foreground</link>            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         const <link linkend="GdkColor">GdkColor</link> *color);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-background">gtk_clist_set_background</link>            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         const <link linkend="GdkColor">GdkColor</link> *color);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-cell-style">gtk_clist_set_cell_style</link>            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="GtkStyle">GtkStyle</link> *style);
<link linkend="GtkStyle">GtkStyle</link> *          <link linkend="gtk-clist-get-cell-style">gtk_clist_get_cell_style</link>            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-row-style">gtk_clist_set_row_style</link>             (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="GtkStyle">GtkStyle</link> *style);
<link linkend="GtkStyle">GtkStyle</link> *          <link linkend="gtk-clist-get-row-style">gtk_clist_get_row_style</link>             (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-shift">gtk_clist_set_shift</link>                 (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gint">gint</link> vertical,
                                                         <link linkend="gint">gint</link> horizontal);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-selectable">gtk_clist_set_selectable</link>            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gboolean">gboolean</link> selectable);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-clist-get-selectable">gtk_clist_get_selectable</link>            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row);
<link linkend="gint">gint</link>                <link linkend="gtk-clist-prepend">gtk_clist_prepend</link>                   (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gchar">gchar</link> *text[]);
<link linkend="gint">gint</link>                <link linkend="gtk-clist-append">gtk_clist_append</link>                    (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gchar">gchar</link> *text[]);
<link linkend="gint">gint</link>                <link linkend="gtk-clist-insert">gtk_clist_insert</link>                    (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gchar">gchar</link> *text[]);
<link linkend="void">void</link>                <link linkend="gtk-clist-remove">gtk_clist_remove</link>                    (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-row-data">gtk_clist_set_row_data</link>              (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gpointer">gpointer</link> data);
<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,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);
<link linkend="gpointer">gpointer</link>            <link linkend="gtk-clist-get-row-data">gtk_clist_get_row_data</link>              (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row);
<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,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="void">void</link>                <link linkend="gtk-clist-select-row">gtk_clist_select_row</link>                (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column);
<link linkend="void">void</link>                <link linkend="gtk-clist-unselect-row">gtk_clist_unselect_row</link>              (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column);
<link linkend="void">void</link>                <link linkend="gtk-clist-undo-selection">gtk_clist_undo_selection</link>            (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="void">void</link>                <link linkend="gtk-clist-clear">gtk_clist_clear</link>                     (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="gint">gint</link>                <link linkend="gtk-clist-get-selection-info">gtk_clist_get_selection_info</link>        (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> x,
                                                         <link linkend="gint">gint</link> y,
                                                         <link linkend="gint">gint</link> *row,
                                                         <link linkend="gint">gint</link> *column);
<link linkend="void">void</link>                <link linkend="gtk-clist-select-all">gtk_clist_select_all</link>                (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="void">void</link>                <link linkend="gtk-clist-unselect-all">gtk_clist_unselect_all</link>              (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="void">void</link>                <link linkend="gtk-clist-swap-rows">gtk_clist_swap_rows</link>                 (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row1,
                                                         <link linkend="gint">gint</link> row2);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-compare-func">gtk_clist_set_compare_func</link>          (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="GtkCListCompareFunc">GtkCListCompareFunc</link> cmp_func);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-sort-column">gtk_clist_set_sort_column</link>           (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-sort-type">gtk_clist_set_sort_type</link>             (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="GtkSortType">GtkSortType</link> sort_type);
<link linkend="void">void</link>                <link linkend="gtk-clist-sort">gtk_clist_sort</link>                      (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-auto-sort">gtk_clist_set_auto_sort</link>             (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gboolean">gboolean</link> auto_sort);
<link linkend="gint">gint</link>                <link linkend="gtk-clist-columns-autosize">gtk_clist_columns_autosize</link>          (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="gchar">gchar</link> *             <link linkend="gtk-clist-get-column-title">gtk_clist_get_column_title</link>          (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-clist-get-column-widget">gtk_clist_get_column_widget</link>         (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column);
<link linkend="GtkAdjustment">GtkAdjustment</link>*      <link linkend="gtk-clist-get-hadjustment">gtk_clist_get_hadjustment</link>           (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="GtkAdjustment">GtkAdjustment</link>*      <link linkend="gtk-clist-get-vadjustment">gtk_clist_get_vadjustment</link>           (<link linkend="GtkCList">GtkCList</link> *clist);
<link linkend="void">void</link>                <link linkend="gtk-clist-row-move">gtk_clist_row_move</link>                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> source_row,
                                                         <link linkend="gint">gint</link> dest_row);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-button-actions">gtk_clist_set_button_actions</link>        (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="guint">guint</link> button,
                                                         <link linkend="guint8">guint8</link> button_actions);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-hadjustment">gtk_clist_set_hadjustment</link>           (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-reorderable">gtk_clist_set_reorderable</link>           (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gboolean">gboolean</link> reorderable);
<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,
                                                         <link linkend="gboolean">gboolean</link> use_icons);
<link linkend="void">void</link>                <link linkend="gtk-clist-set-vadjustment">gtk_clist_set_vadjustment</link>           (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GtkCList.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----<link linkend="GtkWidget">GtkWidget</link>
                     +----<link linkend="GtkContainer">GtkContainer</link>
                           +----GtkCList
                                 +----<link linkend="GtkCTree">GtkCTree</link>
</synopsis>
</refsect1>



<refsect1 id="GtkCList.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkCList implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link> and  <link linkend="GtkBuildable">GtkBuildable</link>.</para>
</refsect1>


<refsect1 id="GtkCList.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkCList--n-columns">n-columns</link>&quot;                <link linkend="guint">guint</link>                 : Read / Write / Construct Only
  &quot;<link linkend="GtkCList--reorderable">reorderable</link>&quot;              <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkCList--row-height">row-height</link>&quot;               <link linkend="guint">guint</link>                 : Read / Write
  &quot;<link linkend="GtkCList--selection-mode">selection-mode</link>&quot;           <link linkend="GtkSelectionMode">GtkSelectionMode</link>      : Read / Write
  &quot;<link linkend="GtkCList--shadow-type">shadow-type</link>&quot;              <link linkend="GtkShadowType">GtkShadowType</link>         : Read / Write
  &quot;<link linkend="GtkCList--sort-type">sort-type</link>&quot;                <link linkend="GtkSortType">GtkSortType</link>           : Read / Write
  &quot;<link linkend="GtkCList--titles-active">titles-active</link>&quot;            <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkCList--use-drag-icons">use-drag-icons</link>&quot;           <link linkend="gboolean">gboolean</link>              : Read / Write
</synopsis>
</refsect1>

<refsect1 id="GtkCList.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="GtkCList-abort-column-resize">abort-column-resize</link>&quot;                            : Run Last / Action
  &quot;<link linkend="GtkCList-click-column">click-column</link>&quot;                                   : Run First
  &quot;<link linkend="GtkCList-end-selection">end-selection</link>&quot;                                  : Run Last / Action
  &quot;<link linkend="GtkCList-extend-selection">extend-selection</link>&quot;                               : Run Last / Action
  &quot;<link linkend="GtkCList-resize-column">resize-column</link>&quot;                                  : Run Last
  &quot;<link linkend="GtkCList-row-move">row-move</link>&quot;                                       : Run Last
  &quot;<link linkend="GtkCList-scroll-horizontal">scroll-horizontal</link>&quot;                              : Run Last / Action
  &quot;<link linkend="GtkCList-scroll-vertical">scroll-vertical</link>&quot;                                : Run Last / Action
  &quot;<link linkend="GtkCList-select-all">select-all</link>&quot;                                     : Run Last / Action
  &quot;<link linkend="GtkCList-select-row">select-row</link>&quot;                                     : Run First
  &quot;<link linkend="GtkCList-set-scroll-adjustments">set-scroll-adjustments</link>&quot;                         : Run Last
  &quot;<link linkend="GtkCList-start-selection">start-selection</link>&quot;                                : Run Last / Action
  &quot;<link linkend="GtkCList-toggle-add-mode">toggle-add-mode</link>&quot;                                : Run Last / Action
  &quot;<link linkend="GtkCList-toggle-focus-row">toggle-focus-row</link>&quot;                               : Run Last / Action
  &quot;<link linkend="GtkCList-undo-selection">undo-selection</link>&quot;                                 : Run Last / Action
  &quot;<link linkend="GtkCList-unselect-all">unselect-all</link>&quot;                                   : Run Last / Action
  &quot;<link linkend="GtkCList-unselect-row">unselect-row</link>&quot;                                   : Run First
</synopsis>
</refsect1>


<refsect1 id="GtkCList.description" role="desc">
<title role="desc.title">Description</title>
<para>
The <link linkend="GtkCList"><type>GtkCList</type></link> widget is a very useful multi-columned scrolling list.
It can display data in nicely aligned vertical columns, with titles
at the top of the list.
</para>
<para>
GtkCList has been deprecated since GTK+ 2.0 and should not be used
in newly written code. Use <link linkend="GtkTreeView"><type>GtkTreeView</type></link> instead.
</para>
</refsect1>

<refsect1 id="GtkCList.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkCList-struct" role="struct">
<title>GtkCList</title>
<indexterm zone="GtkCList-struct" role="deprecated"><primary sortas="CList">GtkCList</primary></indexterm><programlisting>typedef struct _GtkCList GtkCList;</programlisting>
<warning><para><literal>GtkCList</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This is the embodiment of the <link linkend="GtkCList"><type>GtkCList</type></link> widget.  This structure contains
only private data, and should be accessed only via the CList API.
</para></refsect2>
<refsect2 id="GtkCellType" role="enum" condition="deprecated:">
<title>enum GtkCellType</title>
<indexterm zone="GtkCellType" role="deprecated"><primary sortas="CellType">GtkCellType</primary></indexterm><programlisting>typedef enum
{
  GTK_CELL_EMPTY,
  GTK_CELL_TEXT,
  GTK_CELL_PIXMAP,
  GTK_CELL_PIXTEXT,
  GTK_CELL_WIDGET
} GtkCellType;
</programlisting>
<warning><para><literal>GtkCellType</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Identifies the type of element in the current cell of the CList.  Cells can
contain text, pixmaps, or both. Unfortunately support for <link linkend="GTK-CELL-WIDGET--CAPS"><literal>GTK_CELL_WIDGET</literal></link>
was never completed.
</para></refsect2>
<refsect2 id="GtkButtonAction" role="enum" condition="deprecated:">
<title>enum GtkButtonAction</title>
<indexterm zone="GtkButtonAction" role="deprecated"><primary sortas="ButtonAction">GtkButtonAction</primary></indexterm><programlisting>typedef enum
{
  GTK_BUTTON_IGNORED = 0,
  GTK_BUTTON_SELECTS = 1 &lt;&lt; 0,
  GTK_BUTTON_DRAGS   = 1 &lt;&lt; 1,
  GTK_BUTTON_EXPANDS = 1 &lt;&lt; 2
} GtkButtonAction;
</programlisting>
<warning><para><literal>GtkButtonAction</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Values for specifying what mouse button events a CList will
react to.
</para></refsect2>
<refsect2 id="GTK-CLIST-FLAGS--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_FLAGS()</title>
<indexterm zone="GTK-CLIST-FLAGS--CAPS" role="deprecated"><primary sortas="CLIST_FLAGS">GTK_CLIST_FLAGS</primary></indexterm><programlisting>#define GTK_CLIST_FLAGS(clist)             (GTK_CLIST (clist)-&gt;flags)
</programlisting>
<warning><para><literal>GTK_CLIST_FLAGS</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Reads the current flags of the specified CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget from which to get the flags
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-SET-FLAG--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_SET_FLAG()</title>
<indexterm zone="GTK-CLIST-SET-FLAG--CAPS" role="deprecated"><primary sortas="CLIST_SET_FLAG">GTK_CLIST_SET_FLAG</primary></indexterm><programlisting>#define GTK_CLIST_SET_FLAG(clist,flag)     (GTK_CLIST_FLAGS (clist) |= (GTK_ ## flag))
</programlisting>
<warning><para><literal>GTK_CLIST_SET_FLAG</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to set a particular flag for the specified CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flag</parameter>&#160;:</term>
<listitem><simpara>A single <link linkend="GtkCList"><type>GtkCList</type></link> flag to set.  NOTE: Do not add the GTK_ prefix.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-UNSET-FLAG--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_UNSET_FLAG()</title>
<indexterm zone="GTK-CLIST-UNSET-FLAG--CAPS" role="deprecated"><primary sortas="CLIST_UNSET_FLAG">GTK_CLIST_UNSET_FLAG</primary></indexterm><programlisting>#define GTK_CLIST_UNSET_FLAG(clist,flag)   (GTK_CLIST_FLAGS (clist) &amp;= ~(GTK_ ## flag))
</programlisting>
<warning><para><literal>GTK_CLIST_UNSET_FLAG</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to clear a particular flag for the specified CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>flag</parameter>&#160;:</term>
<listitem><simpara>A single <link linkend="GtkCList"><type>GtkCList</type></link> flag to clear.  NOTE: Do not add the GTK_ prefix.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-IN-DRAG--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_IN_DRAG()</title>
<indexterm zone="GTK-CLIST-IN-DRAG--CAPS" role="deprecated"><primary sortas="CLIST_IN_DRAG">GTK_CLIST_IN_DRAG</primary></indexterm><programlisting>#define GTK_CLIST_IN_DRAG(clist)           (GTK_CLIST_FLAGS (clist) &amp; GTK_CLIST_IN_DRAG)
</programlisting>
<warning><para><literal>GTK_CLIST_IN_DRAG</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to check whether the <link linkend="GtkCList"><type>GtkCList</type></link> is in "drag mode."
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to check.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-ROW-HEIGHT-SET--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_ROW_HEIGHT_SET()</title>
<indexterm zone="GTK-CLIST-ROW-HEIGHT-SET--CAPS" role="deprecated"><primary sortas="CLIST_ROW_HEIGHT_SET">GTK_CLIST_ROW_HEIGHT_SET</primary></indexterm><programlisting>#define GTK_CLIST_ROW_HEIGHT_SET(clist)    (GTK_CLIST_FLAGS (clist) &amp; GTK_CLIST_ROW_HEIGHT_SET)
</programlisting>
<warning><para><literal>GTK_CLIST_ROW_HEIGHT_SET</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to check whether the <link linkend="GtkCList"><type>GtkCList</type></link>'s row height is set.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to check.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-SHOW-TITLES--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_SHOW_TITLES()</title>
<indexterm zone="GTK-CLIST-SHOW-TITLES--CAPS" role="deprecated"><primary sortas="CLIST_SHOW_TITLES">GTK_CLIST_SHOW_TITLES</primary></indexterm><programlisting>#define GTK_CLIST_SHOW_TITLES(clist)       (GTK_CLIST_FLAGS (clist) &amp; GTK_CLIST_SHOW_TITLES)
</programlisting>
<warning><para><literal>GTK_CLIST_SHOW_TITLES</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to check whether the flag for showing the
widget's column titles is set.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-ADD-MODE--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_ADD_MODE()</title>
<indexterm zone="GTK-CLIST-ADD-MODE--CAPS" role="deprecated"><primary sortas="CLIST_ADD_MODE">GTK_CLIST_ADD_MODE</primary></indexterm><programlisting>#define GTK_CLIST_ADD_MODE(clist)          (GTK_CLIST_FLAGS (clist) &amp; GTK_CLIST_ADD_MODE)
</programlisting>
<warning><para><literal>GTK_CLIST_ADD_MODE</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to test whether the CList is in "add mode."
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-AUTO-SORT--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_AUTO_SORT()</title>
<indexterm zone="GTK-CLIST-AUTO-SORT--CAPS" role="deprecated"><primary sortas="CLIST_AUTO_SORT">GTK_CLIST_AUTO_SORT</primary></indexterm><programlisting>#define GTK_CLIST_AUTO_SORT(clist)         (GTK_CLIST_FLAGS (clist) &amp; GTK_CLIST_AUTO_SORT)
</programlisting>
<warning><para><literal>GTK_CLIST_AUTO_SORT</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to test whether the CList has automatic sorting
switched on.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-AUTO-RESIZE-BLOCKED--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_AUTO_RESIZE_BLOCKED()</title>
<indexterm zone="GTK-CLIST-AUTO-RESIZE-BLOCKED--CAPS" role="deprecated"><primary sortas="CLIST_AUTO_RESIZE_BLOCKED">GTK_CLIST_AUTO_RESIZE_BLOCKED</primary></indexterm><programlisting>#define GTK_CLIST_AUTO_RESIZE_BLOCKED(clist) (GTK_CLIST_FLAGS (clist) &amp; GTK_CLIST_AUTO_RESIZE_BLOCKED)
</programlisting>
<warning><para><literal>GTK_CLIST_AUTO_RESIZE_BLOCKED</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to check if automatic resizing of columns is blocked.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-REORDERABLE--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_REORDERABLE()</title>
<indexterm zone="GTK-CLIST-REORDERABLE--CAPS" role="deprecated"><primary sortas="CLIST_REORDERABLE">GTK_CLIST_REORDERABLE</primary></indexterm><programlisting>#define GTK_CLIST_REORDERABLE(clist)       (GTK_CLIST_FLAGS (clist) &amp; GTK_CLIST_REORDERABLE)
</programlisting>
<warning><para><literal>GTK_CLIST_REORDERABLE</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to test if the CList's columns are re-orderable
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-USE-DRAG-ICONS--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_USE_DRAG_ICONS()</title>
<indexterm zone="GTK-CLIST-USE-DRAG-ICONS--CAPS" role="deprecated"><primary sortas="CLIST_USE_DRAG_ICONS">GTK_CLIST_USE_DRAG_ICONS</primary></indexterm><programlisting>#define GTK_CLIST_USE_DRAG_ICONS(clist)    (GTK_CLIST_FLAGS (clist) &amp; GTK_CLIST_USE_DRAG_ICONS)
</programlisting>
<warning><para><literal>GTK_CLIST_USE_DRAG_ICONS</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to check if the USE_DRAG_ICONS property is enabled.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-DRAW-DRAG-LINE--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_DRAW_DRAG_LINE()</title>
<indexterm zone="GTK-CLIST-DRAW-DRAG-LINE--CAPS" role="deprecated"><primary sortas="CLIST_DRAW_DRAG_LINE">GTK_CLIST_DRAW_DRAG_LINE</primary></indexterm><programlisting>#define GTK_CLIST_DRAW_DRAG_LINE(clist)    (GTK_CLIST_FLAGS (clist) &amp; GTK_CLIST_DRAW_DRAG_LINE)
</programlisting>
<warning><para><literal>GTK_CLIST_DRAW_DRAG_LINE</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to check if the DRAW_DRAG_LINE property is enabled.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-DRAW-DRAG-RECT--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_DRAW_DRAG_RECT()</title>
<indexterm zone="GTK-CLIST-DRAW-DRAG-RECT--CAPS" role="deprecated"><primary sortas="CLIST_DRAW_DRAG_RECT">GTK_CLIST_DRAW_DRAG_RECT</primary></indexterm><programlisting>#define GTK_CLIST_DRAW_DRAG_RECT(clist)    (GTK_CLIST_FLAGS (clist) &amp; GTK_CLIST_DRAW_DRAG_RECT)
</programlisting>
<warning><para><literal>GTK_CLIST_DRAW_DRAG_RECT</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to check if the DRAW_DRAG_RECT property is enabled.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> widget to check.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CLIST-ROW--CAPS" role="macro" condition="deprecated:">
<title>GTK_CLIST_ROW()</title>
<indexterm zone="GTK-CLIST-ROW--CAPS" role="deprecated"><primary sortas="CLIST_ROW">GTK_CLIST_ROW</primary></indexterm><programlisting>#define GTK_CLIST_ROW(_glist_) ((GtkCListRow *)((_glist_)-&gt;data))
</programlisting>
<warning><para><literal>GTK_CLIST_ROW</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to cast a GList element to a CListRow pointer.
</para><variablelist role="params">
<varlistentry><term><parameter>_glist_</parameter>&#160;:</term>
<listitem><simpara>The GList element to convert.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CELL-TEXT--CAPS" role="macro" condition="deprecated:">
<title>GTK_CELL_TEXT()</title>
<indexterm zone="GTK-CELL-TEXT--CAPS" role="deprecated"><primary sortas="CELL_TEXT">GTK_CELL_TEXT</primary></indexterm><programlisting>#define GTK_CELL_TEXT(cell)     (((GtkCellText *) &amp;(cell)))
</programlisting>
<warning><para><literal>GTK_CELL_TEXT</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to cast a generic <link linkend="GtkCList"><type>GtkCList</type></link> cell item to a GtkCellText pointer.
</para><variablelist role="params">
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> cell item to convert.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CELL-PIXMAP--CAPS" role="macro" condition="deprecated:">
<title>GTK_CELL_PIXMAP()</title>
<indexterm zone="GTK-CELL-PIXMAP--CAPS" role="deprecated"><primary sortas="CELL_PIXMAP">GTK_CELL_PIXMAP</primary></indexterm><programlisting>#define GTK_CELL_PIXMAP(cell)   (((GtkCellPixmap *) &amp;(cell)))
</programlisting>
<warning><para><literal>GTK_CELL_PIXMAP</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to cast a generic <link linkend="GtkCList"><type>GtkCList</type></link> cell item to a GtkCellPixmap pointer.
</para><variablelist role="params">
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> cell item to convert.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CELL-PIXTEXT--CAPS" role="macro" condition="deprecated:">
<title>GTK_CELL_PIXTEXT()</title>
<indexterm zone="GTK-CELL-PIXTEXT--CAPS" role="deprecated"><primary sortas="CELL_PIXTEXT">GTK_CELL_PIXTEXT</primary></indexterm><programlisting>#define GTK_CELL_PIXTEXT(cell)  (((GtkCellPixText *) &amp;(cell)))
</programlisting>
<warning><para><literal>GTK_CELL_PIXTEXT</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to cast a generic <link linkend="GtkCList"><type>GtkCList</type></link> cell item to a GtkCellPixText pointer.
</para><variablelist role="params">
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> cell item to convert.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GTK-CELL-WIDGET--CAPS" role="macro" condition="deprecated:">
<title>GTK_CELL_WIDGET()</title>
<indexterm zone="GTK-CELL-WIDGET--CAPS" role="deprecated"><primary sortas="CELL_WIDGET">GTK_CELL_WIDGET</primary></indexterm><programlisting>#define GTK_CELL_WIDGET(cell)   (((GtkCellWidget *) &amp;(cell)))
</programlisting>
<warning><para><literal>GTK_CELL_WIDGET</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A macro to cast a generic <link linkend="GtkCList"><type>GtkCList</type></link> cell item to a GtkCellWidget pointer.
</para><variablelist role="params">
<varlistentry><term><parameter>cell</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> cell item to convert.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GtkCListCompareFunc" role="function" condition="deprecated:">
<title>GtkCListCompareFunc ()</title>
<indexterm zone="GtkCListCompareFunc" role="deprecated"><primary sortas="CListCompareFunc">GtkCListCompareFunc</primary></indexterm><programlisting><link linkend="gint">gint</link>                (*GtkCListCompareFunc)              (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gconstpointer">gconstpointer</link> ptr1,
                                                         <link linkend="gconstpointer">gconstpointer</link> ptr2);</programlisting>
<warning><para><literal>GtkCListCompareFunc</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Function prototype for the compare function callback.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> that is affected.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ptr1</parameter>&#160;:</term>
<listitem><simpara>A <link linkend="gconstpointer"><type>gconstpointer</type></link> to the first node to compare.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ptr2</parameter>&#160;:</term>
<listitem><simpara>A <link linkend="gconstpointer"><type>gconstpointer</type></link> to the second node to compare.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>0 if the nodes are equal, less than 0 if the first node should
come before the second, and greater than 1 if the second come before the
first.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GtkCListColumn" role="struct" condition="deprecated:">
<title>GtkCListColumn</title>
<indexterm zone="GtkCListColumn" role="deprecated"><primary sortas="CListColumn">GtkCListColumn</primary></indexterm><programlisting>typedef struct {
  gchar *title;
  GdkRectangle area;
  
  GtkWidget *button;
  GdkWindow *window;
  
  gint width;
  gint min_width;
  gint max_width;
  GtkJustification justification;
  
  guint visible        : 1;  
  guint width_set      : 1;
  guint resizeable     : 1;
  guint auto_resize    : 1;
  guint button_passive : 1;
} GtkCListColumn;
</programlisting>
<warning><para><literal>GtkCListColumn</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to keep track of information
about its columns.
</para></refsect2>
<refsect2 id="GtkCListRow" role="struct" condition="deprecated:">
<title>GtkCListRow</title>
<indexterm zone="GtkCListRow" role="deprecated"><primary sortas="CListRow">GtkCListRow</primary></indexterm><programlisting>typedef struct {
  GtkCell *cell;
  GtkStateType state;
  
  GdkColor foreground;
  GdkColor background;
  
  GtkStyle *style;

  gpointer data;
  GDestroyNotify destroy;
  
  guint fg_set     : 1;
  guint bg_set     : 1;
  guint selectable : 1;
} GtkCListRow;
</programlisting>
<warning><para><literal>GtkCListRow</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to keep track of information
about its rows.
</para></refsect2>
<refsect2 id="GtkCellText" role="struct" condition="deprecated:">
<title>GtkCellText</title>
<indexterm zone="GtkCellText" role="deprecated"><primary sortas="CellText">GtkCellText</primary></indexterm><programlisting>typedef struct {
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  gchar *text;
} GtkCellText;
</programlisting>
<warning><para><literal>GtkCellText</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
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
that contain text.
</para></refsect2>
<refsect2 id="GtkCellPixmap" role="struct" condition="deprecated:">
<title>GtkCellPixmap</title>
<indexterm zone="GtkCellPixmap" role="deprecated"><primary sortas="CellPixmap">GtkCellPixmap</primary></indexterm><programlisting>typedef struct {
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  GdkPixmap *pixmap;
  GdkBitmap *mask;
} GtkCellPixmap;
</programlisting>
<warning><para><literal>GtkCellPixmap</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
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
that contain a GdkPixmap.
</para></refsect2>
<refsect2 id="GtkCellPixText" role="struct" condition="deprecated:">
<title>GtkCellPixText</title>
<indexterm zone="GtkCellPixText" role="deprecated"><primary sortas="CellPixText">GtkCellPixText</primary></indexterm><programlisting>typedef struct {
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  gchar *text;
  guint8 spacing;
  GdkPixmap *pixmap;
  GdkBitmap *mask;
} GtkCellPixText;
</programlisting>
<warning><para><literal>GtkCellPixText</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
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
that contain a combination of text and a GdkPixmap.
</para></refsect2>
<refsect2 id="GtkCellWidget" role="struct" condition="deprecated:">
<title>GtkCellWidget</title>
<indexterm zone="GtkCellWidget" role="deprecated"><primary sortas="CellWidget">GtkCellWidget</primary></indexterm><programlisting>typedef struct {
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  GtkWidget *widget;
} GtkCellWidget;
</programlisting>
<warning><para><literal>GtkCellWidget</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
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
that contain another widget.
</para></refsect2>
<refsect2 id="GtkCell" role="struct" condition="deprecated:">
<title>GtkCell</title>
<indexterm zone="GtkCell" role="deprecated"><primary sortas="Cell">GtkCell</primary></indexterm><programlisting>typedef struct {
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  union {
    gchar *text;
    
    struct {
      GdkPixmap *pixmap;
      GdkBitmap *mask;
    } pm;
    
    struct {
      gchar *text;
      guint8 spacing;
      GdkPixmap *pixmap;
      GdkBitmap *mask;
    } pt;
    
    GtkWidget *widget;
  } u;
} GtkCell;
</programlisting>
<warning><para><literal>GtkCell</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A generic structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to keep track of the
contents of each of its cells.
</para></refsect2>
<refsect2 id="GtkCListCellInfo" role="struct" condition="deprecated:">
<title>GtkCListCellInfo</title>
<indexterm zone="GtkCListCellInfo" role="deprecated"><primary sortas="CListCellInfo">GtkCListCellInfo</primary></indexterm><programlisting>typedef struct {
  gint row;
  gint column;
} GtkCListCellInfo;
</programlisting>
<warning><para><literal>GtkCListCellInfo</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A simple structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to keep track
of the location of a cell.
</para></refsect2>
<refsect2 id="GtkCListDestInfo" role="struct" condition="deprecated:">
<title>GtkCListDestInfo</title>
<indexterm zone="GtkCListDestInfo" role="deprecated"><primary sortas="CListDestInfo">GtkCListDestInfo</primary></indexterm><programlisting>typedef struct {
  GtkCListCellInfo cell;
  GtkCListDragPos  insert_pos;
} GtkCListDestInfo;
</programlisting>
<warning><para><literal>GtkCListDestInfo</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A simple structure that the <link linkend="GtkCList"><type>GtkCList</type></link> widget uses to track
a cell for a drag operation.
</para></refsect2>
<refsect2 id="GtkCListDragPos" role="enum" condition="deprecated:">
<title>enum GtkCListDragPos</title>
<indexterm zone="GtkCListDragPos" role="deprecated"><primary sortas="CListDragPos">GtkCListDragPos</primary></indexterm><programlisting>typedef enum
{
  GTK_CLIST_DRAG_NONE,
  GTK_CLIST_DRAG_BEFORE,
  GTK_CLIST_DRAG_INTO,
  GTK_CLIST_DRAG_AFTER
} GtkCListDragPos;
</programlisting>
<warning><para><literal>GtkCListDragPos</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
An enumeration for drag operations.
</para></refsect2>
<refsect2 id="gtk-clist-new" role="function" condition="deprecated:">
<title>gtk_clist_new ()</title>
<indexterm zone="gtk-clist-new" role="deprecated"><primary sortas="clist_new">gtk_clist_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_clist_new                       (<link linkend="gint">gint</link> columns);</programlisting>
<warning><para><literal>gtk_clist_new</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Creates a new <link linkend="GtkCList"><type>GtkCList</type></link> widget for use.
</para><variablelist role="params">
<varlistentry><term><parameter>columns</parameter>&#160;:</term>
<listitem><simpara>The number of columns the <link linkend="GtkCList"><type>GtkCList</type></link> should have.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>A pointer to a new GtkCList object.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-new-with-titles" role="function" condition="deprecated:">
<title>gtk_clist_new_with_titles ()</title>
<indexterm zone="gtk-clist-new-with-titles" role="deprecated"><primary sortas="clist_new_with_titles">gtk_clist_new_with_titles</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_clist_new_with_titles           (<link linkend="gint">gint</link> columns,
                                                         <link linkend="gchar">gchar</link> *titles[]);</programlisting>
<warning><para><literal>gtk_clist_new_with_titles</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Creates a new <link linkend="GtkCList"><type>GtkCList</type></link> widget with column titles for use.
</para><variablelist role="params">
<varlistentry><term><parameter>columns</parameter>&#160;:</term>
<listitem><simpara>The number of columns the <link linkend="GtkCList"><type>GtkCList</type></link> should have.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>titles</parameter>&#160;:</term>
<listitem><simpara>A string array of titles for the widget.  There should be
enough strings in the array for the specified number of columns.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>A pointer to a new GtkCList object.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-shadow-type" role="function" condition="deprecated:">
<title>gtk_clist_set_shadow_type ()</title>
<indexterm zone="gtk-clist-set-shadow-type" role="deprecated"><primary sortas="clist_set_shadow_type">gtk_clist_set_shadow_type</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_shadow_type           (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="GtkShadowType">GtkShadowType</link> type);</programlisting>
<warning><para><literal>gtk_clist_set_shadow_type</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the shadow type for the specified CList.  Changing this value
will cause the <link linkend="GtkCList"><type>GtkCList</type></link> to update its visuals.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>type</parameter>&#160;:</term>
<listitem><simpara>The GtkShadowType desired.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-selection-mode" role="function" condition="deprecated:">
<title>gtk_clist_set_selection_mode ()</title>
<indexterm zone="gtk-clist-set-selection-mode" role="deprecated"><primary sortas="clist_set_selection_mode">gtk_clist_set_selection_mode</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_selection_mode        (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="GtkSelectionMode">GtkSelectionMode</link> mode);</programlisting>
<warning><para><literal>gtk_clist_set_selection_mode</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the selection mode for the specified CList.  This allows you to
set whether only one or more than one item can be selected at a time
in the widget.  Note that setting the widget's selection mode to one
of GTK_SELECTION_BROWSE or GTK_SELECTION_SINGLE will cause all the
items in the <link linkend="GtkCList"><type>GtkCList</type></link> to become deselected.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>mode</parameter>&#160;:</term>
<listitem><simpara>The GtkSelectionMode type to set for this CList.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-freeze" role="function" condition="deprecated:">
<title>gtk_clist_freeze ()</title>
<indexterm zone="gtk-clist-freeze" role="deprecated"><primary sortas="clist_freeze">gtk_clist_freeze</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_freeze                    (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
<warning><para><literal>gtk_clist_freeze</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Causes the <link linkend="GtkCList"><type>GtkCList</type></link> to stop updating its visuals until a matching call to
<link linkend="gtk-clist-thaw"><function>gtk_clist_thaw()</function></link> is made.  This function is useful if a lot of changes
will be made to the widget that may cause a lot of visual updating to
occur.  Note that calls to <link linkend="gtk-clist-freeze"><function>gtk_clist_freeze()</function></link> can be nested.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to freeze.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-thaw" role="function" condition="deprecated:">
<title>gtk_clist_thaw ()</title>
<indexterm zone="gtk-clist-thaw" role="deprecated"><primary sortas="clist_thaw">gtk_clist_thaw</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_thaw                      (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
<warning><para><literal>gtk_clist_thaw</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Causes the specified <link linkend="GtkCList"><type>GtkCList</type></link> to allow visual updates.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to thaw.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-column-titles-show" role="function" condition="deprecated:">
<title>gtk_clist_column_titles_show ()</title>
<indexterm zone="gtk-clist-column-titles-show" role="deprecated"><primary sortas="clist_column_titles_show">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>
<warning><para><literal>gtk_clist_column_titles_show</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This function causes the <link linkend="GtkCList"><type>GtkCList</type></link> to show its column titles, if
they are not already showing.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-column-titles-hide" role="function" condition="deprecated:">
<title>gtk_clist_column_titles_hide ()</title>
<indexterm zone="gtk-clist-column-titles-hide" role="deprecated"><primary sortas="clist_column_titles_hide">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>
<warning><para><literal>gtk_clist_column_titles_hide</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Causes the <link linkend="GtkCList"><type>GtkCList</type></link> to hide its column titles, if they are currently
showing.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-column-title-active" role="function" condition="deprecated:">
<title>gtk_clist_column_title_active ()</title>
<indexterm zone="gtk-clist-column-title-active" role="deprecated"><primary sortas="clist_column_title_active">gtk_clist_column_title_active</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_column_title_active       (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<warning><para><literal>gtk_clist_column_title_active</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the specified column in the <link linkend="GtkCList"><type>GtkCList</type></link> to become selectable.  You can
then respond to events from the user clicking on a title button, and take
appropriate action.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to make active, counting from 0.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-column-title-passive" role="function" condition="deprecated:">
<title>gtk_clist_column_title_passive ()</title>
<indexterm zone="gtk-clist-column-title-passive" role="deprecated"><primary sortas="clist_column_title_passive">gtk_clist_column_title_passive</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_column_title_passive      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<warning><para><literal>gtk_clist_column_title_passive</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Causes the specified column title button to become passive, i.e., does
not respond to events, such as the user clicking on it.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to make passive, counting from 0.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-column-titles-active" role="function" condition="deprecated:">
<title>gtk_clist_column_titles_active ()</title>
<indexterm zone="gtk-clist-column-titles-active" role="deprecated"><primary sortas="clist_column_titles_active">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>
<warning><para><literal>gtk_clist_column_titles_active</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Causes all column title buttons to become active.  This is the same
as calling <link linkend="gtk-clist-column-title-active"><function>gtk_clist_column_title_active()</function></link> for each column.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-column-titles-passive" role="function" condition="deprecated:">
<title>gtk_clist_column_titles_passive ()</title>
<indexterm zone="gtk-clist-column-titles-passive" role="deprecated"><primary sortas="clist_column_titles_passive">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>
<warning><para><literal>gtk_clist_column_titles_passive</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Causes all column title buttons to become passive.  This is the same
as calling <link linkend="gtk-clist-column-title-passive"><function>gtk_clist_column_title_passive()</function></link> for each column.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-column-title" role="function" condition="deprecated:">
<title>gtk_clist_set_column_title ()</title>
<indexterm zone="gtk-clist-set-column-title" role="deprecated"><primary sortas="clist_set_column_title">gtk_clist_set_column_title</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_column_title          (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column,
                                                         const <link linkend="gchar">gchar</link> *title);</programlisting>
<warning><para><literal>gtk_clist_set_column_title</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the title for the specified column.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column whose title should be changed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>title</parameter>&#160;:</term>
<listitem><simpara>A string to be the column's title.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-column-widget" role="function" condition="deprecated:">
<title>gtk_clist_set_column_widget ()</title>
<indexterm zone="gtk-clist-set-column-widget" role="deprecated"><primary sortas="clist_set_column_widget">gtk_clist_set_column_widget</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_column_widget         (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget);</programlisting>
<warning><para><literal>gtk_clist_set_column_widget</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets a widget to be used as the specified column's title.  This
can be used to place a pixmap or something else as the column
title, instead of the standard text.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column whose title should be a widget.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
<listitem><simpara>A pointer to a previously create widget.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-column-justification" role="function" condition="deprecated:">
<title>gtk_clist_set_column_justification ()</title>
<indexterm zone="gtk-clist-set-column-justification" role="deprecated"><primary sortas="clist_set_column_justification">gtk_clist_set_column_justification</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_column_justification  (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="GtkJustification">GtkJustification</link> justification);</programlisting>
<warning><para><literal>gtk_clist_set_column_justification</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the justification to be used for all text in the specified
column.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column which should be affected.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>justification</parameter>&#160;:</term>
<listitem><simpara>A GtkJustification value for the column.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-column-visibility" role="function" condition="deprecated:">
<title>gtk_clist_set_column_visibility ()</title>
<indexterm zone="gtk-clist-set-column-visibility" role="deprecated"><primary sortas="clist_set_column_visibility">gtk_clist_set_column_visibility</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_column_visibility     (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gboolean">gboolean</link> visible);</programlisting>
<warning><para><literal>gtk_clist_set_column_visibility</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Allows you to set whether a specified column in the <link linkend="GtkCList"><type>GtkCList</type></link> should
be hidden or shown.  Note that at least one column must always be
showing, so attempting to hide the last visible column will be
ignored.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to set visibility.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>visible</parameter>&#160;:</term>
<listitem><simpara>%TRUE or <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-column-resizeable" role="function" condition="deprecated:">
<title>gtk_clist_set_column_resizeable ()</title>
<indexterm zone="gtk-clist-set-column-resizeable" role="deprecated"><primary sortas="clist_set_column_resizeable">gtk_clist_set_column_resizeable</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_column_resizeable     (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gboolean">gboolean</link> resizeable);</programlisting>
<warning><para><literal>gtk_clist_set_column_resizeable</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Lets you specify whether a specified column should be resizeable
by the user.  Note that turning on resizeability for the column will
automatically shut off auto-resizing, but turning off resizeability
will NOT turn on auto-resizing.  This must be done manually via a
call to <link linkend="gtk-clist-set-column-auto-resize"><function>gtk_clist_set_column_auto_resize()</function></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column on which to set resizeability.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>resizeable</parameter>&#160;:</term>
<listitem><simpara>%TRUE or <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-column-auto-resize" role="function" condition="deprecated:">
<title>gtk_clist_set_column_auto_resize ()</title>
<indexterm zone="gtk-clist-set-column-auto-resize" role="deprecated"><primary sortas="clist_set_column_auto_resize">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,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gboolean">gboolean</link> auto_resize);</programlisting>
<warning><para><literal>gtk_clist_set_column_auto_resize</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Lets you specify whether a column should be automatically resized
by the widget when data is added or removed.  Enabling auto-resize
on a column explicity disallows user-resizing of the column.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column on which to set auto-resizing.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>auto_resize</parameter>&#160;:</term>
<listitem><simpara>%TRUE or <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-optimal-column-width" role="function" condition="deprecated:">
<title>gtk_clist_optimal_column_width ()</title>
<indexterm zone="gtk-clist-optimal-column-width" role="deprecated"><primary sortas="clist_optimal_column_width">gtk_clist_optimal_column_width</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_clist_optimal_column_width      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<warning><para><literal>gtk_clist_optimal_column_width</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the required width in pixels that is needed to show
everything in the specified column.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to check.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to check.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>The required width in pixels for the column.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-column-width" role="function" condition="deprecated:">
<title>gtk_clist_set_column_width ()</title>
<indexterm zone="gtk-clist-set-column-width" role="deprecated"><primary sortas="clist_set_column_width">gtk_clist_set_column_width</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_column_width          (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gint">gint</link> width);</programlisting>
<warning><para><literal>gtk_clist_set_column_width</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Causes the column specified for the <link linkend="GtkCList"><type>GtkCList</type></link> to be set to
a specified width.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to set the width.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>width</parameter>&#160;:</term>
<listitem><simpara>The width, in pixels.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-column-min-width" role="function" condition="deprecated:">
<title>gtk_clist_set_column_min_width ()</title>
<indexterm zone="gtk-clist-set-column-min-width" role="deprecated"><primary sortas="clist_set_column_min_width">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,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gint">gint</link> min_width);</programlisting>
<warning><para><literal>gtk_clist_set_column_min_width</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Causes the column specified to have a minimum width, preventing
the user from resizing it smaller than that specified.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to set the minimum width.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>min_width</parameter>&#160;:</term>
<listitem><simpara>The width, in pixels.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-column-max-width" role="function" condition="deprecated:">
<title>gtk_clist_set_column_max_width ()</title>
<indexterm zone="gtk-clist-set-column-max-width" role="deprecated"><primary sortas="clist_set_column_max_width">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,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gint">gint</link> max_width);</programlisting>
<warning><para><literal>gtk_clist_set_column_max_width</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Causes the column specified to have a maximum width, preventing
the user from resizing it larger than that specified.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to set the maximum width.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>max_width</parameter>&#160;:</term>
<listitem><simpara>The width, in pixels.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-row-height" role="function" condition="deprecated:">
<title>gtk_clist_set_row_height ()</title>
<indexterm zone="gtk-clist-set-row-height" role="deprecated"><primary sortas="clist_set_row_height">gtk_clist_set_row_height</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_row_height            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="guint">guint</link> height);</programlisting>
<warning><para><literal>gtk_clist_set_row_height</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Causes the <link linkend="GtkCList"><type>GtkCList</type></link> to have a specified height for its
rows.  Setting the row height to 0 allows the <link linkend="GtkCList"><type>GtkCList</type></link> to adjust
automatically to data in the row.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>height</parameter>&#160;:</term>
<listitem><simpara>The height, in pixels.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-moveto" role="function" condition="deprecated:">
<title>gtk_clist_moveto ()</title>
<indexterm zone="gtk-clist-moveto" role="deprecated"><primary sortas="clist_moveto">gtk_clist_moveto</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_moveto                    (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gfloat">gfloat</link> row_align,
                                                         <link linkend="gfloat">gfloat</link> col_align);</programlisting>
<warning><para><literal>gtk_clist_moveto</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Tells the CList widget to visually move to the specified
row and column.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to which to move.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to which to move.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row_align</parameter>&#160;:</term>
<listitem><simpara>A value between 0 and 1 that describes the positioning of 
the row in relation to the viewable area of the CList's contents.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>col_align</parameter>&#160;:</term>
<listitem><simpara>A value between 0 and 1 that describes the positioning of 
the column in relation to the viewable area of the CList's contents.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-row-is-visible" role="function" condition="deprecated:">
<title>gtk_clist_row_is_visible ()</title>
<indexterm zone="gtk-clist-row-is-visible" role="deprecated"><primary sortas="clist_row_is_visible">gtk_clist_row_is_visible</primary></indexterm><programlisting><link linkend="GtkVisibility">GtkVisibility</link>       gtk_clist_row_is_visible            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row);</programlisting>
<warning><para><literal>gtk_clist_row_is_visible</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Checks how the specified row is visible.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to query.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>A <link linkend="GtkVisibility"><type>GtkVisibility</type></link> value that tells you how the row is visible.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-cell-type" role="function" condition="deprecated:">
<title>gtk_clist_get_cell_type ()</title>
<indexterm zone="gtk-clist-get-cell-type" role="deprecated"><primary sortas="clist_get_cell_type">gtk_clist_get_cell_type</primary></indexterm><programlisting><link linkend="GtkCellType">GtkCellType</link>         gtk_clist_get_cell_type             (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<warning><para><literal>gtk_clist_get_cell_type</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Checks the type of cell at the location specified.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>A <link linkend="GtkCellType"><type>GtkCellType</type></link> value describing the cell.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-text" role="function" condition="deprecated:">
<title>gtk_clist_set_text ()</title>
<indexterm zone="gtk-clist-set-text" role="deprecated"><primary sortas="clist_set_text">gtk_clist_set_text</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_text                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         const <link linkend="gchar">gchar</link> *text);</programlisting>
<warning><para><literal>gtk_clist_set_text</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the displayed text in the specified cell.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara>The text to set in the cell.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-text" role="function" condition="deprecated:">
<title>gtk_clist_get_text ()</title>
<indexterm zone="gtk-clist-get-text" role="deprecated"><primary sortas="clist_get_text">gtk_clist_get_text</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_clist_get_text                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gchar">gchar</link> **text);</programlisting>
<warning><para><literal>gtk_clist_get_text</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the text for the specified cell.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to query.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to query.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara>A pointer to a pointer to store the text.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>1 if the cell's text could be retrieved, 0 otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-pixmap" role="function" condition="deprecated:">
<title>gtk_clist_set_pixmap ()</title>
<indexterm zone="gtk-clist-set-pixmap" role="deprecated"><primary sortas="clist_set_pixmap">gtk_clist_set_pixmap</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_pixmap                (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="GdkPixmap">GdkPixmap</link> *pixmap,
                                                         <link linkend="GdkBitmap">GdkBitmap</link> *mask);</programlisting>
<warning><para><literal>gtk_clist_set_pixmap</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets a pixmap for the specified cell.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pixmap</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="GdkPixmap"><type>GdkPixmap</type></link> to place in the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>mask</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="GdkBitmap"><type>GdkBitmap</type></link> mask for the cell.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-pixmap" role="function" condition="deprecated:">
<title>gtk_clist_get_pixmap ()</title>
<indexterm zone="gtk-clist-get-pixmap" role="deprecated"><primary sortas="clist_get_pixmap">gtk_clist_get_pixmap</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_clist_get_pixmap                (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="GdkPixmap">GdkPixmap</link> **pixmap,
                                                         <link linkend="GdkBitmap">GdkBitmap</link> **mask);</programlisting>
<warning><para><literal>gtk_clist_get_pixmap</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the pixmap and bitmap mask of the specified cell.  The returned mask value can be NULL.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pixmap</parameter>&#160;:</term>
<listitem><simpara>A pointer to a pointer to store the cell's <link linkend="GdkPixmap"><type>GdkPixmap</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>mask</parameter>&#160;:</term>
<listitem><simpara>A pointer to a pointer to store the cell's <link linkend="GdkBitmap"><type>GdkBitmap</type></link> mask.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>1 if the cell's pixmap could be retrieved, 0 otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-pixtext" role="function" condition="deprecated:">
<title>gtk_clist_set_pixtext ()</title>
<indexterm zone="gtk-clist-set-pixtext" role="deprecated"><primary sortas="clist_set_pixtext">gtk_clist_set_pixtext</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_pixtext               (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         const <link linkend="gchar">gchar</link> *text,
                                                         <link linkend="guint8">guint8</link> spacing,
                                                         <link linkend="GdkPixmap">GdkPixmap</link> *pixmap,
                                                         <link linkend="GdkBitmap">GdkBitmap</link> *mask);</programlisting>
<warning><para><literal>gtk_clist_set_pixtext</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets text and a pixmap/bitmap on the specified cell.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara>The text to set in the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>spacing</parameter>&#160;:</term>
<listitem><simpara>The spacing between the cell's text and pixmap.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pixmap</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="GdkPixmap"><type>GdkPixmap</type></link> for the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>mask</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="GdkBitmap"><type>GdkBitmap</type></link> mask for the cell.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-pixtext" role="function" condition="deprecated:">
<title>gtk_clist_get_pixtext ()</title>
<indexterm zone="gtk-clist-get-pixtext" role="deprecated"><primary sortas="clist_get_pixtext">gtk_clist_get_pixtext</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_clist_get_pixtext               (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gchar">gchar</link> **text,
                                                         <link linkend="guint8">guint8</link> *spacing,
                                                         <link linkend="GdkPixmap">GdkPixmap</link> **pixmap,
                                                         <link linkend="GdkBitmap">GdkBitmap</link> **mask);</programlisting>
<warning><para><literal>gtk_clist_get_pixtext</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the text, pixmap and bitmap mask for the specified cell.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to query.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to query.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara>A pointer to a pointer to store the text.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>spacing</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="guint8"><type>guint8</type></link> to store the spacing.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pixmap</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="GdkPixmap"><type>GdkPixmap</type></link> pointer to store the cell's pixmap.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>mask</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="GdkBitmap"><type>GdkBitmap</type></link> pointer to store the cell's bitmap mask.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>1 if the retrieval was successful, 0 otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-foreground" role="function" condition="deprecated:">
<title>gtk_clist_set_foreground ()</title>
<indexterm zone="gtk-clist-set-foreground" role="deprecated"><primary sortas="clist_set_foreground">gtk_clist_set_foreground</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_foreground            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         const <link linkend="GdkColor">GdkColor</link> *color);</programlisting>
<warning><para><literal>gtk_clist_set_foreground</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the foreground color for the specified row.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>color</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="GdkColor"><type>GdkColor</type></link> structure.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-background" role="function" condition="deprecated:">
<title>gtk_clist_set_background ()</title>
<indexterm zone="gtk-clist-set-background" role="deprecated"><primary sortas="clist_set_background">gtk_clist_set_background</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_background            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         const <link linkend="GdkColor">GdkColor</link> *color);</programlisting>
<warning><para><literal>gtk_clist_set_background</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the background color for the specified row.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>color</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="GdkColor"><type>GdkColor</type></link> structure.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-cell-style" role="function" condition="deprecated:">
<title>gtk_clist_set_cell_style ()</title>
<indexterm zone="gtk-clist-set-cell-style" role="deprecated"><primary sortas="clist_set_cell_style">gtk_clist_set_cell_style</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_cell_style            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="GtkStyle">GtkStyle</link> *style);</programlisting>
<warning><para><literal>gtk_clist_set_cell_style</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the style for the specified cell.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>style</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="GtkStyle"><type>GtkStyle</type></link> structure.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-cell-style" role="function" condition="deprecated:">
<title>gtk_clist_get_cell_style ()</title>
<indexterm zone="gtk-clist-get-cell-style" role="deprecated"><primary sortas="clist_get_cell_style">gtk_clist_get_cell_style</primary></indexterm><programlisting><link linkend="GtkStyle">GtkStyle</link> *          gtk_clist_get_cell_style            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<warning><para><literal>gtk_clist_get_cell_style</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the current style of the specified cell.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>A <link linkend="GtkStyle"><type>GtkStyle</type></link> object.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-row-style" role="function" condition="deprecated:">
<title>gtk_clist_set_row_style ()</title>
<indexterm zone="gtk-clist-set-row-style" role="deprecated"><primary sortas="clist_set_row_style">gtk_clist_set_row_style</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_row_style             (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="GtkStyle">GtkStyle</link> *style);</programlisting>
<warning><para><literal>gtk_clist_set_row_style</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the style for all cells in the specified row.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>style</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="GtkStyle"><type>GtkStyle</type></link> to set.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-row-style" role="function" condition="deprecated:">
<title>gtk_clist_get_row_style ()</title>
<indexterm zone="gtk-clist-get-row-style" role="deprecated"><primary sortas="clist_get_row_style">gtk_clist_get_row_style</primary></indexterm><programlisting><link linkend="GtkStyle">GtkStyle</link> *          gtk_clist_get_row_style             (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row);</programlisting>
<warning><para><literal>gtk_clist_get_row_style</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the style set for the specified row.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to query.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>The <link linkend="GtkStyle"><type>GtkStyle</type></link> of the row.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-shift" role="function" condition="deprecated:">
<title>gtk_clist_set_shift ()</title>
<indexterm zone="gtk-clist-set-shift" role="deprecated"><primary sortas="clist_set_shift">gtk_clist_set_shift</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_shift                 (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column,
                                                         <link linkend="gint">gint</link> vertical,
                                                         <link linkend="gint">gint</link> horizontal);</programlisting>
<warning><para><literal>gtk_clist_set_shift</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the vertical and horizontal shift of the specified cell.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column of the cell.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>vertical</parameter>&#160;:</term>
<listitem><simpara>The value to set for the vertical shift.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>horizontal</parameter>&#160;:</term>
<listitem><simpara>The value to set for the vertical shift.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-selectable" role="function" condition="deprecated:">
<title>gtk_clist_set_selectable ()</title>
<indexterm zone="gtk-clist-set-selectable" role="deprecated"><primary sortas="clist_set_selectable">gtk_clist_set_selectable</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_selectable            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gboolean">gboolean</link> selectable);</programlisting>
<warning><para><literal>gtk_clist_set_selectable</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets whether the specified row is selectable or not.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>selectable</parameter>&#160;:</term>
<listitem><simpara>%TRUE or <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-selectable" role="function" condition="deprecated:">
<title>gtk_clist_get_selectable ()</title>
<indexterm zone="gtk-clist-get-selectable" role="deprecated"><primary sortas="clist_get_selectable">gtk_clist_get_selectable</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_clist_get_selectable            (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row);</programlisting>
<warning><para><literal>gtk_clist_get_selectable</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets whether the specified row is selectable or not.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to query.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>A <link linkend="gboolean"><type>gboolean</type></link> value.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-prepend" role="function" condition="deprecated:">
<title>gtk_clist_prepend ()</title>
<indexterm zone="gtk-clist-prepend" role="deprecated"><primary sortas="clist_prepend">gtk_clist_prepend</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_clist_prepend                   (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gchar">gchar</link> *text[]);</programlisting>
<warning><para><literal>gtk_clist_prepend</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Adds a row to the CList at the top.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara>An array of strings to add.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>The number of the row added.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-append" role="function" condition="deprecated:">
<title>gtk_clist_append ()</title>
<indexterm zone="gtk-clist-append" role="deprecated"><primary sortas="clist_append">gtk_clist_append</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_clist_append                    (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gchar">gchar</link> *text[]);</programlisting>
<warning><para><literal>gtk_clist_append</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Adds a row to the CList at the bottom.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara>An array of strings to add.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>The number of the row added.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-insert" role="function" condition="deprecated:">
<title>gtk_clist_insert ()</title>
<indexterm zone="gtk-clist-insert" role="deprecated"><primary sortas="clist_insert">gtk_clist_insert</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_clist_insert                    (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gchar">gchar</link> *text[]);</programlisting>
<warning><para><literal>gtk_clist_insert</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Adds a row of text to the CList at the specified position.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row where the text should be inserted.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara>An array of string to add.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>The number of the row added.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-remove" role="function" condition="deprecated:">
<title>gtk_clist_remove ()</title>
<indexterm zone="gtk-clist-remove" role="deprecated"><primary sortas="clist_remove">gtk_clist_remove</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_remove                    (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row);</programlisting>
<warning><para><literal>gtk_clist_remove</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Removes the specified row from the CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to remove.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-row-data" role="function" condition="deprecated:">
<title>gtk_clist_set_row_data ()</title>
<indexterm zone="gtk-clist-set-row-data" role="deprecated"><primary sortas="clist_set_row_data">gtk_clist_set_row_data</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_row_data              (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<warning><para><literal>gtk_clist_set_row_data</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets data for the specified row.  This is the same as calling gtk_clist_set_row_data_full(clist, row, data, NULL).
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara>The data to set for the row.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-row-data-full" role="function" condition="deprecated:">
<title>gtk_clist_set_row_data_full ()</title>
<indexterm zone="gtk-clist-set-row-data-full" role="deprecated"><primary sortas="clist_set_row_data_full">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,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> destroy);</programlisting>
<warning><para><literal>gtk_clist_set_row_data_full</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the data for specified row, with a callback when the row is destroyed.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara>The data to set for the row.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>destroy</parameter>&#160;:</term>
<listitem><simpara>A <link linkend="GtkDestroyNotify"><type>GtkDestroyNotify</type></link> function to be called when the row is destroyed.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-row-data" role="function" condition="deprecated:">
<title>gtk_clist_get_row_data ()</title>
<indexterm zone="gtk-clist-get-row-data" role="deprecated"><primary sortas="clist_get_row_data">gtk_clist_get_row_data</primary></indexterm><programlisting><link linkend="gpointer">gpointer</link>            gtk_clist_get_row_data              (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row);</programlisting>
<warning><para><literal>gtk_clist_get_row_data</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the currently set data for the specified row.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to query.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>The data set for the row.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-find-row-from-data" role="function" condition="deprecated:">
<title>gtk_clist_find_row_from_data ()</title>
<indexterm zone="gtk-clist-find-row-from-data" role="deprecated"><primary sortas="clist_find_row_from_data">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,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<warning><para><literal>gtk_clist_find_row_from_data</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Searches the CList for the row with the specified data.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to search.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara>The data to search for a match.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>The number of the matching row, or -1 if no match could be found.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-select-row" role="function" condition="deprecated:">
<title>gtk_clist_select_row ()</title>
<indexterm zone="gtk-clist-select-row" role="deprecated"><primary sortas="clist_select_row">gtk_clist_select_row</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_select_row                (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<warning><para><literal>gtk_clist_select_row</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Selects the specified row.  Causes the "select-row" signal to be emitted for the specified row and column.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to select.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to select.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-unselect-row" role="function" condition="deprecated:">
<title>gtk_clist_unselect_row ()</title>
<indexterm zone="gtk-clist-unselect-row" role="deprecated"><primary sortas="clist_unselect_row">gtk_clist_unselect_row</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_unselect_row              (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<warning><para><literal>gtk_clist_unselect_row</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Unselects the specified row.  Causes the "unselect-row" signal to be emitted for the specified row and column.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row to select.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to select.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-undo-selection" role="function" condition="deprecated:">
<title>gtk_clist_undo_selection ()</title>
<indexterm zone="gtk-clist-undo-selection" role="deprecated"><primary sortas="clist_undo_selection">gtk_clist_undo_selection</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_undo_selection            (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
<warning><para><literal>gtk_clist_undo_selection</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Undoes the last selection for an "extended selection mode" CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-clear" role="function" condition="deprecated:">
<title>gtk_clist_clear ()</title>
<indexterm zone="gtk-clist-clear" role="deprecated"><primary sortas="clist_clear">gtk_clist_clear</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_clear                     (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
<warning><para><literal>gtk_clist_clear</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Removes all the CList's rows.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-selection-info" role="function" condition="deprecated:">
<title>gtk_clist_get_selection_info ()</title>
<indexterm zone="gtk-clist-get-selection-info" role="deprecated"><primary sortas="clist_get_selection_info">gtk_clist_get_selection_info</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_clist_get_selection_info        (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> x,
                                                         <link linkend="gint">gint</link> y,
                                                         <link linkend="gint">gint</link> *row,
                                                         <link linkend="gint">gint</link> *column);</programlisting>
<warning><para><literal>gtk_clist_get_selection_info</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the row and column at the specified pixel position in the CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>x</parameter>&#160;:</term>
<listitem><simpara>The horizontal pixel position to check.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>y</parameter>&#160;:</term>
<listitem><simpara>The vertical pixel position to check..
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>Pointer to a <link linkend="gint"><type>gint</type></link> to store the row value.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>Pointer to a <link linkend="gint"><type>gint</type></link> to store the column value.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>1 if row/column is returned and in range, 0 otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-select-all" role="function" condition="deprecated:">
<title>gtk_clist_select_all ()</title>
<indexterm zone="gtk-clist-select-all" role="deprecated"><primary sortas="clist_select_all">gtk_clist_select_all</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_select_all                (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
<warning><para><literal>gtk_clist_select_all</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Selects all rows in the CList.  This function has no affect for a
CList in "single" or "browse" selection mode.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-unselect-all" role="function" condition="deprecated:">
<title>gtk_clist_unselect_all ()</title>
<indexterm zone="gtk-clist-unselect-all" role="deprecated"><primary sortas="clist_unselect_all">gtk_clist_unselect_all</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_unselect_all              (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
<warning><para><literal>gtk_clist_unselect_all</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Unselects all rows in the CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-swap-rows" role="function" condition="deprecated:">
<title>gtk_clist_swap_rows ()</title>
<indexterm zone="gtk-clist-swap-rows" role="deprecated"><primary sortas="clist_swap_rows">gtk_clist_swap_rows</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_swap_rows                 (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> row1,
                                                         <link linkend="gint">gint</link> row2);</programlisting>
<warning><para><literal>gtk_clist_swap_rows</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Swaps the two specified rows with each other.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row1</parameter>&#160;:</term>
<listitem><simpara>Number of the first row.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row2</parameter>&#160;:</term>
<listitem><simpara>Number of the second row.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-compare-func" role="function" condition="deprecated:">
<title>gtk_clist_set_compare_func ()</title>
<indexterm zone="gtk-clist-set-compare-func" role="deprecated"><primary sortas="clist_set_compare_func">gtk_clist_set_compare_func</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_compare_func          (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="GtkCListCompareFunc">GtkCListCompareFunc</link> cmp_func);</programlisting>
<warning><para><literal>gtk_clist_set_compare_func</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
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,
then the default compare function is used. The default compare function sorts
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
by <link linkend="gtk-clist-set-sort-column"><function>gtk_clist_set_sort_column()</function></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cmp_func</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCompareFunction"><type>GtkCompareFunction</type></link> to use.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-sort-column" role="function" condition="deprecated:">
<title>gtk_clist_set_sort_column ()</title>
<indexterm zone="gtk-clist-set-sort-column" role="deprecated"><primary sortas="clist_set_sort_column">gtk_clist_set_sort_column</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_sort_column           (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<warning><para><literal>gtk_clist_set_sort_column</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the sort column of the clist. The sort column is used by the
default compare function to determine which column to sort by.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to sort by
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-sort-type" role="function" condition="deprecated:">
<title>gtk_clist_set_sort_type ()</title>
<indexterm zone="gtk-clist-set-sort-type" role="deprecated"><primary sortas="clist_set_sort_type">gtk_clist_set_sort_type</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_sort_type             (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="GtkSortType">GtkSortType</link> sort_type);</programlisting>
<warning><para><literal>gtk_clist_set_sort_type</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the sort type of the <link linkend="GtkClist"><type>GtkClist</type></link>. This is either GTK_SORT_ASCENDING for
ascening sort or GTK_SORT_DESCENDING for descending sort.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>sort_type</parameter>&#160;:</term>
<listitem><simpara>the <link linkend="GtkSortType"><type>GtkSortType</type></link> to use
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-sort" role="function" condition="deprecated:">
<title>gtk_clist_sort ()</title>
<indexterm zone="gtk-clist-sort" role="deprecated"><primary sortas="clist_sort">gtk_clist_sort</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_sort                      (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
<warning><para><literal>gtk_clist_sort</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sorts the <link linkend="GtkClist"><type>GtkClist</type></link> according to the current compare function, which
can be set with the <link linkend="gtk-clist-set-compare-func"><function>gtk_clist_set_compare_func()</function></link> function.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to sort.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-auto-sort" role="function" condition="deprecated:">
<title>gtk_clist_set_auto_sort ()</title>
<indexterm zone="gtk-clist-set-auto-sort" role="deprecated"><primary sortas="clist_set_auto_sort">gtk_clist_set_auto_sort</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_auto_sort             (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gboolean">gboolean</link> auto_sort);</programlisting>
<warning><para><literal>gtk_clist_set_auto_sort</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
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.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>auto_sort</parameter>&#160;:</term>
<listitem><simpara>whether auto sort should be on or off
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-columns-autosize" role="function" condition="deprecated:">
<title>gtk_clist_columns_autosize ()</title>
<indexterm zone="gtk-clist-columns-autosize" role="deprecated"><primary sortas="clist_columns_autosize">gtk_clist_columns_autosize</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_clist_columns_autosize          (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
<warning><para><literal>gtk_clist_columns_autosize</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Auto-sizes all columns in the CList and returns the total width of the CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>The total width of the CList.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-column-title" role="function" condition="deprecated:">
<title>gtk_clist_get_column_title ()</title>
<indexterm zone="gtk-clist-get-column-title" role="deprecated"><primary sortas="clist_get_column_title">gtk_clist_get_column_title</primary></indexterm><programlisting><link linkend="gchar">gchar</link> *             gtk_clist_get_column_title          (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<warning><para><literal>gtk_clist_get_column_title</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the current title of the specified column
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to query.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>The title of the column.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-column-widget" role="function" condition="deprecated:">
<title>gtk_clist_get_column_widget ()</title>
<indexterm zone="gtk-clist-get-column-widget" role="deprecated"><primary sortas="clist_get_column_widget">gtk_clist_get_column_widget</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_clist_get_column_widget         (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> column);</programlisting>
<warning><para><literal>gtk_clist_get_column_widget</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the widget in the column header for the specified column.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column to query.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>Pointer to a <link linkend="GtkWidget"><type>GtkWidget</type></link> for the column header.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-hadjustment" role="function" condition="deprecated:">
<title>gtk_clist_get_hadjustment ()</title>
<indexterm zone="gtk-clist-get-hadjustment" role="deprecated"><primary sortas="clist_get_hadjustment">gtk_clist_get_hadjustment</primary></indexterm><programlisting><link linkend="GtkAdjustment">GtkAdjustment</link>*      gtk_clist_get_hadjustment           (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
<warning><para><literal>gtk_clist_get_hadjustment</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> currently being used for the horizontal
aspect.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to check.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>A <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> object, or NULL if none is currently
being used.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-get-vadjustment" role="function" condition="deprecated:">
<title>gtk_clist_get_vadjustment ()</title>
<indexterm zone="gtk-clist-get-vadjustment" role="deprecated"><primary sortas="clist_get_vadjustment">gtk_clist_get_vadjustment</primary></indexterm><programlisting><link linkend="GtkAdjustment">GtkAdjustment</link>*      gtk_clist_get_vadjustment           (<link linkend="GtkCList">GtkCList</link> *clist);</programlisting>
<warning><para><literal>gtk_clist_get_vadjustment</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Gets the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> currently being used for the vertical
aspect.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to check.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>A <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> object, or NULL if none is currently
being used.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-row-move" role="function" condition="deprecated:">
<title>gtk_clist_row_move ()</title>
<indexterm zone="gtk-clist-row-move" role="deprecated"><primary sortas="clist_row_move">gtk_clist_row_move</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_row_move                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gint">gint</link> source_row,
                                                         <link linkend="gint">gint</link> dest_row);</programlisting>
<warning><para><literal>gtk_clist_row_move</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Allows you to move a row from one position to another in the
list.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>source_row</parameter>&#160;:</term>
<listitem><simpara>The original position of the row to move.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>dest_row</parameter>&#160;:</term>
<listitem><simpara>The position to which the row should be moved.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-button-actions" role="function" condition="deprecated:">
<title>gtk_clist_set_button_actions ()</title>
<indexterm zone="gtk-clist-set-button-actions" role="deprecated"><primary sortas="clist_set_button_actions">gtk_clist_set_button_actions</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_button_actions        (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="guint">guint</link> button,
                                                         <link linkend="guint8">guint8</link> button_actions);</programlisting>
<warning><para><literal>gtk_clist_set_button_actions</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the action(s) that the specified mouse button will have
on the CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&#160;:</term>
<listitem><simpara>The mouse button to set. The values here, unlike in the
         rest of GTK+ start from 0. For instance, the right mouse
         button, which is 3 elsewhere, should be given as 2 here.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button_actions</parameter>&#160;:</term>
<listitem><simpara>A logically OR'd value of <link linkend="GtkButtonAction"><type>GtkButtonAction</type></link> values 
for the button.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-hadjustment" role="function" condition="deprecated:">
<title>gtk_clist_set_hadjustment ()</title>
<indexterm zone="gtk-clist-set-hadjustment" role="deprecated"><primary sortas="clist_set_hadjustment">gtk_clist_set_hadjustment</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_hadjustment           (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);</programlisting>
<warning><para><literal>gtk_clist_set_hadjustment</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Allows you to set the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> to be used for the horizontal
aspect of the <link linkend="GtkCList"><type>GtkCList</type></link> widget.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>adjustment</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> widget, or NULL.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-reorderable" role="function" condition="deprecated:">
<title>gtk_clist_set_reorderable ()</title>
<indexterm zone="gtk-clist-set-reorderable" role="deprecated"><primary sortas="clist_set_reorderable">gtk_clist_set_reorderable</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_reorderable           (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="gboolean">gboolean</link> reorderable);</programlisting>
<warning><para><literal>gtk_clist_set_reorderable</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets whether the CList's rows are re-orderable using drag-and-drop.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>reorderable</parameter>&#160;:</term>
<listitem><simpara>%TRUE or <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-use-drag-icons" role="function" condition="deprecated:">
<title>gtk_clist_set_use_drag_icons ()</title>
<indexterm zone="gtk-clist-set-use-drag-icons" role="deprecated"><primary sortas="clist_set_use_drag_icons">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,
                                                         <link linkend="gboolean">gboolean</link> use_icons);</programlisting>
<warning><para><literal>gtk_clist_set_use_drag_icons</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Determines whether the <link linkend="GtkClist"><type>GtkClist</type></link> should use icons when
doing drag-and-drop operations.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>use_icons</parameter>&#160;:</term>
<listitem><simpara>%TRUE or <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-clist-set-vadjustment" role="function" condition="deprecated:">
<title>gtk_clist_set_vadjustment ()</title>
<indexterm zone="gtk-clist-set-vadjustment" role="deprecated"><primary sortas="clist_set_vadjustment">gtk_clist_set_vadjustment</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_clist_set_vadjustment           (<link linkend="GtkCList">GtkCList</link> *clist,
                                                         <link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);</programlisting>
<warning><para><literal>gtk_clist_set_vadjustment</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Allows you to set the <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> to be used for the vertical
aspect of the <link linkend="GtkCList"><type>GtkCList</type></link> widget.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The <link linkend="GtkCList"><type>GtkCList</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>adjustment</parameter>&#160;:</term>
<listitem><simpara>A pointer to a <link linkend="GtkAdjustment"><type>GtkAdjustment</type></link> widget, or NULL.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1 id="GtkCList.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkCList--n-columns" role="property"><title>The <literal>&quot;n-columns&quot;</literal> property</title>
<indexterm zone="GtkCList--n-columns"><primary sortas="CList:n-columns">GtkCList:n-columns</primary></indexterm><programlisting>  &quot;n-columns&quot;                <link linkend="guint">guint</link>                 : Read / Write / Construct Only</programlisting>
<para>
An integer value for a column.
</para><para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkCList--reorderable" role="property"><title>The <literal>&quot;reorderable&quot;</literal> property</title>
<indexterm zone="GtkCList--reorderable"><primary sortas="CList:reorderable">GtkCList:reorderable</primary></indexterm><programlisting>  &quot;reorderable&quot;              <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
A boolean value for determining if the user can re-order the CList's
columns.
</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCList--row-height" role="property"><title>The <literal>&quot;row-height&quot;</literal> property</title>
<indexterm zone="GtkCList--row-height"><primary sortas="CList:row-height">GtkCList:row-height</primary></indexterm><programlisting>  &quot;row-height&quot;               <link linkend="guint">guint</link>                 : Read / Write</programlisting>
<para>
An integer value representing the height of a row in pixels.
</para><para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkCList--selection-mode" role="property"><title>The <literal>&quot;selection-mode&quot;</literal> property</title>
<indexterm zone="GtkCList--selection-mode"><primary sortas="CList:selection-mode">GtkCList:selection-mode</primary></indexterm><programlisting>  &quot;selection-mode&quot;           <link linkend="GtkSelectionMode">GtkSelectionMode</link>      : Read / Write</programlisting>
<para>
Sets the type of selection mode for the CList.
</para><para>Default value: GTK_SELECTION_NONE</para>
</refsect2>
<refsect2 id="GtkCList--shadow-type" role="property"><title>The <literal>&quot;shadow-type&quot;</literal> property</title>
<indexterm zone="GtkCList--shadow-type"><primary sortas="CList:shadow-type">GtkCList:shadow-type</primary></indexterm><programlisting>  &quot;shadow-type&quot;              <link linkend="GtkShadowType">GtkShadowType</link>         : Read / Write</programlisting>
<para>
Sets the shadowing for the CList.
</para><para>Default value: GTK_SHADOW_NONE</para>
</refsect2>
<refsect2 id="GtkCList--sort-type" role="property"><title>The <literal>&quot;sort-type&quot;</literal> property</title>
<indexterm zone="GtkCList--sort-type"><primary sortas="CList:sort-type">GtkCList:sort-type</primary></indexterm><programlisting>  &quot;sort-type&quot;                <link linkend="GtkSortType">GtkSortType</link>           : Read / Write</programlisting>
<para></para><para>Default value: GTK_SORT_ASCENDING</para>
</refsect2>
<refsect2 id="GtkCList--titles-active" role="property"><title>The <literal>&quot;titles-active&quot;</literal> property</title>
<indexterm zone="GtkCList--titles-active"><primary sortas="CList:titles-active">GtkCList:titles-active</primary></indexterm><programlisting>  &quot;titles-active&quot;            <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
A boolean value for setting whether the column titles can be
clicked.
</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkCList--use-drag-icons" role="property"><title>The <literal>&quot;use-drag-icons&quot;</literal> property</title>
<indexterm zone="GtkCList--use-drag-icons"><primary sortas="CList:use-drag-icons">GtkCList:use-drag-icons</primary></indexterm><programlisting>  &quot;use-drag-icons&quot;           <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
A boolean value for setting whether to use icons during drag
operations.
</para><para>Default value: FALSE</para>
</refsect2>
</refsect1>

<refsect1 id="GtkCList.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkCList-abort-column-resize" role="signal"><title>The <literal>&quot;abort-column-resize&quot;</literal> signal</title>
<indexterm zone="GtkCList-abort-column-resize"><primary sortas="CList::abort-column-resize">GtkCList::abort-column-resize</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                        <link linkend="gpointer">gpointer</link>  user_data)      : Run Last / Action</programlisting>
<para>
This signal is emitted when a column resize is aborted.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-click-column" role="signal"><title>The <literal>&quot;click-column&quot;</literal> signal</title>
<indexterm zone="GtkCList-click-column"><primary sortas="CList::click-column">GtkCList::click-column</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                        <link linkend="gint">gint</link>      column,
                                                        <link linkend="gpointer">gpointer</link>  user_data)      : Run First</programlisting>
<para>
This signal is emitted when a column title is clicked.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The number of the column.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-end-selection" role="signal"><title>The <literal>&quot;end-selection&quot;</literal> signal</title>
<indexterm zone="GtkCList-end-selection"><primary sortas="CList::end-selection">GtkCList::end-selection</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                        <link linkend="gpointer">gpointer</link>  user_data)      : Run Last / Action</programlisting>
<para>
This signal is emitted when a selection ends in a
multiple selection CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-extend-selection" role="signal"><title>The <literal>&quot;extend-selection&quot;</literal> signal</title>
<indexterm zone="GtkCList-extend-selection"><primary sortas="CList::extend-selection">GtkCList::extend-selection</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link>     *clist,
                                                        <link linkend="GtkScrollType">GtkScrollType</link> scroll_type,
                                                        <link linkend="gfloat">gfloat</link>        position,
                                                        <link linkend="gboolean">gboolean</link>      auto_start_selection,
                                                        <link linkend="gpointer">gpointer</link>      user_data)                 : Run Last / Action</programlisting>
<para>
This signal is emitted when the selection is extended.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>scroll_type</parameter>&#160;:</term>
<listitem><simpara>A <link linkend="GtkScrollType"><type>GtkScrollType</type></link> value of any scrolling operation the
occured during the selection.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara>A value between 0.0 and 1.0.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>auto_start_selection</parameter>&#160;:</term>
<listitem><simpara>%TRUE or <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-resize-column" role="signal"><title>The <literal>&quot;resize-column&quot;</literal> signal</title>
<indexterm zone="GtkCList-resize-column"><primary sortas="CList::resize-column">GtkCList::resize-column</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                        <link linkend="gint">gint</link>      column,
                                                        <link linkend="gint">gint</link>      width,
                                                        <link linkend="gpointer">gpointer</link>  user_data)      : Run Last</programlisting>
<para>
This signal is emitted when a column is resized.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The number of the column
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>width</parameter>&#160;:</term>
<listitem><simpara>The new width of the column.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-row-move" role="signal"><title>The <literal>&quot;row-move&quot;</literal> signal</title>
<indexterm zone="GtkCList-row-move"><primary sortas="CList::row-move">GtkCList::row-move</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                        <link linkend="gint">gint</link>      arg1,
                                                        <link linkend="gint">gint</link>      arg2,
                                                        <link linkend="gpointer">gpointer</link>  user_data)      : Run Last</programlisting>
<para>
This signal is emitted when a row is moved.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&#160;:</term>
<listitem><simpara>The source position of the row.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg2</parameter>&#160;:</term>
<listitem><simpara>The destination position of the row.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-scroll-horizontal" role="signal"><title>The <literal>&quot;scroll-horizontal&quot;</literal> signal</title>
<indexterm zone="GtkCList-scroll-horizontal"><primary sortas="CList::scroll-horizontal">GtkCList::scroll-horizontal</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link>     *clist,
                                                        <link linkend="GtkScrollType">GtkScrollType</link> scroll_type,
                                                        <link linkend="gfloat">gfloat</link>        position,
                                                        <link linkend="gpointer">gpointer</link>      user_data)        : Run Last / Action</programlisting>
<para>
This signal is emitted when the CList is scrolled horizontally.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>scroll_type</parameter>&#160;:</term>
<listitem><simpara>A <link linkend="GtkScrollType"><type>GtkScrollType</type></link> value of how the scroll operation occured.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara>a value between 0.0 and 1.0.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-scroll-vertical" role="signal"><title>The <literal>&quot;scroll-vertical&quot;</literal> signal</title>
<indexterm zone="GtkCList-scroll-vertical"><primary sortas="CList::scroll-vertical">GtkCList::scroll-vertical</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link>     *clist,
                                                        <link linkend="GtkScrollType">GtkScrollType</link> scroll_type,
                                                        <link linkend="gfloat">gfloat</link>        position,
                                                        <link linkend="gpointer">gpointer</link>      user_data)        : Run Last / Action</programlisting>
<para>
This signal is emitted when the CList is scrolled vertically.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>scroll_type</parameter>&#160;:</term>
<listitem><simpara>A <link linkend="GtkScrollType"><type>GtkScrollType</type></link> value of how the scroll operation occured.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara>A value between 0.0 and 1.0.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-select-all" role="signal"><title>The <literal>&quot;select-all&quot;</literal> signal</title>
<indexterm zone="GtkCList-select-all"><primary sortas="CList::select-all">GtkCList::select-all</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                        <link linkend="gpointer">gpointer</link>  user_data)      : Run Last / Action</programlisting>
<para>
This signal is emitted when all the rows are selected in a CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-select-row" role="signal"><title>The <literal>&quot;select-row&quot;</literal> signal</title>
<indexterm zone="GtkCList-select-row"><primary sortas="CList::select-row">GtkCList::select-row</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link>       *clist,
                                                        <link linkend="gint">gint</link>            row,
                                                        <link linkend="gint">gint</link>            column,
                                                        <link linkend="GdkEventButton">GdkEventButton</link> *event,
                                                        <link linkend="gpointer">gpointer</link>        user_data)      : Run First</programlisting>
<para>
This signal is emitted when the user selects a row in the list.
It is emitted for every row that is selected in a multi-selection or
by calling <link linkend="gtk-clist-select-all"><function>gtk_clist_select_all()</function></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The row selected.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column where the selection occured.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>event</parameter>&#160;:</term>
<listitem><simpara>A <link linkend="GdkEvent"><type>GdkEvent</type></link> structure for the selection.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-set-scroll-adjustments" role="signal"><title>The <literal>&quot;set-scroll-adjustments&quot;</literal> signal</title>
<indexterm zone="GtkCList-set-scroll-adjustments"><primary sortas="CList::set-scroll-adjustments">GtkCList::set-scroll-adjustments</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link>      *clist,
                                                        <link linkend="GtkAdjustment">GtkAdjustment</link> *arg1,
                                                        <link linkend="GtkAdjustment">GtkAdjustment</link> *arg2,
                                                        <link linkend="gpointer">gpointer</link>       user_data)      : Run Last</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg2</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-start-selection" role="signal"><title>The <literal>&quot;start-selection&quot;</literal> signal</title>
<indexterm zone="GtkCList-start-selection"><primary sortas="CList::start-selection">GtkCList::start-selection</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                        <link linkend="gpointer">gpointer</link>  user_data)      : Run Last / Action</programlisting>
<para>
This signal is emitted when a drag-selection is started in
a multiple-selection CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-toggle-add-mode" role="signal"><title>The <literal>&quot;toggle-add-mode&quot;</literal> signal</title>
<indexterm zone="GtkCList-toggle-add-mode"><primary sortas="CList::toggle-add-mode">GtkCList::toggle-add-mode</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                        <link linkend="gpointer">gpointer</link>  user_data)      : Run Last / Action</programlisting>
<para>
This signal is emitted when "add mode" is toggled.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-toggle-focus-row" role="signal"><title>The <literal>&quot;toggle-focus-row&quot;</literal> signal</title>
<indexterm zone="GtkCList-toggle-focus-row"><primary sortas="CList::toggle-focus-row">GtkCList::toggle-focus-row</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                        <link linkend="gpointer">gpointer</link>  user_data)      : Run Last / Action</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-undo-selection" role="signal"><title>The <literal>&quot;undo-selection&quot;</literal> signal</title>
<indexterm zone="GtkCList-undo-selection"><primary sortas="CList::undo-selection">GtkCList::undo-selection</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                        <link linkend="gpointer">gpointer</link>  user_data)      : Run Last / Action</programlisting>
<para>
This signal is emitted when an undo selection occurs in the CList,
probably via calling <link linkend="gtk-clist-undo-selection"><function>gtk_clist_undo_selection()</function></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-unselect-all" role="signal"><title>The <literal>&quot;unselect-all&quot;</literal> signal</title>
<indexterm zone="GtkCList-unselect-all"><primary sortas="CList::unselect-all">GtkCList::unselect-all</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link> *clist,
                                                        <link linkend="gpointer">gpointer</link>  user_data)      : Run Last / Action</programlisting>
<para>
This signal is emitted when all rows are unselected in a CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkCList-unselect-row" role="signal"><title>The <literal>&quot;unselect-row&quot;</literal> signal</title>
<indexterm zone="GtkCList-unselect-row"><primary sortas="CList::unselect-row">GtkCList::unselect-row</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkCList">GtkCList</link>       *clist,
                                                        <link linkend="gint">gint</link>            row,
                                                        <link linkend="gint">gint</link>            column,
                                                        <link linkend="GdkEventButton">GdkEventButton</link> *event,
                                                        <link linkend="gpointer">gpointer</link>        user_data)      : Run First</programlisting>
<para>
This signal is emitted when the user unselects a row in the list.
It is emitted for every row that is unselected in a multi-selection or
by calling <link linkend="gtk-clist-unselect-all"><function>gtk_clist_unselect_all()</function></link>.  It is also emitted for the
previously selected row in a "single" or "browse" mode CList.
</para><variablelist role="params">
<varlistentry><term><parameter>clist</parameter>&#160;:</term>
<listitem><simpara>The object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>row</parameter>&#160;:</term>
<listitem><simpara>The selected row
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>column</parameter>&#160;:</term>
<listitem><simpara>The column where the selection occured.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>event</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>
