<refentry id="GtkCList">
<refmeta>
<refentrytitle>GtkCList</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

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

<refsynopsisdiv><title>Synopsis</title>
<synopsis>

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


struct      <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);
struct      <link linkend="GtkCListColumn">GtkCListColumn</link>;
struct      <link linkend="GtkCListRow">GtkCListRow</link>;
struct      <link linkend="GtkCellText">GtkCellText</link>;
struct      <link linkend="GtkCellPixmap">GtkCellPixmap</link>;
struct      <link linkend="GtkCellPixText">GtkCellPixText</link>;
struct      <link linkend="GtkCellWidget">GtkCellWidget</link>;
struct      <link linkend="GtkCell">GtkCell</link>;
struct      <link linkend="GtkCListCellInfo">GtkCListCellInfo</link>;
struct      <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[]);
void        <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);
void        <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);
void        <link linkend="gtk-clist-freeze">gtk_clist_freeze</link>                (<link linkend="GtkCList">GtkCList</link> *clist);
void        <link linkend="gtk-clist-thaw">gtk_clist_thaw</link>                  (<link linkend="GtkCList">GtkCList</link> *clist);
void        <link linkend="gtk-clist-column-titles-show">gtk_clist_column_titles_show</link>    (<link linkend="GtkCList">GtkCList</link> *clist);
void        <link linkend="gtk-clist-column-titles-hide">gtk_clist_column_titles_hide</link>    (<link linkend="GtkCList">GtkCList</link> *clist);
void        <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);
void        <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);
void        <link linkend="gtk-clist-column-titles-active">gtk_clist_column_titles_active</link>  (<link linkend="GtkCList">GtkCList</link> *clist);
void        <link linkend="gtk-clist-column-titles-passive">gtk_clist_column_titles_passive</link> (<link linkend="GtkCList">GtkCList</link> *clist);
void        <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);
void        <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);
void        <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);
void        <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);
void        <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);
void        <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);
void        <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);
void        <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);
void        <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);
void        <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);
void        <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);
void        <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);
void        <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);
void        <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);
void        <link linkend="gtk-clist-set-foreground">gtk_clist_set_foreground</link>        (<link linkend="GtkCList">GtkCList</link> *clist,
                                             <link linkend="gint">gint</link> row,
                                             <link linkend="GdkColor">GdkColor</link> *color);
void        <link linkend="gtk-clist-set-background">gtk_clist_set_background</link>        (<link linkend="GtkCList">GtkCList</link> *clist,
                                             <link linkend="gint">gint</link> row,
                                             <link linkend="GdkColor">GdkColor</link> *color);
void        <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);
void        <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);
void        <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);
void        <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[]);
void        <link linkend="gtk-clist-remove">gtk_clist_remove</link>                (<link linkend="GtkCList">GtkCList</link> *clist,
                                             <link linkend="gint">gint</link> row);
void        <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);
void        <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="GtkDestroyNotify">GtkDestroyNotify</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);
void        <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);
void        <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);
void        <link linkend="gtk-clist-undo-selection">gtk_clist_undo_selection</link>        (<link linkend="GtkCList">GtkCList</link> *clist);
void        <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);
void        <link linkend="gtk-clist-select-all">gtk_clist_select_all</link>            (<link linkend="GtkCList">GtkCList</link> *clist);
void        <link linkend="gtk-clist-unselect-all">gtk_clist_unselect_all</link>          (<link linkend="GtkCList">GtkCList</link> *clist);
void        <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);
void        <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);
void        <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);
void        <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);
void        <link linkend="gtk-clist-sort">gtk_clist_sort</link>                  (<link linkend="GtkCList">GtkCList</link> *clist);
void        <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);
void        <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);
void        <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);
void        <link linkend="gtk-clist-set-hadjustment">gtk_clist_set_hadjustment</link>       (<link linkend="GtkCList">GtkCList</link> *clist,
                                             <link linkend="GtkAdjustment">GtkAdjustment</link> *adjustment);
void        <link linkend="gtk-clist-set-reorderable">gtk_clist_set_reorderable</link>       (<link linkend="GtkCList">GtkCList</link> *clist,
                                             <link linkend="gboolean">gboolean</link> reorderable);
void        <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);
void        <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>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GObject">GObject</link>
   +----<link linkend="GtkObject">GtkObject</link>
         +----<link linkend="GtkWidget">GtkWidget</link>
               +----<link linkend="GtkContainer">GtkContainer</link>
                     +----GtkCList
</synopsis>

</refsect1>

