<!-- ##### SECTION Title ##### -->GtkCList<!-- ##### SECTION Short_Description ##### -->A multi-columned scrolling list widget<!-- ##### SECTION Long_Description ##### --><para>The #GtkCList widget is a very useful multi-columned scrolling list.  It can display data in nicely aligned vertical columns, with titles at the top of the list.</para><para>GtkCList has been deprecated since GTK+ 2.0 and should not be usedin newly written code. Use #GtkTreeView instead.</para><!-- ##### SECTION See_Also ##### --><para></para><!-- ##### SECTION Stability_Level ##### --><!-- ##### STRUCT GtkCList ##### --><para>This is the embodiment of the #GtkCList widget.  This structure containsonly private data, and should be accessed only via the CList API.</para><!-- ##### SIGNAL GtkCList::abort-column-resize ##### --><para>This signal is emitted when a column resize is aborted.</para>@clist: the object which received the signal.<!-- ##### SIGNAL GtkCList::click-column ##### --><para>This signal is emitted when a column title is clicked.</para>@clist: The object which received the signal.@column: The number of the column.<!-- ##### SIGNAL GtkCList::end-selection ##### --><para>This signal is emitted when a selection ends in a multiple selection CList.</para>@clist: the object which received the signal.<!-- ##### SIGNAL GtkCList::extend-selection ##### --><para>This signal is emitted when the selection is extended.</para>@clist: the object which received the signal.@scroll_type: A #GtkScrollType value of any scrolling operation theoccured during the selection.@position: A value between 0.0 and 1.0.@auto_start_selection: %TRUE or %FALSE.<!-- ##### SIGNAL GtkCList::resize-column ##### --><para>This signal is emitted when a column is resized.</para>@clist: The object which received the signal.@column: The number of the column@width: The new width of the column.<!-- ##### SIGNAL GtkCList::row-move ##### --><para>This signal is emitted when a row is moved.</para>@clist: The object which received the signal.@arg1: The source position of the row.@arg2: The destination position of the row.<!-- ##### SIGNAL GtkCList::scroll-horizontal ##### --><para>This signal is emitted when the CList is scrolled horizontally.</para>@clist: the object which received the signal.@scroll_type: A #GtkScrollType value of how the scroll operation occured.@position: a value between 0.0 and 1.0.<!-- ##### SIGNAL GtkCList::scroll-vertical ##### --><para>This signal is emitted when the CList is scrolled vertically.</para>@clist: the object which received the signal.@scroll_type: A #GtkScrollType value of how the scroll operation occured.@position: A value between 0.0 and 1.0.<!-- ##### SIGNAL GtkCList::select-all ##### --><para>This signal is emitted when all the rows are selected in a CList.</para>@clist: the object which received the signal.<!-- ##### SIGNAL GtkCList::select-row ##### --><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 orby calling gtk_clist_select_all().</para>@clist: The object which received the signal.@row: The row selected.@column: The column where the selection occured.@event: A #GdkEvent structure for the selection.<!-- ##### SIGNAL GtkCList::set-scroll-adjustments ##### --><para></para>@clist: the object which received the signal.@arg1: @arg2: <!-- ##### SIGNAL GtkCList::start-selection ##### --><para>This signal is emitted when a drag-selection is started in a multiple-selection CList.</para>@clist: the object which received the signal.<!-- ##### SIGNAL GtkCList::toggle-add-mode ##### --><para>This signal is emitted when "add mode" is toggled.</para>@clist: the object which received the signal.<!-- ##### SIGNAL GtkCList::toggle-focus-row ##### --><para></para>@clist: The object which received the signal.<!-- ##### SIGNAL GtkCList::undo-selection ##### --><para>This signal is emitted when an undo selection occurs in the CList,probably via calling gtk_clist_undo_selection().</para>@clist: the object which received the signal.<!-- ##### SIGNAL GtkCList::unselect-all ##### --><para>This signal is emitted when all rows are unselected in a CList.</para>@clist: the object which received the signal.<!-- ##### SIGNAL GtkCList::unselect-row ##### --><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 orby calling gtk_clist_unselect_all().  It is also emitted for thepreviously selected row in a "single" or "browse" mode CList.</para>@clist: The object which received the signal.@row: The selected row@column: The column where the selection occured.@event: <!-- ##### ARG GtkCList:n-columns ##### --><para>An integer value for a column.</para><!-- ##### ARG GtkCList:reorderable ##### --><para>A boolean value for determining if the user can re-order the CList'scolumns.</para><!-- ##### ARG GtkCList:row-height ##### --><para>An integer value representing the height of a row in pixels.</para><!-- ##### ARG GtkCList:selection-mode ##### --><para>Sets the type of selection mode for the CList.</para><!-- ##### ARG GtkCList:shadow-type ##### --><para>Sets the shadowing for the CList.</para><!-- ##### ARG GtkCList:sort-type ##### --><para></para><!-- ##### ARG GtkCList:titles-active ##### --><para>A boolean value for setting whether the column titles can beclicked.</para><!-- ##### ARG GtkCList:use-drag-icons ##### --><para>A boolean value for setting whether to use icons during dragoperations.</para><!-- ##### ENUM GtkCellType ##### --><para>Identifies the type of element in the current cell of the CList.  Cells cancontain text, pixmaps, or both. Unfortunately support for %GTK_CELL_WIDGETwas never completed.</para>@GTK_CELL_EMPTY: @GTK_CELL_TEXT: @GTK_CELL_PIXMAP: @GTK_CELL_PIXTEXT: @GTK_CELL_WIDGET: <!-- ##### ENUM GtkButtonAction ##### --><para>Values for specifying what mouse button events a CList willreact to.</para>@GTK_BUTTON_IGNORED: @GTK_BUTTON_SELECTS: @GTK_BUTTON_DRAGS: @GTK_BUTTON_EXPANDS: <!-- ##### MACRO GTK_CLIST_FLAGS ##### --><para>Reads the current flags of the specified CList.</para>@clist: The #GtkCList widget from which to get the flags<!-- ##### MACRO GTK_CLIST_SET_FLAG ##### --><para>A macro to set a particular flag for the specified CList.</para>@clist: The #GtkCList widget to affect.@flag: A single #GtkCList flag to set.  NOTE: Do not add the GTK_ prefix.<!-- ##### MACRO GTK_CLIST_UNSET_FLAG ##### --><para>A macro to clear a particular flag for the specified CList.</para>@clist: The #GtkCList widget to affect.@flag: A single #GtkCList flag to clear.  NOTE: Do not add the GTK_ prefix.<!-- ##### MACRO GTK_CLIST_IN_DRAG ##### --><para>A macro to check whether the #GtkCList is in "drag mode."</para>@clist: The #GtkCList to check.<!-- ##### MACRO GTK_CLIST_ROW_HEIGHT_SET ##### --><para>A macro to check whether the #GtkCList's row height is set.</para>@clist: The #GtkCList to check.<!-- ##### MACRO GTK_CLIST_SHOW_TITLES ##### --><para>A macro to check whether the flag for showing the widget's column titles is set.</para>@clist: The #GtkCList widget to check.<!-- ##### MACRO GTK_CLIST_ADD_MODE ##### --><para>A macro to test whether the CList is in "add mode."</para>@clist: The #GtkCList widget to check.<!-- ##### MACRO GTK_CLIST_AUTO_SORT ##### --><para>A macro to test whether the CList has automatic sortingswitched on.</para>@clist: The #GtkCList widget to check.<!-- ##### MACRO GTK_CLIST_AUTO_RESIZE_BLOCKED ##### --><para>A macro to check if automatic resizing of columns is blocked.</para>@clist: The #GtkCList widget to check.<!-- ##### MACRO GTK_CLIST_REORDERABLE ##### --><para>A macro to test if the CList's columns are re-orderable</para>@clist: The #GtkCList widget to check.<!-- ##### MACRO GTK_CLIST_USE_DRAG_ICONS ##### --><para>A macro to check if the USE_DRAG_ICONS property is enabled.</para>@clist: The #GtkCList widget to check.<!-- ##### MACRO GTK_CLIST_DRAW_DRAG_LINE ##### --><para>A macro to check if the DRAW_DRAG_LINE property is enabled.</para>@clist: The #GtkCList widget to check.<!-- ##### MACRO GTK_CLIST_DRAW_DRAG_RECT ##### --><para>A macro to check if the DRAW_DRAG_RECT property is enabled.</para>@clist: The #GtkCList widget to check.<!-- ##### MACRO GTK_CLIST_ROW ##### --><para>A macro to cast a GList element to a CListRow pointer.</para>@_glist_: The GList element to convert.<!-- ##### MACRO GTK_CELL_TEXT ##### --><para>A macro to cast a generic #GtkCList cell item to a GtkCellText pointer.</para>@cell: The #GtkCList cell item to convert.<!-- ##### MACRO GTK_CELL_PIXMAP ##### --><para>A macro to cast a generic #GtkCList cell item to a GtkCellPixmap pointer.</para>@cell: The #GtkCList cell item to convert.<!-- ##### MACRO GTK_CELL_PIXTEXT ##### --><para>A macro to cast a generic #GtkCList cell item to a GtkCellPixText pointer.</para>@cell: The #GtkCList cell item to convert.<!-- ##### MACRO GTK_CELL_WIDGET ##### --><para>A macro to cast a generic #GtkCList cell item to a GtkCellWidget pointer.</para>@cell: The #GtkCList cell item to convert.<!-- ##### USER_FUNCTION GtkCListCompareFunc ##### --><para>Function prototype for the compare function callback.</para>@clist: The #GtkCList that is affected.@ptr1: A #gconstpointer to the first node to compare.@ptr2: A #gconstpointer to the second node to compare.@Returns: 0 if the nodes are equal, less than 0 if the first node shouldcome before the second, and greater than 1 if the second come before thefirst.<!-- ##### STRUCT GtkCListColumn ##### --><para>A structure that the #GtkCList widget uses to keep track of informationabout its columns.</para>@title: @area: @button: @window: @width: @min_width: @max_width: @justification: @visible: @width_set: @resizeable: @auto_resize: @button_passive: <!-- ##### STRUCT GtkCListRow ##### --><para>A structure that the #GtkCList widget uses to keep track of informationabout its rows.</para>@cell: @state: @foreground: @background: