GtkCList

Name

GtkCList — A multi-columned scrolling list widget.

Synopsis


#include <gtk/gtk.h>


struct      GtkCList;
enum        GtkCellType;
enum        GtkButtonAction;
#define     GTK_CLIST_FLAGS                 (clist)
#define     GTK_CLIST_SET_FLAG              (clist,flag)
#define     GTK_CLIST_UNSET_FLAG            (clist,flag)
#define     GTK_CLIST_IN_DRAG               (clist)
#define     GTK_CLIST_ROW_HEIGHT_SET        (clist)
#define     GTK_CLIST_SHOW_TITLES           (clist)
#define     GTK_CLIST_CHILD_HAS_FOCUS       (clist)
#define     GTK_CLIST_ADD_MODE              (clist)
#define     GTK_CLIST_AUTO_SORT             (clist)
#define     GTK_CLIST_AUTO_RESIZE_BLOCKED   (clist)
#define     GTK_CLIST_REORDERABLE           (clist)
#define     GTK_CLIST_USE_DRAG_ICONS        (clist)
#define     GTK_CLIST_DRAW_DRAG_LINE        (clist)
#define     GTK_CLIST_DRAW_DRAG_RECT        (clist)
#define     GTK_CLIST_ROW                   (_glist_)
#define     GTK_CELL_TEXT                   (cell)
#define     GTK_CELL_PIXMAP                 (cell)
#define     GTK_CELL_PIXTEXT                (cell)
#define     GTK_CELL_WIDGET                 (cell)
gint        (*GtkCListCompareFunc)          (GtkCList *clist,
                                             gconstpointer ptr1,
                                             gconstpointer ptr2);
struct      GtkCListColumn;
struct      GtkCListRow;
struct      GtkCellText;
struct      GtkCellPixmap;
struct      GtkCellPixText;
struct      GtkCellWidget;
struct      GtkCell;
struct      GtkCListCellInfo;
struct      GtkCListDestInfo;
enum        GtkCListDragPos;
void        gtk_clist_construct             (GtkCList *clist,
                                             gint columns,
                                             gchar *titles[]);
GtkWidget*  gtk_clist_new                   (gint columns);
GtkWidget*  gtk_clist_new_with_titles       (gint columns,
                                             gchar *titles[]);
void        gtk_clist_set_shadow_type       (GtkCList *clist,
                                             GtkShadowType type);
void        gtk_clist_set_selection_mode    (GtkCList *clist,
                                             GtkSelectionMode mode);
void        gtk_clist_freeze                (GtkCList *clist);
void        gtk_clist_thaw                  (GtkCList *clist);
void        gtk_clist_column_titles_show    (GtkCList *clist);
void        gtk_clist_column_titles_hide    (GtkCList *clist);
void        gtk_clist_column_title_active   (GtkCList *clist,
                                             gint column);
void        gtk_clist_column_title_passive  (GtkCList *clist,
                                             gint column);
void        gtk_clist_column_titles_active  (GtkCList *clist);
void        gtk_clist_column_titles_passive (GtkCList *clist);
void        gtk_clist_set_column_title      (GtkCList *clist,
                                             gint column,
                                             const gchar *title);
void        gtk_clist_set_column_widget     (GtkCList *clist,
                                             gint column,
                                             GtkWidget *widget);
void        gtk_clist_set_column_justification
                                            (GtkCList *clist,
                                             gint column,
                                             GtkJustification justification);
void        gtk_clist_set_column_visibility (GtkCList *clist,
                                             gint column,
                                             gboolean visible);
void        gtk_clist_set_column_resizeable (GtkCList *clist,
                                             gint column,
                                             gboolean resizeable);
void        gtk_clist_set_column_auto_resize
                                            (GtkCList *clist,
                                             gint column,
                                             gboolean auto_resize);
gint        gtk_clist_optimal_column_width  (GtkCList *clist,
                                             gint column);
void        gtk_clist_set_column_width      (GtkCList *clist,
                                             gint column,
                                             gint width);
void        gtk_clist_set_column_min_width  (GtkCList *clist,
                                             gint column,
                                             gint min_width);
void        gtk_clist_set_column_max_width  (GtkCList *clist,
                                             gint column,
                                             gint max_width);
void        gtk_clist_set_row_height        (GtkCList *clist,
                                             guint height);
void        gtk_clist_moveto                (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             gfloat row_align,
                                             gfloat col_align);
GtkVisibility gtk_clist_row_is_visible      (GtkCList *clist,
                                             gint row);
GtkCellType gtk_clist_get_cell_type         (GtkCList *clist,
                                             gint row,
                                             gint column);
void        gtk_clist_set_text              (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             const gchar *text);
gint        gtk_clist_get_text              (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             gchar **text);
void        gtk_clist_set_pixmap            (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             GdkPixmap *pixmap,
                                             GdkBitmap *mask);
gint        gtk_clist_get_pixmap            (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             GdkPixmap **pixmap,
                                             GdkBitmap **mask);
void        gtk_clist_set_pixtext           (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             const gchar *text,
                                             guint8 spacing,
                                             GdkPixmap *pixmap,
                                             GdkBitmap *mask);
gint        gtk_clist_get_pixtext           (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             gchar **text,
                                             guint8 *spacing,
                                             GdkPixmap **pixmap,
                                             GdkBitmap **mask);
void        gtk_clist_set_foreground        (GtkCList *clist,
                                             gint row,
                                             GdkColor *color);
void        gtk_clist_set_background        (GtkCList *clist,
                                             gint row,
                                             GdkColor *color);
void        gtk_clist_set_cell_style        (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             GtkStyle *style);
GtkStyle*   gtk_clist_get_cell_style        (GtkCList *clist,
                                             gint row,
                                             gint column);
void        gtk_clist_set_row_style         (GtkCList *clist,
                                             gint row,
                                             GtkStyle *style);
GtkStyle*   gtk_clist_get_row_style         (GtkCList *clist,
                                             gint row);
void        gtk_clist_set_shift             (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             gint vertical,
                                             gint horizontal);
void        gtk_clist_set_selectable        (GtkCList *clist,
                                             gint row,
                                             gboolean selectable);
gboolean    gtk_clist_get_selectable        (GtkCList *clist,
                                             gint row);
gint        gtk_clist_prepend               (GtkCList *clist,
                                             gchar *text[]);
gint        gtk_clist_append                (GtkCList *clist,
                                             gchar *text[]);
gint        gtk_clist_insert                (GtkCList *clist,
                                             gint row,
                                             gchar *text[]);
void        gtk_clist_remove                (GtkCList *clist,
                                             gint row);
void        gtk_clist_set_row_data          (GtkCList *clist,
                                             gint row,
                                             gpointer data);
void        gtk_clist_set_row_data_full     (GtkCList *clist,
                                             gint row,
                                             gpointer data,
                                             GtkDestroyNotify destroy);
gpointer    gtk_clist_get_row_data          (GtkCList *clist,
                                             gint row);
gint        gtk_clist_find_row_from_data    (GtkCList *clist,
                                             gpointer data);
void        gtk_clist_select_row            (GtkCList *clist,
                                             gint row,
                                             gint column);
void        gtk_clist_unselect_row          (GtkCList *clist,
                                             gint row,
                                             gint column);
void        gtk_clist_undo_selection        (GtkCList *clist);
void        gtk_clist_clear                 (GtkCList *clist);
gint        gtk_clist_get_selection_info    (GtkCList *clist,
                                             gint x,
                                             gint y,
                                             gint *row,
                                             gint *column);
void        gtk_clist_select_all            (GtkCList *clist);
void        gtk_clist_unselect_all          (GtkCList *clist);
void        gtk_clist_swap_rows             (GtkCList *clist,
                                             gint row1,
                                             gint row2);
void        gtk_clist_set_compare_func      (GtkCList *clist,
                                             GtkCListCompareFunc cmp_func);
void        gtk_clist_set_sort_column       (GtkCList *clist,
                                             gint column);
void        gtk_clist_set_sort_type         (GtkCList *clist,
                                             GtkSortType sort_type);
void        gtk_clist_sort                  (GtkCList *clist);
void        gtk_clist_set_auto_sort         (GtkCList *clist,
                                             gboolean auto_sort);
gint        gtk_clist_columns_autosize      (GtkCList *clist);
gchar*      gtk_clist_get_column_title      (GtkCList *clist,
                                             gint column);
GtkWidget*  gtk_clist_get_column_widget     (GtkCList *clist,
                                             gint column);
GtkAdjustment* gtk_clist_get_hadjustment    (GtkCList *clist);
GtkAdjustment* gtk_clist_get_vadjustment    (GtkCList *clist);
void        gtk_clist_row_move              (GtkCList *clist,
                                             gint source_row,
                                             gint dest_row);
void        gtk_clist_set_button_actions    (GtkCList *clist,
                                             guint button,
                                             guint8 button_actions);
void        gtk_clist_set_hadjustment       (GtkCList *clist,
                                             GtkAdjustment *adjustment);
void        gtk_clist_set_reorderable       (GtkCList *clist,
                                             gboolean reorderable);
void        gtk_clist_set_use_drag_icons    (GtkCList *clist,
                                             gboolean use_icons);
void        gtk_clist_set_vadjustment       (GtkCList *clist,
                                             GtkAdjustment *adjustment);

Object Hierarchy


  GtkObject
   +----GtkWidget
         +----GtkContainer
               +----GtkCList

Args


  "n_columns"            guint                : Read / Write / Construct Only
  "shadow_type"          GtkShadowType        : Read / Write
  "selection_mode"       GtkSelectionMode     : Read / Write
  "row_height"           guint                : Read / Write
  "reorderable"          gboolean             : Read / Write
  "titles_active"        gboolean             : Read / Write
  "use_drag_icons"       gboolean             : Read / Write

Signal Prototypes


"select-row"
            void        user_function      (GtkCList *clist,
                                            gint row,
                                            gint column,
                                            GdkEventButton *event,
                                            gpointer user_data);
"unselect-row"
            void        user_function      (GtkCList *clist,
                                            gint row,
                                            gint column,
                                            GdkEventButton *event,
                                            gpointer user_data);
"row-move"  void        user_function      (GtkCList *clist,
                                            gint arg1,
                                            gint arg2,
                                            gpointer user_data);
"click-column"
            void        user_function      (GtkCList *clist,
                                            gint column,
                                            gpointer user_data);
"resize-column"
            void        user_function      (GtkCList *clist,
                                            gint column,
                                            gint width,
                                            gpointer user_data);
"toggle-focus-row"
            void        user_function      (GtkCList *clist,
                                            gpointer user_data);
"select-all"
            void        user_function      (GtkCList *clist,
                                            gpointer user_data);
"unselect-all"
            void        user_function      (GtkCList *clist,
                                            gpointer user_data);
"undo-selection"
            void        user_function      (GtkCList *clist,
                                            gpointer user_data);
"start-selection"
            void        user_function      (GtkCList *clist,
                                            gpointer user_data);
"end-selection"
            void        user_function      (GtkCList *clist,
                                            gpointer user_data);
"toggle-add-mode"
            void        user_function      (GtkCList *clist,
                                            gpointer user_data);
"extend-selection"
            void        user_function      (GtkCList *clist,
                                            GtkScrollType scroll_type,
                                            gfloat position,
                                            gboolean auto_start_selection,
                                            gpointer user_data);
"scroll-vertical"
            void        user_function      (GtkCList *clist,
                                            GtkScrollType scroll_type,
                                            gfloat position,
                                            gpointer user_data);
"scroll-horizontal"
            void        user_function      (GtkCList *clist,
                                            GtkScrollType scroll_type,
                                            gfloat position,
                                            gpointer user_data);
"abort-column-resize"
            void        user_function      (GtkCList *clist,
                                            gpointer user_data);

Description

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. FIXME: More info

Details

struct GtkCList

struct GtkCList;

This is the embodiment of the GtkCList widget.


enum GtkCellType

typedef enum
{
  GTK_CELL_EMPTY,
  GTK_CELL_TEXT,
  GTK_CELL_PIXMAP,
  GTK_CELL_PIXTEXT,
  GTK_CELL_WIDGET
} GtkCellType;

Identifies the type of element in the current cell of the CList. Cells can contain text, pixmaps, or even other widgets.


enum GtkButtonAction

typedef enum
{
  GTK_BUTTON_IGNORED = 0,
  GTK_BUTTON_SELECTS = 1 << 0,
  GTK_BUTTON_DRAGS   = 1 << 1,
  GTK_BUTTON_EXPANDS = 1 << 2
} GtkButtonAction;


GTK_CLIST_FLAGS()

#define GTK_CLIST_FLAGS(clist)             (GTK_CLIST (clist)->flags)

Reads the current flags of the specified CList.

clist :The GtkCList widget from which to get the flags


GTK_CLIST_SET_FLAG()

#define GTK_CLIST_SET_FLAG(clist,flag)     (GTK_CLIST_FLAGS (clist) |= (GTK_ ## flag))

A macro to set a particular flag for the specified CList.

clist :The GtkCList widget to affect.
flag :A single GtkCList flag to set. NOTE: Do not add the GTK_ prefix.


GTK_CLIST_UNSET_FLAG()

#define GTK_CLIST_UNSET_FLAG(clist,flag)   (GTK_CLIST_FLAGS (clist) &= ~(GTK_ ## flag))

A macro to clear a particular flag for the specified CList.

clist :The GtkCList widget to affect.
flag :A single GtkCList flag to clear. NOTE: Do not add the GTK_ prefix.


GTK_CLIST_IN_DRAG()

#define GTK_CLIST_IN_DRAG(clist)           (GTK_CLIST_FLAGS (clist) & GTK_CLIST_IN_DRAG)

A macro to check whether the GtkCList is in "drag mode."

clist :The GtkCList to check.


GTK_CLIST_ROW_HEIGHT_SET()

#define GTK_CLIST_ROW_HEIGHT_SET(clist)    (GTK_CLIST_FLAGS (clist) & GTK_CLIST_ROW_HEIGHT_SET)

clist : 


GTK_CLIST_SHOW_TITLES()

#define GTK_CLIST_SHOW_TITLES(clist)       (GTK_CLIST_FLAGS (clist) & GTK_CLIST_SHOW_TITLES)

A macro to check whether the flag for showing the widget's column titles is set.

clist :The GtkCList widget to check.


GTK_CLIST_CHILD_HAS_FOCUS()

#define GTK_CLIST_CHILD_HAS_FOCUS(clist)   (GTK_CLIST_FLAGS (clist) & GTK_CLIST_CHILD_HAS_FOCUS)

A macro to check whether a child widget of the CList has the focus.

clist :The GtkCList widget to check.


GTK_CLIST_ADD_MODE()

#define GTK_CLIST_ADD_MODE(clist)          (GTK_CLIST_FLAGS (clist) & GTK_CLIST_ADD_MODE)

clist : 


GTK_CLIST_AUTO_SORT()

#define GTK_CLIST_AUTO_SORT(clist)         (GTK_CLIST_FLAGS (clist) & GTK_CLIST_AUTO_SORT)

clist : 


GTK_CLIST_AUTO_RESIZE_BLOCKED()