<refsect1>
<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--shadow-type">shadow-type</link>&quot;          <link linkend="GtkShadowType">GtkShadowType</link>        : Read / Write
  &quot;<link linkend="GtkCList--selection-mode">selection-mode</link>&quot;       <link linkend="GtkSelectionMode">GtkSelectionMode</link>     : Read / Write
  &quot;<link linkend="GtkCList--row-height">row-height</link>&quot;           <link linkend="guint">guint</link>                : Read / Write
  &quot;<link linkend="GtkCList--titles-active">titles-active</link>&quot;        <link linkend="gboolean">gboolean</link>             : Read / Write
  &quot;<link linkend="GtkCList--reorderable">reorderable</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
  &quot;<link linkend="GtkCList--sort-type">sort-type</link>&quot;            <link linkend="GtkSortType">GtkSortType</link>          : Read / Write
</synopsis>
</refsect1>

<refsect1>
<title>Signal Prototypes</title>
<synopsis>

&quot;<link linkend="GtkCList-abort-column-resize">abort-column-resize</link>&quot;
            void        user_function      (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkCList-click-column">click-column</link>&quot;
            void        user_function      (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gint">gint</link> column,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkCList-end-selection">end-selection</link>&quot;
            void        user_function      (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkCList-extend-selection">extend-selection</link>&quot;
            void        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);
&quot;<link linkend="GtkCList-resize-column">resize-column</link>&quot;
            void        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);
&quot;<link linkend="GtkCList-row-move">row-move</link>&quot;  void        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);
&quot;<link linkend="GtkCList-scroll-horizontal">scroll-horizontal</link>&quot;
            void        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);
&quot;<link linkend="GtkCList-scroll-vertical">scroll-vertical</link>&quot;
            void        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);
&quot;<link linkend="GtkCList-select-all">select-all</link>&quot;
            void        user_function      (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkCList-select-row">select-row</link>&quot;
            void        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);
&quot;<link linkend="GtkCList-set-scroll-adjustments">set-scroll-adjustments</link>&quot;
            void        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);