#define GTK_CLIST_AUTO_RESIZE_BLOCKED(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_AUTO_RESIZE_BLOCKED)

clist : 


GTK_CLIST_REORDERABLE()

#define GTK_CLIST_REORDERABLE(clist)       (GTK_CLIST_FLAGS (clist) & GTK_CLIST_REORDERABLE)

clist : 


GTK_CLIST_USE_DRAG_ICONS()

#define GTK_CLIST_USE_DRAG_ICONS(clist)    (GTK_CLIST_FLAGS (clist) & GTK_CLIST_USE_DRAG_ICONS)

clist : 


GTK_CLIST_DRAW_DRAG_LINE()

#define GTK_CLIST_DRAW_DRAG_LINE(clist)    (GTK_CLIST_FLAGS (clist) & GTK_CLIST_DRAW_DRAG_LINE)

clist : 


GTK_CLIST_DRAW_DRAG_RECT()

#define GTK_CLIST_DRAW_DRAG_RECT(clist)    (GTK_CLIST_FLAGS (clist) & GTK_CLIST_DRAW_DRAG_RECT)

clist : 


GTK_CLIST_ROW()

#define GTK_CLIST_ROW(_glist_) ((GtkCListRow *)((_glist_)->data))

A macro to cast a GList element to a CListRow pointer.

_glist_ :The GList element to convert.


GTK_CELL_TEXT()

#define GTK_CELL_TEXT(cell)     (((GtkCellText *) &(cell)))

A macro to cast a generic GtkCList cell item to a GtkCellText pointer.

cell :The GtkCList cell item to convert.


GTK_CELL_PIXMAP()

#define GTK_CELL_PIXMAP(cell)   (((GtkCellPixmap *) &(cell)))

A macro to cast a generic GtkCList cell item to a GtkCellPixmap pointer.

cell :The GtkCList cell item to convert.


GTK_CELL_PIXTEXT()

#define GTK_CELL_PIXTEXT(cell)  (((GtkCellPixText *) &(cell)))

A macro to cast a generic GtkCList cell item to a GtkCellPixText pointer.

cell :The GtkCList cell item to convert.


GTK_CELL_WIDGET()

#define GTK_CELL_WIDGET(cell)   (((GtkCellWidget *) &(cell)))

A macro to cast a generic GtkCList cell item to a GtkCellWidget pointer.

cell :The GtkCList cell item to convert.


GtkCListCompareFunc ()

gint        (*GtkCListCompareFunc)          (GtkCList *clist,
                                             gconstpointer ptr1,
                                             gconstpointer ptr2);

clist : 
ptr1 : 
ptr2 : 
Returns : 


struct GtkCListColumn

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;
};

A structure that the GtkCList widget uses to keep track of information about its columns.


struct GtkCListRow

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;
};

A structure that the GtkCList widget uses to keep track of information about its rows.


struct GtkCellText

struct GtkCellText
{
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  gchar *text;
};

A structure that the GtkCList widget uses to keep track of GtkCList cells that contain text.


struct GtkCellPixmap

struct GtkCellPixmap
{
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  GdkPixmap *pixmap;
  GdkBitmap *mask;
};

A structure that the GtkCList widget uses to keep track of GtkCList cells that contain a GdkPixmap.


struct GtkCellPixText

struct GtkCellPixText
{
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  gchar *text;
  guint8 spacing;
  GdkPixmap *pixmap;
  GdkBitmap *mask;
};

A structure that the GtkCList widget uses to keep track of GtkCList cells that contain a combination of text and a GdkPixmap.


struct GtkCellWidget

struct GtkCellWidget
{
  GtkCellType type;
  
  gint16 vertical;
  gint16 horizontal;
  
  GtkStyle *style;

  GtkWidget *widget;
};

A structure that the GtkCList widget uses to keep track of GtkCList cells that contain another widget.


struct GtkCell

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;
};

A generic structure that the GtkCList widget uses to keep track of the contents of each of its cells.


struct GtkCListCellInfo

struct GtkCListCellInfo
{
  gint row;
  gint column;
};


struct GtkCListDestInfo

struct GtkCListDestInfo
{
  GtkCListCellInfo cell;
  GtkCListDragPos  insert_pos;
};


enum GtkCListDragPos

typedef enum
{
  GTK_CLIST_DRAG_NONE,
  GTK_CLIST_DRAG_BEFORE,
  GTK_CLIST_DRAG_INTO,
  GTK_CLIST_DRAG_AFTER
} GtkCListDragPos;


gtk_clist_construct ()

void        gtk_clist_construct             (GtkCList *clist,
                                             gint columns,
                                             gchar *titles[]);

Initializes a previously allocated GtkCList widget for use. This should not normally be used to create a GtkCList widget. Use gtk_clist_new() instead.

clist :A pointer to an uninitialized GtkCList widget.
columns :The number of columns the GtkCList should have.
titles :An array of strings that should be used as the titles i of the columns. There should be enough strings in the array for the number of columns specified.


gtk_clist_new ()

GtkWidget*  gtk_clist_new                   (gint columns);

Creates a new GtkCList widget for use.

columns :The number of columns the GtkCList should have.
Returns :A pointer to a new GtkCList object.


gtk_clist_new_with_titles ()

GtkWidget*  gtk_clist_new_with_titles       (gint columns,
                                             gchar *titles[]);

Creates a new GtkCList widget with column titles for use.

columns :The number of columns the GtkCList should have.
titles :A string array of titles for the widget. There should be enough strings in the array for the specified number of columns.
Returns :A pointer to a new GtkCList object.


gtk_clist_set_shadow_type ()

void        gtk_clist_set_shadow_type       (GtkCList *clist,
                                             GtkShadowType type);

Sets the shadow type for the specified CList. Changing this value will cause the GtkCList to update its visuals.

clist :The GtkCList to affect.
type :The GtkShadowType desired.


gtk_clist_set_selection_mode ()

void        gtk_clist_set_selection_mode    (GtkCList *clist,
                                             GtkSelectionMode mode);

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 GtkCList to become deselected.

clist :The GtkCList to affect.
mode :The GtkSelectionMode type to set for this CList.


gtk_clist_freeze ()

void        gtk_clist_freeze                (GtkCList *clist);

Causes the GtkCList to stop updating its visuals until a matching call to gtk_clist_thaw() 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 gtk_clist_freeze() can be nested.

clist :The GtkCList to freeze.


gtk_clist_thaw ()

void        gtk_clist_thaw                  (GtkCList *clist);

Causes the specified GtkCList to allow visual updates.

clist :The GtkCList to thaw.


gtk_clist_column_titles_show ()

void        gtk_clist_column_titles_show    (GtkCList *clist);

This function causes the GtkCList to show its column titles, if they are not already showing.

clist :The GtkCList to affect.


gtk_clist_column_titles_hide ()

void        gtk_clist_column_titles_hide    (GtkCList *clist);

Causes the GtkCList to hide its column titles, if they are currently showing.

clist :The GtkCList to affect.


gtk_clist_column_title_active ()

void        gtk_clist_column_title_active   (GtkCList *clist,
                                             gint column);

Sets the specified column in the GtkCList to become selectable. You can then respond to events from the user clicking on a title button, and take appropriate action.

clist :The GtkCList to affect.
column :The column to make active, counting from 0.


gtk_clist_column_title_passive ()

void        gtk_clist_column_title_passive  (GtkCList *clist,
                                             gint column);

Causes the specified column title button to become passive, i.e., does not respond to events, such as the user clicking on it.

clist :The GtkCList to affect.
column :The column to make passive, counting from 0.


gtk_clist_column_titles_active ()

void        gtk_clist_column_titles_active  (GtkCList *clist);

Causes all column title buttons to become active. This is the same as calling gtk_clist_column_title_active() for each column.

clist :The GtkCList to affect.


gtk_clist_column_titles_passive ()

void        gtk_clist_column_titles_passive (GtkCList *clist);

Causes all column title buttons to become passive. This is the same as calling gtk_clist_column_title_passive() for each column.

clist :The GtkCList to affect.


gtk_clist_set_column_title ()

void        gtk_clist_set_column_title      (GtkCList *clist,
                                             gint column,
                                             const gchar *title);

Sets the title for the specified column.

clist :The GtkCList to affect.
column :The column whose title should be changed.
title :A string to be the column's title.


gtk_clist_set_column_widget ()

void        gtk_clist_set_column_widget     (GtkCList *clist,
                                             gint column,
                                             GtkWidget *widget);

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.

clist :The GtkCList to affect.
column :The column whose title should be a widget.
widget :A pointer to a previously create widget.


gtk_clist_set_column_justification ()

void        gtk_clist_set_column_justification
                                            (GtkCList *clist,
                                             gint column,
                                             GtkJustification justification);

Sets the justification to be used for all text in the specified column.

clist :The GtkCList to affect.
column :The column which should be affected.
justification :A GtkJustification value for the column.


gtk_clist_set_column_visibility ()

void        gtk_clist_set_column_visibility (GtkCList *clist,
                                             gint column,
                                             gboolean visible);

Allows you to set whether a specified column in the GtkCList 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.

clist :The GtkCList to affect.
column :The column to set visibility.
visible :TRUE or FALSE.


gtk_clist_set_column_resizeable ()

void        gtk_clist_set_column_resizeable (GtkCList *clist,
                                             gint column,
                                             gboolean resizeable);

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 gtk_clist_set_column_auto_resize().

clist :The GtkCList to affect.
column :The column on which to set resizeability.
resizeable :TRUE or FALSE.


gtk_clist_set_column_auto_resize ()

void        gtk_clist_set_column_auto_resize
                                            (GtkCList *clist,
                                             gint column,
                                             gboolean auto_resize);

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.

clist :The GtkCList to affect.
column :The column on which to set auto-resizing.
auto_resize :TRUE or FALSE.


gtk_clist_optimal_column_width ()

gint        gtk_clist_optimal_column_width  (GtkCList *clist,
                                             gint column);

Gets the required width in pixels that is needed to show everything in the specified column.

clist :The GtkCList to check.
column :The column to check.
Returns :The required width in pixels for the column.


gtk_clist_set_column_width ()

void        gtk_clist_set_column_width      (GtkCList *clist,
                                             gint column,
                                             gint width);