&quot;<link linkend="GtkCList-start-selection">start-selection</link>&quot;
            void        user_function      (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkCList-toggle-add-mode">toggle-add-mode</link>&quot;
            void        user_function      (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkCList-toggle-focus-row">toggle-focus-row</link>&quot;
            void        user_function      (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkCList-undo-selection">undo-selection</link>&quot;
            void        user_function      (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkCList-unselect-all">unselect-all</link>&quot;
            void        user_function      (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkCList-unselect-row">unselect-row</link>&quot;
            void        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);
</synopsis>
</refsect1>


<refsect1>
<title>Description</title>
<para>
The <link linkend="GtkCList">GtkCList</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>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GtkCList-struct">struct GtkCList</title>
<programlisting>struct 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">GtkCList</link> widget.  This structure contains
only private data, and should be accessed only via the CList API.
</para></refsect2>
<refsect2>
<title><anchor id="GtkCellType">enum GtkCellType</title>
<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 <literal>GTK_CELL_WIDGET</literal>
was never completed.
</para></refsect2>
<refsect2>
<title><anchor id="GtkButtonAction">enum GtkButtonAction</title>
<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>
<title><anchor id="GTK-CLIST-FLAGS-CAPS">GTK_CLIST_FLAGS()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> widget from which to get the flags


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-SET-FLAG-CAPS">GTK_CLIST_SET_FLAG()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> widget to affect.
</entry></row>
<row><entry align="right"><parameter>flag</parameter>&nbsp;:</entry>
<entry>A single <link linkend="GtkCList">GtkCList</link> flag to set.  NOTE: Do not add the GTK_ prefix.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-UNSET-FLAG-CAPS">GTK_CLIST_UNSET_FLAG()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> widget to affect.
</entry></row>
<row><entry align="right"><parameter>flag</parameter>&nbsp;:</entry>
<entry>A single <link linkend="GtkCList">GtkCList</link> flag to clear.  NOTE: Do not add the GTK_ prefix.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-IN-DRAG-CAPS">GTK_CLIST_IN_DRAG()</title>
<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">GtkCList</link> is in "drag mode."
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to check.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-ROW-HEIGHT-SET-CAPS">GTK_CLIST_ROW_HEIGHT_SET()</title>
<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">GtkCList</link>'s row height is set.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to check.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-SHOW-TITLES-CAPS">GTK_CLIST_SHOW_TITLES()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> widget to check.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-ADD-MODE-CAPS">GTK_CLIST_ADD_MODE()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> widget to check.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-AUTO-SORT-CAPS">GTK_CLIST_AUTO_SORT()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> widget to check.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-AUTO-RESIZE-BLOCKED-CAPS">GTK_CLIST_AUTO_RESIZE_BLOCKED()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> widget to check.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-REORDERABLE-CAPS">GTK_CLIST_REORDERABLE()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> widget to check.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-USE-DRAG-ICONS-CAPS">GTK_CLIST_USE_DRAG_ICONS()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> widget to check.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-DRAW-DRAG-LINE-CAPS">GTK_CLIST_DRAW_DRAG_LINE()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> widget to check.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-DRAW-DRAG-RECT-CAPS">GTK_CLIST_DRAW_DRAG_RECT()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> widget to check.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CLIST-ROW-CAPS">GTK_CLIST_ROW()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>_glist_</parameter>&nbsp;:</entry>
<entry>The GList element to convert.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CELL-TEXT-CAPS">GTK_CELL_TEXT()</title>
<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">GtkCList</link> cell item to a GtkCellText pointer.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>cell</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> cell item to convert.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CELL-PIXMAP-CAPS">GTK_CELL_PIXMAP()</title>
<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">GtkCList</link> cell item to a GtkCellPixmap pointer.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>cell</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> cell item to convert.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CELL-PIXTEXT-CAPS">GTK_CELL_PIXTEXT()</title>
<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">GtkCList</link> cell item to a GtkCellPixText pointer.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>cell</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> cell item to convert.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GTK-CELL-WIDGET-CAPS">GTK_CELL_WIDGET()</title>
<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">GtkCList</link> cell item to a GtkCellWidget pointer.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>cell</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> cell item to convert.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GtkCListCompareFunc">GtkCListCompareFunc ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> that is affected.
</entry></row>
<row><entry align="right"><parameter>ptr1</parameter>&nbsp;:</entry>
<entry>A <link linkend="gconstpointer">gconstpointer</link> to the first node to compare.
</entry></row>
<row><entry align="right"><parameter>ptr2</parameter>&nbsp;:</entry>
<entry>A <link linkend="gconstpointer">gconstpointer</link> to the second node to compare.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>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.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GtkCListColumn">struct GtkCListColumn</title>
<programlisting>struct GtkCListColumn
{
  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;
};
</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">GtkCList</link> widget uses to keep track of information
about its columns.
</para></refsect2>
<refsect2>
<title><anchor id="GtkCListRow">struct GtkCListRow</title>
<programlisting>struct GtkCListRow
{
  GtkCell *cell;
  GtkStateType state;
  
  GdkColor foreground;
  GdkColor background;
  
  GtkStyle *style;

  gpointer data;
  GtkDestroyNotify destroy;
  
  guint fg_set     : 1;
  guint bg_set     : 1;
  guint selectable : 1;
};
</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">GtkCList</link> widget uses to keep track of information
about its rows.
</para></refsect2>
<refsect2>
<title><anchor id="GtkCellText">struct GtkCellText</title>
<programlisting>struct GtkCellText
{
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  gchar *text;
};
</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">GtkCList</link> widget uses to keep track of <link linkend="GtkCList">GtkCList</link> cells
that contain text.
</para></refsect2>
<refsect2>
<title><anchor id="GtkCellPixmap">struct GtkCellPixmap</title>
<programlisting>struct GtkCellPixmap
{
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  GdkPixmap *pixmap;
  GdkBitmap *mask;
};
</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">GtkCList</link> widget uses to keep track of <link linkend="GtkCList">GtkCList</link> cells
that contain a GdkPixmap.
</para></refsect2>
<refsect2>
<title><anchor id="GtkCellPixText">struct GtkCellPixText</title>
<programlisting>struct GtkCellPixText
{
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  gchar *text;
  guint8 spacing;
  GdkPixmap *pixmap;
  GdkBitmap *mask;
};
</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">GtkCList</link> widget uses to keep track of <link linkend="GtkCList">GtkCList</link> cells
that contain a combination of text and a GdkPixmap.
</para></refsect2>
<refsect2>
<title><anchor id="GtkCellWidget">struct GtkCellWidget</title>
<programlisting>struct GtkCellWidget
{
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  GtkWidget *widget;
};
</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">GtkCList</link> widget uses to keep track of <link linkend="GtkCList">GtkCList</link> cells
that contain another widget.
</para></refsect2>
<refsect2>
<title><anchor id="GtkCell">struct GtkCell</title>
<programlisting>struct GtkCell
{
  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;
};
</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">GtkCList</link> widget uses to keep track of the
contents of each of its cells.
</para></refsect2>
<refsect2>
<title><anchor id="GtkCListCellInfo">struct GtkCListCellInfo</title>
<programlisting>struct GtkCListCellInfo
{
  gint row;
  gint column;
};
</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">GtkCList</link> widget uses to keep track
of the location of a cell.
</para></refsect2>
<refsect2>
<title><anchor id="GtkCListDestInfo">struct GtkCListDestInfo</title>
<programlisting>struct GtkCListDestInfo
{
  GtkCListCellInfo cell;
  GtkCListDragPos  insert_pos;
};
</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">GtkCList</link> widget uses to track 
a cell for a drag operation.
</para></refsect2>
<refsect2>
<title><anchor id="GtkCListDragPos">enum GtkCListDragPos</title>
<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>
<title><anchor id="gtk-clist-new">gtk_clist_new ()</title>
<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">GtkCList</link> widget for use.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>columns</parameter>&nbsp;:</entry>
<entry>The number of columns the <link linkend="GtkCList">GtkCList</link> should have.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>A pointer to a new GtkCList object.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-new-with-titles">gtk_clist_new_with_titles ()</title>
<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">GtkCList</link> widget with column titles for use.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>columns</parameter>&nbsp;:</entry>
<entry>The number of columns the <link linkend="GtkCList">GtkCList</link> should have.
</entry></row>
<row><entry align="right"><parameter>titles</parameter>&nbsp;:</entry>
<entry>A string array of titles for the widget.  There should be
enough strings in the array for the specified number of columns.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>A pointer to a new GtkCList object.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-shadow-type">gtk_clist_set_shadow_type ()</title>
<programlisting>void        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">GtkCList</link> to update its visuals.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>type</parameter>&nbsp;:</entry>
<entry>The GtkShadowType desired.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-selection-mode">gtk_clist_set_selection_mode ()</title>
<programlisting>void        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">GtkCList</link> to become deselected.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>mode</parameter>&nbsp;:</entry>
<entry>The GtkSelectionMode type to set for this CList.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-freeze">gtk_clist_freeze ()</title>
<programlisting>void        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">GtkCList</link> to stop updating its visuals until a matching call to
<link linkend="gtk-clist-thaw">gtk_clist_thaw</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">gtk_clist_freeze</link>() can be nested.  
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to freeze.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-thaw">gtk_clist_thaw ()</title>
<programlisting>void        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">GtkCList</link> to allow visual updates.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to thaw.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-column-titles-show">gtk_clist_column_titles_show ()</title>
<programlisting>void        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">GtkCList</link> to show its column titles, if
they are not already showing.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-column-titles-hide">gtk_clist_column_titles_hide ()</title>
<programlisting>void        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">GtkCList</link> to hide its column titles, if they are currently
showing.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-column-title-active">gtk_clist_column_title_active ()</title>
<programlisting>void        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">GtkCList</link> to become selectable.  You can
then respond to events from the user clicking on a title button, and take
appropriate action.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to make active, counting from 0.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-column-title-passive">gtk_clist_column_title_passive ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to make passive, counting from 0.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-column-titles-active">gtk_clist_column_titles_active ()</title>
<programlisting>void        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">gtk_clist_column_title_active</link>() for each column.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-column-titles-passive">gtk_clist_column_titles_passive ()</title>
<programlisting>void        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">gtk_clist_column_title_passive</link>() for each column.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-column-title">gtk_clist_set_column_title ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column whose title should be changed.
</entry></row>
<row><entry align="right"><parameter>title</parameter>&nbsp;:</entry>
<entry>A string to be the column's title.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-column-widget">gtk_clist_set_column_widget ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column whose title should be a widget.
</entry></row>
<row><entry align="right"><parameter>widget</parameter>&nbsp;:</entry>
<entry>A pointer to a previously create widget.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-column-justification">gtk_clist_set_column_justification ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column which should be affected.
</entry></row>
<row><entry align="right"><parameter>justification</parameter>&nbsp;:</entry>
<entry>A GtkJustification value for the column.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-column-visibility">gtk_clist_set_column_visibility ()</title>
<programlisting>void        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">GtkCList</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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to set visibility.
</entry></row>
<row><entry align="right"><parameter>visible</parameter>&nbsp;:</entry>
<entry><literal>TRUE</literal> or <literal>FALSE</literal>.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-column-resizeable">gtk_clist_set_column_resizeable ()</title>
<programlisting>void        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">gtk_clist_set_column_auto_resize</link>().
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column on which to set resizeability.
</entry></row>
<row><entry align="right"><parameter>resizeable</parameter>&nbsp;:</entry>
<entry><literal>TRUE</literal> or <literal>FALSE</literal>.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-column-auto-resize">gtk_clist_set_column_auto_resize ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column on which to set auto-resizing.
</entry></row>
<row><entry align="right"><parameter>auto_resize</parameter>&nbsp;:</entry>
<entry><literal>TRUE</literal> or <literal>FALSE</literal>.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-optimal-column-width">gtk_clist_optimal_column_width ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to check.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to check.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>The required width in pixels for the column.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-column-width">gtk_clist_set_column_width ()</title>
<programlisting>void        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">GtkCList</link> to be set to
a specified width.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to set the width.
</entry></row>
<row><entry align="right"><parameter>width</parameter>&nbsp;:</entry>
<entry>The width, in pixels.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-column-min-width">gtk_clist_set_column_min_width ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to set the minimum width.
</entry></row>
<row><entry align="right"><parameter>min_width</parameter>&nbsp;:</entry>
<entry>The width, in pixels.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-column-max-width">gtk_clist_set_column_max_width ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to set the maximum width.
</entry></row>
<row><entry align="right"><parameter>max_width</parameter>&nbsp;:</entry>
<entry>The width, in pixels.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-row-height">gtk_clist_set_row_height ()</title>
<programlisting>void        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">GtkCList</link> to have a specified height for its 
rows.  Setting the row height to 0 allows the <link linkend="GtkCList">GtkCList</link> to adjust
automatically to data in the row.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>height</parameter>&nbsp;:</entry>
<entry>The height, in pixels.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-moveto">gtk_clist_moveto ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to which to move.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to which to move.
</entry></row>
<row><entry align="right"><parameter>row_align</parameter>&nbsp;:</entry>
<entry>A value between 0 and 1 that describes the positioning of 
the row in relation to the viewable area of the CList's contents.
</entry></row>
<row><entry align="right"><parameter>col_align</parameter>&nbsp;:</entry>
<entry>A value between 0 and 1 that describes the positioning of 
the column in relation to the viewable area of the CList's contents.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-row-is-visible">gtk_clist_row_is_visible ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to query.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>A <link linkend="GtkVisibility">GtkVisibility</link> value that tells you how the row is visible.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-cell-type">gtk_clist_get_cell_type ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row of the cell.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column of the cell.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>A <link linkend="GtkCellType">GtkCellType</link> value describing the cell.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-text">gtk_clist_set_text ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row of the cell.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column of the cell.
</entry></row>
<row><entry align="right"><parameter>text</parameter>&nbsp;:</entry>
<entry>The text to set in the cell.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-text">gtk_clist_get_text ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to query.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to query.
</entry></row>
<row><entry align="right"><parameter>text</parameter>&nbsp;:</entry>
<entry>A pointer to a pointer to store the text.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>1 if the cell's text could be retrieved, 0 otherwise.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-pixmap">gtk_clist_set_pixmap ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row of the cell.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column of the cell.
</entry></row>
<row><entry align="right"><parameter>pixmap</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="GdkPixmap">GdkPixmap</link> to place in the cell.
</entry></row>
<row><entry align="right"><parameter>mask</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="GdkBitmap">GdkBitmap</link> mask for the cell.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-pixmap">gtk_clist_get_pixmap ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row of the cell.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column of the cell.
</entry></row>
<row><entry align="right"><parameter>pixmap</parameter>&nbsp;:</entry>
<entry>A pointer to a pointer to store the cell's <link linkend="GdkPixmap">GdkPixmap</link>.
</entry></row>
<row><entry align="right"><parameter>mask</parameter>&nbsp;:</entry>
<entry>A pointer to a pointer to store the cell's <link linkend="GdkBitmap">GdkBitmap</link> mask.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>1 if the cell's pixmap could be retrieved, 0 otherwise.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-pixtext">gtk_clist_set_pixtext ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row of the cell.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column of the cell.
</entry></row>
<row><entry align="right"><parameter>text</parameter>&nbsp;:</entry>
<entry>The text to set in the cell.
</entry></row>
<row><entry align="right"><parameter>spacing</parameter>&nbsp;:</entry>
<entry>The spacing between the cell's text and pixmap.
</entry></row>
<row><entry align="right"><parameter>pixmap</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="GdkPixmap">GdkPixmap</link> for the cell.
</entry></row>
<row><entry align="right"><parameter>mask</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="GdkBitmap">GdkBitmap</link> mask for the cell.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-pixtext">gtk_clist_get_pixtext ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to query.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to query.
</entry></row>
<row><entry align="right"><parameter>text</parameter>&nbsp;:</entry>
<entry>A pointer to a pointer to store the text.
</entry></row>
<row><entry align="right"><parameter>spacing</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="guint8">guint8</link> to store the spacing.
</entry></row>
<row><entry align="right"><parameter>pixmap</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="GdkPixmap">GdkPixmap</link> pointer to store the cell's pixmap.
</entry></row>
<row><entry align="right"><parameter>mask</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="GdkBitmap">GdkBitmap</link> pointer to store the cell's bitmap mask.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>1 if the retrieval was successful, 0 otherwise.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-foreground">gtk_clist_set_foreground ()</title>
<programlisting>void        gtk_clist_set_foreground        (<link linkend="GtkCList">GtkCList</link> *clist,
                                             <link linkend="gint">gint</link> row,
                                             <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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to affect.
</entry></row>
<row><entry align="right"><parameter>color</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="GdkColor">GdkColor</link> structure.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-background">gtk_clist_set_background ()</title>
<programlisting>void        gtk_clist_set_background        (<link linkend="GtkCList">GtkCList</link> *clist,
                                             <link linkend="gint">gint</link> row,
                                             <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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to affect.
</entry></row>
<row><entry align="right"><parameter>color</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="GdkColor">GdkColor</link> structure.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-cell-style">gtk_clist_set_cell_style ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row of the cell.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column of the cell.
</entry></row>
<row><entry align="right"><parameter>style</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="GtkStyle">GtkStyle</link> structure.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-cell-style">gtk_clist_get_cell_style ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row of the cell.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column of the cell.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>A <link linkend="GtkStyle">GtkStyle</link> object.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-row-style">gtk_clist_set_row_style ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to affect.
</entry></row>
<row><entry align="right"><parameter>style</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="GtkStyle">GtkStyle</link> to set.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-row-style">gtk_clist_get_row_style ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to query.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>The <link linkend="GtkStyle">GtkStyle</link> of the row.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-shift">gtk_clist_set_shift ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row of the cell.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column of the cell.
</entry></row>
<row><entry align="right"><parameter>vertical</parameter>&nbsp;:</entry>
<entry>The value to set for the vertical shift.
</entry></row>
<row><entry align="right"><parameter>horizontal</parameter>&nbsp;:</entry>
<entry>The value to set for the vertical shift.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-selectable">gtk_clist_set_selectable ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to affect.
</entry></row>
<row><entry align="right"><parameter>selectable</parameter>&nbsp;:</entry>
<entry><literal>TRUE</literal> or <literal>FALSE</literal>.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-selectable">gtk_clist_get_selectable ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to query.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>A <link linkend="gboolean">gboolean</link> value.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-prepend">gtk_clist_prepend ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>text</parameter>&nbsp;:</entry>
<entry>An array of strings to add.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>The number of the row added.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-append">gtk_clist_append ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>text</parameter>&nbsp;:</entry>
<entry>An array of strings to add.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>The number of the row added.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-insert">gtk_clist_insert ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row where the text should be inserted.
</entry></row>
<row><entry align="right"><parameter>text</parameter>&nbsp;:</entry>
<entry>An array of string to add.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>The number of the row added.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-remove">gtk_clist_remove ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to remove.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-row-data">gtk_clist_set_row_data ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to affect.
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry>The data to set for the row.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-row-data-full">gtk_clist_set_row_data_full ()</title>
<programlisting>void        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="GtkDestroyNotify">GtkDestroyNotify</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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to affect.
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry>The data to set for the row.
</entry></row>
<row><entry align="right"><parameter>destroy</parameter>&nbsp;:</entry>
<entry>A <link linkend="GtkDestroyNotify">GtkDestroyNotify</link> function to be called when the row is destroyed.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-row-data">gtk_clist_get_row_data ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to query.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>The data set for the row.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-find-row-from-data">gtk_clist_find_row_from_data ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to search.
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry>The data to search for a match.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>The number of the matching row, or -1 if no match could be found.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-select-row">gtk_clist_select_row ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to select.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to select.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-unselect-row">gtk_clist_unselect_row ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row to select.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to select.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-undo-selection">gtk_clist_undo_selection ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-clear">gtk_clist_clear ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-selection-info">gtk_clist_get_selection_info ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>x</parameter>&nbsp;:</entry>
<entry>The horizontal pixel position to check.
</entry></row>
<row><entry align="right"><parameter>y</parameter>&nbsp;:</entry>
<entry>The vertical pixel position to check..
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>Pointer to a <link linkend="gint">gint</link> to store the row value.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>Pointer to a <link linkend="gint">gint</link> to store the column value.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>1 if row/column is returned and in range, 0 otherwise.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-select-all">gtk_clist_select_all ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-unselect-all">gtk_clist_unselect_all ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-swap-rows">gtk_clist_swap_rows ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>row1</parameter>&nbsp;:</entry>
<entry>Number of the first row.
</entry></row>
<row><entry align="right"><parameter>row2</parameter>&nbsp;:</entry>
<entry>Number of the second row.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-compare-func">gtk_clist_set_compare_func ()</title>
<programlisting>void        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">GtkClist</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">gtk_clist_set_sort_type</link>() by the column set
by <link linkend="gtk-clist-set-sort-column">gtk_clist_set_sort_column</link>().
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>cmp_func</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCompareFunction">GtkCompareFunction</link> to use.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-sort-column">gtk_clist_set_sort_column ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to sort by


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-sort-type">gtk_clist_set_sort_type ()</title>
<programlisting>void        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">GtkClist</link>. This is either GTK_SORT_ASCENDING for
ascening sort or GTK_SORT_DESCENDING for descending sort.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>sort_type</parameter>&nbsp;:</entry>
<entry>the <link linkend="GtkSortType">GtkSortType</link> to use


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-sort">gtk_clist_sort ()</title>
<programlisting>void        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">GtkClist</link> according to the current compare function, which
can be set with the <link linkend="gtk-clist-set-compare-func">gtk_clist_set_compare_func</link>() function.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to sort.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-auto-sort">gtk_clist_set_auto_sort ()</title>
<programlisting>void        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">GtkCList</link>. If auto sort is on, then the CList will be resorted when a row is inserted into the CList.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>auto_sort</parameter>&nbsp;:</entry>
<entry>whether auto sort should be on or off


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-columns-autosize">gtk_clist_columns_autosize ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>The total width of the CList.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-column-title">gtk_clist_get_column_title ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to query.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>The title of the column.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-column-widget">gtk_clist_get_column_widget ()</title>
<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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column to query.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>Pointer to a <link linkend="GtkWidget">GtkWidget</link> for the column header.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-hadjustment">gtk_clist_get_hadjustment ()</title>
<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">GtkAdjustment</link> currently being used for the horizontal
aspect.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to check.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>A <link linkend="GtkAdjustment">GtkAdjustment</link> object, or NULL if none is currently
being used.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-get-vadjustment">gtk_clist_get_vadjustment ()</title>
<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">GtkAdjustment</link> currently being used for the vertical
aspect.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to check.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>A <link linkend="GtkAdjustment">GtkAdjustment</link> object, or NULL if none is currently
being used.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-row-move">gtk_clist_row_move ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>source_row</parameter>&nbsp;:</entry>
<entry>The original position of the row to move.
</entry></row>
<row><entry align="right"><parameter>dest_row</parameter>&nbsp;:</entry>
<entry>The position to which the row should be moved.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-button-actions">gtk_clist_set_button_actions ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>button</parameter>&nbsp;:</entry>
<entry>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.
</entry></row>
<row><entry align="right"><parameter>button_actions</parameter>&nbsp;:</entry>
<entry>A logically OR'd value of <link linkend="GtkButtonAction">GtkButtonAction</link> values 
for the button.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-hadjustment">gtk_clist_set_hadjustment ()</title>
<programlisting>void        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">GtkAdjustment</link> to be used for the horizontal
aspect of the <link linkend="GtkCList">GtkCList</link> widget.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>adjustment</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="GtkAdjustment">GtkAdjustment</link> widget, or NULL.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-reorderable">gtk_clist_set_reorderable ()</title>
<programlisting>void        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><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>reorderable</parameter>&nbsp;:</entry>
<entry><literal>TRUE</literal> or <literal>FALSE</literal>.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-use-drag-icons">gtk_clist_set_use_drag_icons ()</title>
<programlisting>void        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">GtkClist</link> should use icons when
doing drag-and-drop operations.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>use_icons</parameter>&nbsp;:</entry>
<entry><literal>TRUE</literal> or <literal>FALSE</literal>.


</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gtk-clist-set-vadjustment">gtk_clist_set_vadjustment ()</title>
<programlisting>void        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">GtkAdjustment</link> to be used for the vertical
aspect of the <link linkend="GtkCList">GtkCList</link> widget.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The <link linkend="GtkCList">GtkCList</link> to affect.
</entry></row>
<row><entry align="right"><parameter>adjustment</parameter>&nbsp;:</entry>
<entry>A pointer to a <link linkend="GtkAdjustment">GtkAdjustment</link> widget, or NULL.


</entry></row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>
<refsect1>
<title>Properties</title>
<variablelist>
<varlistentry><term><anchor id="GtkCList--n-columns">&quot;<literal>n-columns</literal>&quot; (<link linkend="guint">guint</link> : Read / Write / Construct Only)</term>
<listitem>
<para>
An integer value for a column.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkCList--shadow-type">&quot;<literal>shadow-type</literal>&quot; (<link linkend="GtkShadowType">GtkShadowType</link> : Read / Write)</term>
<listitem>
<para>
Sets the shadowing for the CList.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkCList--selection-mode">&quot;<literal>selection-mode</literal>&quot; (<link linkend="GtkSelectionMode">GtkSelectionMode</link> : Read / Write)</term>
<listitem>
<para>
Sets the type of selection mode for the CList.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkCList--row-height">&quot;<literal>row-height</literal>&quot; (<link linkend="guint">guint</link> : Read / Write)</term>
<listitem>
<para>
An integer value representing the height of a row in pixels.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkCList--titles-active">&quot;<literal>titles-active</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
A boolean value for setting whether the column titles can be
clicked.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkCList--reorderable">&quot;<literal>reorderable</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
A boolean value for determining if the user can re-order the CList's
columns.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkCList--use-drag-icons">&quot;<literal>use-drag-icons</literal>&quot; (<link linkend="gboolean">gboolean</link> : Read / Write)</term>
<listitem>
<para>
A boolean value for setting whether to use icons during drag
operations.
</para></listitem></varlistentry>
<varlistentry><term><anchor id="GtkCList--sort-type">&quot;<literal>sort-type</literal>&quot; (<link linkend="GtkSortType">GtkSortType</link> : Read / Write)</term>
<listitem>
<para>

</para></listitem></varlistentry>

</variablelist>
</refsect1>

<refsect1>
<title>Signals</title>
<refsect2><title><anchor id="GtkCList-abort-column-resize">The &quot;abort-column-resize&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
This signal is emitted when a column resize is aborted.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>the object which received the signal.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-click-column">The &quot;click-column&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gint">gint</link> column,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
This signal is emitted when a column title is clicked.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The object which received the signal.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The number of the column.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-end-selection">The &quot;end-selection&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
This signal is emitted when a selection ends in a 
multiple selection CList.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>the object which received the signal.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-extend-selection">The &quot;extend-selection&quot; signal</title>
<programlisting>void        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);</programlisting>
<para>
This signal is emitted when the selection is extended.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>the object which received the signal.
</entry></row>
<row><entry align="right"><parameter>scroll_type</parameter>&nbsp;:</entry>
<entry>A <link linkend="GtkScrollType">GtkScrollType</link> value of any scrolling operation the
occured during the selection.
</entry></row>
<row><entry align="right"><parameter>position</parameter>&nbsp;:</entry>
<entry>A value between 0.0 and 1.0.
</entry></row>
<row><entry align="right"><parameter>auto_start_selection</parameter>&nbsp;:</entry>
<entry><literal>TRUE</literal> or <literal>FALSE</literal>.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-resize-column">The &quot;resize-column&quot; signal</title>
<programlisting>void        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);</programlisting>
<para>
This signal is emitted when a column is resized.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The object which received the signal.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The number of the column
</entry></row>
<row><entry align="right"><parameter>width</parameter>&nbsp;:</entry>
<entry>The new width of the column.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-row-move">The &quot;row-move&quot; signal</title>
<programlisting>void        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);</programlisting>
<para>
This signal is emitted when a row is moved.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The object which received the signal.
</entry></row>
<row><entry align="right"><parameter>arg1</parameter>&nbsp;:</entry>
<entry>The source position of the row.
</entry></row>
<row><entry align="right"><parameter>arg2</parameter>&nbsp;:</entry>
<entry>The destination position of the row.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-scroll-horizontal">The &quot;scroll-horizontal&quot; signal</title>
<programlisting>void        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);</programlisting>
<para>
This signal is emitted when the CList is scrolled horizontally.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>the object which received the signal.
</entry></row>
<row><entry align="right"><parameter>scroll_type</parameter>&nbsp;:</entry>
<entry>A <link linkend="GtkScrollType">GtkScrollType</link> value of how the scroll operation occured.
</entry></row>
<row><entry align="right"><parameter>position</parameter>&nbsp;:</entry>
<entry>a value between 0.0 and 1.0.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-scroll-vertical">The &quot;scroll-vertical&quot; signal</title>
<programlisting>void        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);</programlisting>
<para>
This signal is emitted when the CList is scrolled vertically.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>the object which received the signal.
</entry></row>
<row><entry align="right"><parameter>scroll_type</parameter>&nbsp;:</entry>
<entry>A <link linkend="GtkScrollType">GtkScrollType</link> value of how the scroll operation occured.
</entry></row>
<row><entry align="right"><parameter>position</parameter>&nbsp;:</entry>
<entry>A value between 0.0 and 1.0.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-select-all">The &quot;select-all&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
This signal is emitted when all the rows are selected in a CList.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>the object which received the signal.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-select-row">The &quot;select-row&quot; signal</title>
<programlisting>void        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);</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">gtk_clist_select_all</link>().
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The object which received the signal.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The row selected.
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column where the selection occured.
</entry></row>
<row><entry align="right"><parameter>event</parameter>&nbsp;:</entry>
<entry>A <link linkend="GdkEvent">GdkEvent</link> structure for the selection.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-set-scroll-adjustments">The &quot;set-scroll-adjustments&quot; signal</title>
<programlisting>void        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);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>the object which received the signal.
</entry></row>
<row><entry align="right"><parameter>arg1</parameter>&nbsp;:</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>arg2</parameter>&nbsp;:</entry>
<entry>

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-start-selection">The &quot;start-selection&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
This signal is emitted when a drag-selection is started in 
a multiple-selection CList.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>the object which received the signal.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-toggle-add-mode">The &quot;toggle-add-mode&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
This signal is emitted when "add mode" is toggled.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>the object which received the signal.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-toggle-focus-row">The &quot;toggle-focus-row&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The object which received the signal.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-undo-selection">The &quot;undo-selection&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
This signal is emitted when an undo selection occurs in the CList,
probably via calling <link linkend="gtk-clist-undo-selection">gtk_clist_undo_selection</link>().
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>the object which received the signal.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-unselect-all">The &quot;unselect-all&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkCList">GtkCList</link> *clist,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
This signal is emitted when all rows are unselected in a CList.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>the object which received the signal.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkCList-unselect-row">The &quot;unselect-row&quot; signal</title>
<programlisting>void        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);</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">gtk_clist_unselect_all</link>().  It is also emitted for the
previously selected row in a "single" or "browse" mode CList.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>clist</parameter>&nbsp;:</entry>
<entry>The object which received the signal.
</entry></row>
<row><entry align="right"><parameter>row</parameter>&nbsp;:</entry>
<entry>The selected row
</entry></row>
<row><entry align="right"><parameter>column</parameter>&nbsp;:</entry>
<entry>The column where the selection occured.
</entry></row>
<row><entry align="right"><parameter>event</parameter>&nbsp;:</entry>
<entry>

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2>
</refsect1>



</refentry>