Causes the column specified for the GtkCList to be set to a specified width.

clist :The GtkCList to affect.
column :The column to set the width.
width :The width, in pixels.


gtk_clist_set_column_min_width ()

void        gtk_clist_set_column_min_width  (GtkCList *clist,
                                             gint column,
                                             gint min_width);

Causes the column specified to have a minimum width, preventing the user from resizing it smaller than that specified.

clist :The GtkCList to affect.
column :The column to set the minimum width.
min_width :The width, in pixels.


gtk_clist_set_column_max_width ()

void        gtk_clist_set_column_max_width  (GtkCList *clist,
                                             gint column,
                                             gint max_width);

Causes the column specified to have a maximum width, preventing the user from resizing it larger than that specified.

clist :The GtkCList to affect.
column :The column to set the maximum width.
max_width :The width, in pixels.


gtk_clist_set_row_height ()

void        gtk_clist_set_row_height        (GtkCList *clist,
                                             guint height);

Causes the GtkCList to have a specified height for its rows. Setting the row height to 0 allows the GtkCList to adjust automatically to data in the row.

clist :The GtkCList to affect.
height :The height, in pixels.


gtk_clist_moveto ()

void        gtk_clist_moveto                (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             gfloat row_align,
                                             gfloat col_align);

clist :The GtkCList to affect.
row : 
column : 
row_align : 
col_align : 


gtk_clist_row_is_visible ()

GtkVisibility gtk_clist_row_is_visible      (GtkCList *clist,
                                             gint row);

clist : 
row : 
Returns : 


gtk_clist_get_cell_type ()

GtkCellType gtk_clist_get_cell_type         (GtkCList *clist,
                                             gint row,
                                             gint column);

clist : 
row : 
column : 
Returns : 


gtk_clist_set_text ()

void        gtk_clist_set_text              (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             const gchar *text);

clist :The GtkCList to affect.
row : 
column : 
text : 


gtk_clist_get_text ()

gint        gtk_clist_get_text              (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             gchar **text);

clist : 
row : 
column : 
text : 
Returns : 


gtk_clist_set_pixmap ()

void        gtk_clist_set_pixmap            (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             GdkPixmap *pixmap,
                                             GdkBitmap *mask);

clist :The GtkCList to affect.
row : 
column : 
pixmap : 
mask : 


gtk_clist_get_pixmap ()

gint        gtk_clist_get_pixmap            (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             GdkPixmap **pixmap,
                                             GdkBitmap **mask);

clist : 
row : 
column : 
pixmap : 
mask : 
Returns : 


gtk_clist_set_pixtext ()

void        gtk_clist_set_pixtext           (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             const gchar *text,
                                             guint8 spacing,
                                             GdkPixmap *pixmap,
                                             GdkBitmap *mask);

clist :The GtkCList to affect.
row : 
column : 
text : 
spacing : 
pixmap : 
mask : 


gtk_clist_get_pixtext ()

gint        gtk_clist_get_pixtext           (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             gchar **text,
                                             guint8 *spacing,
                                             GdkPixmap **pixmap,
                                             GdkBitmap **mask);

clist : 
row : 
column : 
text : 
spacing : 
pixmap : 
mask : 
Returns : 


gtk_clist_set_foreground ()

void        gtk_clist_set_foreground        (GtkCList *clist,
                                             gint row,
                                             GdkColor *color);

clist :The GtkCList to affect.
row : 
color : 


gtk_clist_set_background ()

void        gtk_clist_set_background        (GtkCList *clist,
                                             gint row,
                                             GdkColor *color);

clist :The GtkCList to affect.
row : 
color : 


gtk_clist_set_cell_style ()

void        gtk_clist_set_cell_style        (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             GtkStyle *style);

clist :The GtkCList to affect.
row : 
column : 
style : 


gtk_clist_get_cell_style ()

GtkStyle*   gtk_clist_get_cell_style        (GtkCList *clist,
                                             gint row,
                                             gint column);

clist : 
row : 
column : 
Returns : 


gtk_clist_set_row_style ()

void        gtk_clist_set_row_style         (GtkCList *clist,
                                             gint row,
                                             GtkStyle *style);

clist :The GtkCList to affect.
row : 
style : 


gtk_clist_get_row_style ()

GtkStyle*   gtk_clist_get_row_style         (GtkCList *clist,
                                             gint row);

clist : 
row : 
Returns : 


gtk_clist_set_shift ()

void        gtk_clist_set_shift             (GtkCList *clist,
                                             gint row,
                                             gint column,
                                             gint vertical,
                                             gint horizontal);

clist :The GtkCList to affect.
row : 
column : 
vertical : 
horizontal : 


gtk_clist_set_selectable ()

void        gtk_clist_set_selectable        (GtkCList *clist,
                                             gint row,
                                             gboolean selectable);

clist :The GtkCList to affect.
row : 
selectable : 


gtk_clist_get_selectable ()

gboolean    gtk_clist_get_selectable        (GtkCList *clist,
                                             gint row);

clist : 
row : 
Returns : 


gtk_clist_prepend ()

gint        gtk_clist_prepend               (GtkCList *clist,
                                             gchar *text[]);

clist :The GtkCList to affect.
text : 
Returns : 


gtk_clist_append ()

gint        gtk_clist_append                (GtkCList *clist,
                                             gchar *text[]);

clist :The GtkCList to affect.
text : 
Returns : 


gtk_clist_insert ()

gint        gtk_clist_insert                (GtkCList *clist,
                                             gint row,
                                             gchar *text[]);

clist :The GtkCList to affect.
row : 
text : 
Returns : 


gtk_clist_remove ()

void        gtk_clist_remove                (GtkCList *clist,
                                             gint row);

clist :The GtkCList to affect.
row : 


gtk_clist_set_row_data ()

void        gtk_clist_set_row_data          (GtkCList *clist,
                                             gint row,
                                             gpointer data);

clist :The GtkCList to affect.
row : 
data : 


gtk_clist_set_row_data_full ()

void        gtk_clist_set_row_data_full     (GtkCList *clist,
                                             gint row,
                                             gpointer data,
                                             GtkDestroyNotify destroy);

clist :The GtkCList to affect.
row : 
data : 
destroy : 


gtk_clist_get_row_data ()

gpointer    gtk_clist_get_row_data          (GtkCList *clist,
                                             gint row);

clist : 
row : 
Returns : 


gtk_clist_find_row_from_data ()

gint        gtk_clist_find_row_from_data    (GtkCList *clist,
                                             gpointer data);

clist : 
data : 
Returns : 


gtk_clist_select_row ()

void        gtk_clist_select_row            (GtkCList *clist,
                                             gint row,
                                             gint column);

clist :The GtkCList to affect.
row : 
column : 


gtk_clist_unselect_row ()

void        gtk_clist_unselect_row          (GtkCList *clist,
                                             gint row,
                                             gint column);

clist :The GtkCList to affect.
row : 
column : 


gtk_clist_undo_selection ()

void        gtk_clist_undo_selection        (GtkCList *clist);

clist :The GtkCList to affect.


gtk_clist_clear ()

void        gtk_clist_clear                 (GtkCList *clist);

clist :The GtkCList to affect.


gtk_clist_get_selection_info ()

gint        gtk_clist_get_selection_info    (GtkCList *clist,
                                             gint x,
                                             gint y,
                                             gint *row,
                                             gint *column);

clist : 
x : 
y : 
row : 
column : 
Returns : 


gtk_clist_select_all ()

void        gtk_clist_select_all            (GtkCList *clist);

clist :The GtkCList to affect.


gtk_clist_unselect_all ()

void        gtk_clist_unselect_all          (GtkCList *clist);

clist :The GtkCList to affect.


gtk_clist_swap_rows ()

void        gtk_clist_swap_rows             (GtkCList *clist,
                                             gint row1,
                                             gint row2);

clist :The GtkCList to affect.
row1 : 
row2 : 


gtk_clist_set_compare_func ()

void        gtk_clist_set_compare_func      (GtkCList *clist,
                                             GtkCListCompareFunc cmp_func);

clist :The GtkCList to affect.
cmp_func : 


gtk_clist_set_sort_column ()

void        gtk_clist_set_sort_column       (GtkCList *clist,
                                             gint column);

clist :The GtkCList to affect.
column : 


gtk_clist_set_sort_type ()

void        gtk_clist_set_sort_type         (GtkCList *clist,
                                             GtkSortType sort_type);

clist :The GtkCList to affect.
sort_type : 


gtk_clist_sort ()

void        gtk_clist_sort                  (GtkCList *clist);

clist :The GtkCList to affect.


gtk_clist_set_auto_sort ()

void        gtk_clist_set_auto_sort         (GtkCList *clist,
                                             gboolean auto_sort);

clist :The GtkCList to affect.
auto_sort : 


gtk_clist_columns_autosize ()

gint        gtk_clist_columns_autosize      (GtkCList *clist);

clist :The GtkCList to affect.
Returns : 


gtk_clist_get_column_title ()

gchar*      gtk_clist_get_column_title      (GtkCList *clist,
                                             gint column);

clist : 
column : 
Returns : 


gtk_clist_get_column_widget ()

GtkWidget*  gtk_clist_get_column_widget     (GtkCList *clist,
                                             gint column);

clist : 
column : 
Returns : 


gtk_clist_get_hadjustment ()

GtkAdjustment* gtk_clist_get_hadjustment    (GtkCList *clist);

clist : 
Returns : 


gtk_clist_get_vadjustment ()

GtkAdjustment* gtk_clist_get_vadjustment    (GtkCList *clist);

Gets the GtkAdjustment currently being used for the vertical aspect.

clist :The GtkCList to check.
Returns :A GtkAdjustment widget, or NULL if none is currently being used.


gtk_clist_row_move ()

void        gtk_clist_row_move              (GtkCList *clist,
                                             gint source_row,
                                             gint dest_row);

Allows you to move a row from one position to another in the list.

clist :The GtkCList to affect.
source_row : 
dest_row : 


gtk_clist_set_button_actions ()

void        gtk_clist_set_button_actions    (GtkCList *clist,
                                             guint button,
                                             guint8 button_actions);

clist :The GtkCList to affect.
button : 
button_actions : 


gtk_clist_set_hadjustment ()

void        gtk_clist_set_hadjustment       (GtkCList *clist,
                                             GtkAdjustment *adjustment);

Allows you to set the GtkAdjustment to be used for the horizontal aspect of the GtkCList widget.

clist :The GtkCList to affect.
adjustment :A pointer to a GtkAdjustment widget, or NULL.


gtk_clist_set_reorderable ()

void        gtk_clist_set_reorderable       (GtkCList *clist,
                                             gboolean reorderable);

clist : 
reorderable : 


gtk_clist_set_use_drag_icons ()

void        gtk_clist_set_use_drag_icons    (GtkCList *clist,
                                             gboolean use_icons);

Determines whether the GtkClist should use icons when doing drag-and-drop operations.

clist :The GtkCList to affect.
use_icons :TRUE or FALSE.


gtk_clist_set_vadjustment ()

void        gtk_clist_set_vadjustment       (GtkCList *clist,
                                             GtkAdjustment *adjustment);

Allows you to set the GtkAdjustment to be used for the vertical aspect of the GtkCList widget.

clist :The GtkCList to affect.
adjustment :A pointer to a GtkAdjustment widget, or NULL.

Args

"n_columns" (guint : Read / Write / Construct Only)

"shadow_type" (GtkShadowType : Read / Write)

"selection_mode" (GtkSelectionMode : Read / Write)

"row_height" (guint : Read / Write)

"reorderable" (gboolean : Read / Write)

"titles_active" (gboolean : Read / Write)

"use_drag_icons" (gboolean : Read / Write)

Signals

The "select-row" signal

void        user_function                  (GtkCList *clist,
                                            gint row,
                                            gint column,
                                            GdkEventButton *event,
                                            gpointer user_data);

clist :the object which received the signal.
row : 
column : 
event : 
user_data :user data set when the signal handler was connected.


The "unselect-row" signal

void        user_function                  (GtkCList *clist,
                                            gint row,
                                            gint column,
                                            GdkEventButton *event,
                                            gpointer user_data);

clist :the object which received the signal.
row : 
column : 
event : 
user_data :user data set when the signal handler was connected.


The "row-move" signal

void        user_function                  (GtkCList *clist,
                                            gint arg1,
                                            gint arg2,
                                            gpointer user_data);

clist :the object which received the signal.
arg1 : 
arg2 : 
user_data :user data set when the signal handler was connected.


The "click-column" signal

void        user_function                  (GtkCList *clist,
                                            gint column,
                                            gpointer user_data);

clist :the object which received the signal.
column : 
user_data :user data set when the signal handler was connected.


The "resize-column" signal

void        user_function                  (GtkCList *clist,
                                            gint column,
                                            gint width,
                                            gpointer user_data);

clist :the object which received the signal.
column : 
width : 
user_data :user data set when the signal handler was connected.


The "toggle-focus-row" signal

void        user_function                  (GtkCList *clist,
                                            gpointer user_data);

clist :the object which received the signal.
user_data :user data set when the signal handler was connected.


The "select-all" signal

void        user_function                  (GtkCList *clist,
                                            gpointer user_data);

clist :the object which received the signal.
user_data :user data set when the signal handler was connected.


The "unselect-all" signal

void        user_function                  (GtkCList *clist,
                                            gpointer user_data);

clist :the object which received the signal.
user_data :user data set when the signal handler was connected.


The "undo-selection" signal

void        user_function                  (GtkCList *clist,
                                            gpointer user_data);

clist :the object which received the signal.
user_data :user data set when the signal handler was connected.


The "start-selection" signal

void        user_function                  (GtkCList *clist,
                                            gpointer user_data);

clist :the object which received the signal.
user_data :user data set when the signal handler was connected.


The "end-selection" signal

void        user_function                  (GtkCList *clist,
                                            gpointer user_data);

clist :the object which received the signal.
user_data :user data set when the signal handler was connected.


The "toggle-add-mode" signal

void        user_function                  (GtkCList *clist,
                                            gpointer user_data);

clist :the object which received the signal.
user_data :user data set when the signal handler was connected.


The "extend-selection" signal

void        user_function                  (GtkCList *clist,
                                            GtkScrollType scroll_type,
                                            gfloat position,
                                            gboolean auto_start_selection,
                                            gpointer user_data);

clist :the object which received the signal.
scroll_type : 
position : 
auto_start_selection : 
user_data :user data set when the signal handler was connected.


The "scroll-vertical" signal

void        user_function                  (GtkCList *clist,
                                            GtkScrollType scroll_type,
                                            gfloat position,
                                            gpointer user_data);

clist :the object which received the signal.
scroll_type : 
position : 
user_data :user data set when the signal handler was connected.


The "scroll-horizontal" signal

void        user_function                  (GtkCList *clist,
                                            GtkScrollType scroll_type,
                                            gfloat position,
                                            gpointer user_data);

clist :the object which received the signal.
scroll_type : 
position :a value between 0.0 and 1.0.
user_data :user data set when the signal handler was connected.


The "abort-column-resize" signal

void        user_function                  (GtkCList *clist,
                                            gpointer user_data);

clist :the object which received the signal.
user_data :user data set when the signal handler was connected.