Synopsis#include <gtk/gtk.h> 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_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); GtkCListColumn; GtkCListRow; GtkCellText; GtkCellPixmap; GtkCellPixText; GtkCellWidget; GtkCell; GtkCListCellInfo; GtkCListDestInfo; enum GtkCListDragPos; 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, const GdkColor *color); void gtk_clist_set_background (GtkCList *clist, gint row, const 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, GDestroyNotify 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 HierarchyGObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkCList +----GtkCTree Properties"n-columns" guint : Read / Write / Construct Only "reorderable" gboolean : Read / Write "row-height" guint : Read / Write "selection-mode" GtkSelectionMode : Read / Write "shadow-type" GtkShadowType : Read / Write "sort-type" GtkSortType : Read / Write "titles-active" gboolean : Read / Write "use-drag-icons" gboolean : Read / Write Signals"abort-column-resize" : Run Last / Action "click-column" : Run First "end-selection" : Run Last / Action "extend-selection" : Run Last / Action "resize-column" : Run Last "row-move" : Run Last "scroll-horizontal" : Run Last / Action "scroll-vertical" : Run Last / Action "select-all" : Run Last / Action "select-row" : Run First "set-scroll-adjustments" : Run Last "start-selection" : Run Last / Action "toggle-add-mode" : Run Last / Action "toggle-focus-row" : Run Last / Action "undo-selection" : Run Last / Action "unselect-all" : Run Last / Action "unselect-row" : Run First DescriptionThe 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. GtkCList has been deprecated since GTK+ 2.0 and should not be used in newly written code. Use GtkTreeView instead. DetailsGtkCListtypedef struct _GtkCList GtkCList; Warning
This is the embodiment of the GtkCList widget. This structure contains only private data, and should be accessed only via the CList API. enum GtkCellTypetypedef enum { GTK_CELL_EMPTY, GTK_CELL_TEXT, GTK_CELL_PIXMAP, GTK_CELL_PIXTEXT, GTK_CELL_WIDGET } GtkCellType; Warning
Identifies the type of element in the current cell of the CList. Cells can
contain text, pixmaps, or both. Unfortunately support for enum GtkButtonActiontypedef enum { GTK_BUTTON_IGNORED = 0, GTK_BUTTON_SELECTS = 1 << 0, GTK_BUTTON_DRAGS = 1 << 1, GTK_BUTTON_EXPANDS = 1 << 2 } GtkButtonAction; Warning
Values for specifying what mouse button events a CList will react to. GTK_CLIST_FLAGS()#define GTK_CLIST_FLAGS(clist) (GTK_CLIST (clist)->flags) Warning
Reads the current flags of the specified CList.
GTK_CLIST_SET_FLAG()#define GTK_CLIST_SET_FLAG(clist,flag) (GTK_CLIST_FLAGS (clist) |= (GTK_ ## flag)) Warning
A macro to set a particular flag for the specified CList. GTK_CLIST_UNSET_FLAG()#define GTK_CLIST_UNSET_FLAG(clist,flag) (GTK_CLIST_FLAGS (clist) &= ~(GTK_ ## flag)) Warning
A macro to clear a particular flag for the specified CList. GTK_CLIST_IN_DRAG()#define GTK_CLIST_IN_DRAG(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_IN_DRAG) Warning
A macro to check whether the GtkCList is in "drag mode."
GTK_CLIST_ROW_HEIGHT_SET()#define GTK_CLIST_ROW_HEIGHT_SET(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_ROW_HEIGHT_SET) Warning
A macro to check whether the GtkCList's row height is set.
GTK_CLIST_SHOW_TITLES()#define GTK_CLIST_SHOW_TITLES(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_SHOW_TITLES) Warning
A macro to check whether the flag for showing the widget's column titles is set.
GTK_CLIST_ADD_MODE()#define GTK_CLIST_ADD_MODE(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_ADD_MODE) Warning
A macro to test whether the CList is in "add mode."
GTK_CLIST_AUTO_SORT()#define GTK_CLIST_AUTO_SORT(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_AUTO_SORT) Warning
A macro to test whether the CList has automatic sorting switched on.
GTK_CLIST_AUTO_RESIZE_BLOCKED()#define GTK_CLIST_AUTO_RESIZE_BLOCKED(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_AUTO_RESIZE_BLOCKED) Warning
A macro to check if automatic resizing of columns is blocked.
GTK_CLIST_REORDERABLE()#define GTK_CLIST_REORDERABLE(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_REORDERABLE) Warning
A macro to test if the CList's columns are re-orderable
GTK_CLIST_USE_DRAG_ICONS()#define GTK_CLIST_USE_DRAG_ICONS(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_USE_DRAG_ICONS) Warning
A macro to check if the USE_DRAG_ICONS property is enabled.
GTK_CLIST_DRAW_DRAG_LINE()#define GTK_CLIST_DRAW_DRAG_LINE(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_DRAW_DRAG_LINE) Warning
A macro to check if the DRAW_DRAG_LINE property is enabled.
GTK_CLIST_DRAW_DRAG_RECT()#define GTK_CLIST_DRAW_DRAG_RECT(clist) (GTK_CLIST_FLAGS (clist) & GTK_CLIST_DRAW_DRAG_RECT) Warning
A macro to check if the DRAW_DRAG_RECT property is enabled.
GTK_CLIST_ROW()#define GTK_CLIST_ROW(_glist_) ((GtkCListRow *)((_glist_)->data)) Warning
A macro to cast a GList element to a CListRow pointer.
GTK_CELL_TEXT()#define GTK_CELL_TEXT(cell) (((GtkCellText *) &(cell))) Warning
A macro to cast a generic GtkCList cell item to a GtkCellText pointer.
GTK_CELL_PIXMAP()#define GTK_CELL_PIXMAP(cell) (((GtkCellPixmap *) &(cell))) Warning
A macro to cast a generic GtkCList cell item to a GtkCellPixmap pointer.
GTK_CELL_PIXTEXT()#define GTK_CELL_PIXTEXT(cell) (((GtkCellPixText *) &(cell))) Warning
A macro to cast a generic GtkCList cell item to a GtkCellPixText pointer.
GTK_CELL_WIDGET()#define GTK_CELL_WIDGET(cell) (((GtkCellWidget *) &(cell))) Warning
A macro to cast a generic GtkCList cell item to a GtkCellWidget pointer.
GtkCListCompareFunc ()gint (*GtkCListCompareFunc) (GtkCList *clist, gconstpointer ptr1, gconstpointer ptr2); Warning
Function prototype for the compare function callback.
GtkCListColumntypedef struct { gchar *title; GdkRectangle area; GtkWidget *button; GdkWindow *window; gint width; gint min_width; gint max_width; GtkJustification justification; guint visible : 1; guint width_set : 1; guint resizeable : 1; guint auto_resize : 1; guint button_passive : 1; } GtkCListColumn; Warning
A structure that the GtkCList widget uses to keep track of information about its columns. GtkCListRowtypedef struct { GtkCell *cell; GtkStateType state; GdkColor foreground; GdkColor background; GtkStyle *style; gpointer data; GDestroyNotify destroy; guint fg_set : 1; guint bg_set : 1; guint selectable : 1; } GtkCListRow; Warning
A structure that the GtkCList widget uses to keep track of information about its rows. GtkCellTexttypedef struct { GtkCellType type; gint16 vertical; gint16 horizontal; GtkStyle *style; gchar *text; } GtkCellText; Warning
A structure that the GtkCList widget uses to keep track of GtkCList cells that contain text. GtkCellPixmaptypedef struct { GtkCellType type; gint16 vertical; gint16 horizontal; GtkStyle *style; GdkPixmap *pixmap; GdkBitmap *mask; } GtkCellPixmap; Warning
A structure that the GtkCList widget uses to keep track of GtkCList cells that contain a GdkPixmap. GtkCellPixTexttypedef struct { GtkCellType type; gint16 vertical; gint16 horizontal; GtkStyle *style; gchar *text; guint8 spacing; GdkPixmap *pixmap; GdkBitmap *mask; } GtkCellPixText; Warning
A structure that the GtkCList widget uses to keep track of GtkCList cells that contain a combination of text and a GdkPixmap. GtkCellWidgettypedef struct { GtkCellType type; gint16 vertical; gint16 horizontal; GtkStyle *style; GtkWidget *widget; } GtkCellWidget; Warning
A structure that the GtkCList widget uses to keep track of GtkCList cells that contain another widget. GtkCelltypedef struct { GtkCellType type; gint16 vertical; gint16 horizontal; GtkStyle *style; union { gchar *text; struct { GdkPixmap *pixmap; GdkBitmap *mask; } pm; struct { gchar *text; guint8 spacing; GdkPixmap *pixmap; GdkBitmap *mask; } pt; GtkWidget *widget; } u; } GtkCell; Warning
A generic structure that the GtkCList widget uses to keep track of the contents of each of its cells. GtkCListCellInfotypedef struct { gint row; gint column; } GtkCListCellInfo; Warning
A simple structure that the GtkCList widget uses to keep track of the location of a cell. GtkCListDestInfotypedef struct { GtkCListCellInfo cell; GtkCListDragPos insert_pos; } GtkCListDestInfo; Warning
A simple structure that the GtkCList widget uses to track a cell for a drag operation. enum GtkCListDragPostypedef enum { GTK_CLIST_DRAG_NONE, GTK_CLIST_DRAG_BEFORE, GTK_CLIST_DRAG_INTO, GTK_CLIST_DRAG_AFTER } GtkCListDragPos; Warning
An enumeration for drag operations. gtk_clist_new ()GtkWidget* gtk_clist_new (gint columns); Warning
Creates a new GtkCList widget for use.
gtk_clist_new_with_titles ()GtkWidget* gtk_clist_new_with_titles (gint columns, gchar *titles[]); Warning
Creates a new GtkCList widget with column titles for use.
gtk_clist_set_shadow_type ()void gtk_clist_set_shadow_type (GtkCList *clist, GtkShadowType type); Warning
Sets the shadow type for the specified CList. Changing this value will cause the GtkCList to update its visuals.
gtk_clist_set_selection_mode ()void gtk_clist_set_selection_mode (GtkCList *clist, GtkSelectionMode mode); Warning
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.
gtk_clist_freeze ()void gtk_clist_freeze (GtkCList *clist); Warning
Causes the GtkCList to stop updating its visuals until a matching call to
gtk_clist_thaw ()void gtk_clist_thaw (GtkCList *clist); Warning
Causes the specified GtkCList to allow visual updates.
gtk_clist_column_titles_show ()void gtk_clist_column_titles_show (GtkCList *clist); Warning
This function causes the GtkCList to show its column titles, if they are not already showing.
gtk_clist_column_titles_hide ()void gtk_clist_column_titles_hide (GtkCList *clist); Warning
Causes the GtkCList to hide its column titles, if they are currently showing.
gtk_clist_column_title_active ()void gtk_clist_column_title_active (GtkCList *clist, gint column); Warning
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.
gtk_clist_column_title_passive ()void gtk_clist_column_title_passive (GtkCList *clist, gint column); Warning
Causes the specified column title button to become passive, i.e., does not respond to events, such as the user clicking on it.
gtk_clist_column_titles_active ()void gtk_clist_column_titles_active (GtkCList *clist); Warning
Causes all column title buttons to become active. This is the same
as calling
gtk_clist_column_titles_passive ()void gtk_clist_column_titles_passive (GtkCList *clist); Warning
Causes all column title buttons to become passive. This is the same
as calling
gtk_clist_set_column_title ()void gtk_clist_set_column_title (GtkCList *clist, gint column, const gchar *title); Warning
Sets the title for the specified column.
gtk_clist_set_column_widget ()void gtk_clist_set_column_widget (GtkCList *clist, gint column, GtkWidget *widget); Warning
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.
gtk_clist_set_column_justification ()void gtk_clist_set_column_justification (GtkCList *clist, gint column, GtkJustification justification); Warning
Sets the justification to be used for all text in the specified column.
gtk_clist_set_column_visibility ()void gtk_clist_set_column_visibility (GtkCList *clist, gint column, gboolean visible); Warning
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.
gtk_clist_set_column_resizeable ()void gtk_clist_set_column_resizeable (GtkCList *clist, gint column, gboolean resizeable); Warning
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 ()void gtk_clist_set_column_auto_resize (GtkCList *clist, gint column, gboolean auto_resize); Warning
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.
gtk_clist_optimal_column_width ()gint gtk_clist_optimal_column_width (GtkCList *clist, gint column); Warning
Gets the required width in pixels that is needed to show everything in the specified column.
gtk_clist_set_column_width ()void gtk_clist_set_column_width (GtkCList *clist, gint column, gint width); Warning
Causes the column specified for the GtkCList to be set to a specified width.
gtk_clist_set_column_min_width ()void gtk_clist_set_column_min_width (GtkCList *clist, gint column, gint min_width); Warning
Causes the column specified to have a minimum width, preventing the user from resizing it smaller than that specified.
gtk_clist_set_column_max_width ()void gtk_clist_set_column_max_width (GtkCList *clist, gint column, gint max_width); Warning
Causes the column specified to have a maximum width, preventing the user from resizing it larger than that specified.
gtk_clist_set_row_height ()void gtk_clist_set_row_height (GtkCList *clist, guint height); Warning
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.
gtk_clist_moveto ()void gtk_clist_moveto (GtkCList *clist, gint row, gint column, gfloat row_align, gfloat col_align); Warning
Tells the CList widget to visually move to the specified row and column.
gtk_clist_row_is_visible ()GtkVisibility gtk_clist_row_is_visible (GtkCList *clist, gint row); Warning
Checks how the specified row is visible.
gtk_clist_get_cell_type ()GtkCellType gtk_clist_get_cell_type (GtkCList *clist, gint row, gint column); Warning
Checks the type of cell at the location specified.
gtk_clist_set_text ()void gtk_clist_set_text (GtkCList *clist, gint row, gint column, const gchar *text); Warning
Sets the displayed text in the specified cell.
gtk_clist_get_text ()gint gtk_clist_get_text (GtkCList *clist, gint row, gint column, gchar **text); Warning
Gets the text for the specified cell.
gtk_clist_set_pixmap ()void gtk_clist_set_pixmap (GtkCList *clist, gint row, gint column, GdkPixmap *pixmap, GdkBitmap *mask); Warning
Sets a pixmap for the specified cell.
gtk_clist_get_pixmap ()gint gtk_clist_get_pixmap (GtkCList *clist, gint row, gint column, GdkPixmap **pixmap, GdkBitmap **mask); Warning
Gets the pixmap and bitmap mask of the specified cell. The returned mask value can be NULL.
gtk_clist_set_pixtext ()void gtk_clist_set_pixtext (GtkCList *clist, gint row, gint column, const gchar *text, guint8 spacing, GdkPixmap *pixmap, GdkBitmap *mask); Warning
Sets text and a pixmap/bitmap on the specified cell.
gtk_clist_get_pixtext ()gint gtk_clist_get_pixtext (GtkCList *clist, gint row, gint column, gchar **text, guint8 *spacing, GdkPixmap **pixmap, GdkBitmap **mask); Warning
Gets the text, pixmap and bitmap mask for the specified cell.
gtk_clist_set_foreground ()void gtk_clist_set_foreground (GtkCList *clist, gint row, const GdkColor *color); Warning
Sets the foreground color for the specified row.
gtk_clist_set_background ()void gtk_clist_set_background (GtkCList *clist, gint row, const GdkColor *color); Warning
Sets the background color for the specified row.
gtk_clist_set_cell_style ()void gtk_clist_set_cell_style (GtkCList *clist, gint row, gint column, GtkStyle *style); Warning
Sets the style for the specified cell. gtk_clist_get_cell_style ()GtkStyle* gtk_clist_get_cell_style (GtkCList *clist, gint row, gint column); Warning
Gets the current style of the specified cell. gtk_clist_set_row_style ()void gtk_clist_set_row_style (GtkCList *clist, gint row, GtkStyle *style); Warning
Sets the style for all cells in the specified row. gtk_clist_get_row_style ()GtkStyle* gtk_clist_get_row_style (GtkCList *clist, gint row); Warning
Gets the style set for the specified row. gtk_clist_set_shift ()void gtk_clist_set_shift (GtkCList *clist, gint row, gint column, gint vertical, gint horizontal); Warning
Sets the vertical and horizontal shift of the specified cell.
gtk_clist_set_selectable ()void gtk_clist_set_selectable (GtkCList *clist, gint row, gboolean selectable); Warning
Sets whether the specified row is selectable or not.
gtk_clist_get_selectable ()gboolean gtk_clist_get_selectable (GtkCList *clist, gint row); Warning
Gets whether the specified row is selectable or not.
gtk_clist_prepend ()gint gtk_clist_prepend (GtkCList *clist, gchar *text[]); Warning
Adds a row to the CList at the top.
gtk_clist_append ()gint gtk_clist_append (GtkCList *clist, gchar *text[]); Warning
Adds a row to the CList at the bottom.
gtk_clist_insert ()gint gtk_clist_insert (GtkCList *clist, gint row, gchar *text[]); Warning
Adds a row of text to the CList at the specified position.
gtk_clist_remove ()void gtk_clist_remove (GtkCList *clist, gint row); Warning
Removes the specified row from the CList.
gtk_clist_set_row_data ()void gtk_clist_set_row_data (GtkCList *clist, gint row, gpointer data); Warning
Sets data for the specified row. This is the same as calling gtk_clist_set_row_data_full(clist, row, data, NULL).
gtk_clist_set_row_data_full ()void gtk_clist_set_row_data_full (GtkCList *clist, gint row, gpointer data, GDestroyNotify destroy); Warning
Sets the data for specified row, with a callback when the row is destroyed.
gtk_clist_get_row_data ()gpointer gtk_clist_get_row_data (GtkCList *clist, gint row); Warning
Gets the currently set data for the specified row.
gtk_clist_find_row_from_data ()gint gtk_clist_find_row_from_data (GtkCList *clist, gpointer data); Warning
Searches the CList for the row with the specified data.
gtk_clist_select_row ()void gtk_clist_select_row (GtkCList *clist, gint row, gint column); Warning
Selects the specified row. Causes the "select-row" signal to be emitted for the specified row and column.
gtk_clist_unselect_row ()void gtk_clist_unselect_row (GtkCList *clist, gint row, gint column); Warning
Unselects the specified row. Causes the "unselect-row" signal to be emitted for the specified row and column.
gtk_clist_undo_selection ()void gtk_clist_undo_selection (GtkCList *clist); Warning
Undoes the last selection for an "extended selection mode" CList.
gtk_clist_clear ()void gtk_clist_clear (GtkCList *clist); Warning
Removes all the CList's rows.
gtk_clist_get_selection_info ()gint gtk_clist_get_selection_info (GtkCList *clist, gint x, gint y, gint *row, gint *column); Warning
Gets the row and column at the specified pixel position in the CList.
gtk_clist_select_all ()void gtk_clist_select_all (GtkCList *clist); Warning
Selects all rows in the CList. This function has no affect for a CList in "single" or "browse" selection mode.
gtk_clist_unselect_all ()void gtk_clist_unselect_all (GtkCList *clist); Warning
Unselects all rows in the CList.
gtk_clist_swap_rows ()void gtk_clist_swap_rows (GtkCList *clist, gint row1, gint row2); Warning
Swaps the two specified rows with each other.
gtk_clist_set_compare_func ()void gtk_clist_set_compare_func (GtkCList *clist, GtkCListCompareFunc cmp_func); Warning
Sets the compare function of the GtkClist to
gtk_clist_set_sort_column ()void gtk_clist_set_sort_column (GtkCList *clist, gint column); Warning
Sets the sort column of the clist. The sort column is used by the default compare function to determine which column to sort by.
gtk_clist_set_sort_type ()void gtk_clist_set_sort_type (GtkCList *clist, GtkSortType sort_type); Warning
Sets the sort type of the GtkClist. This is either GTK_SORT_ASCENDING for ascening sort or GTK_SORT_DESCENDING for descending sort.
gtk_clist_sort ()void gtk_clist_sort (GtkCList *clist); Warning
Sorts the GtkClist according to the current compare function, which
can be set with the
gtk_clist_set_auto_sort ()void gtk_clist_set_auto_sort (GtkCList *clist, gboolean auto_sort); Warning
Turns on or off auto sort of the GtkCList. If auto sort is on, then the CList will be resorted when a row is inserted into the CList.
gtk_clist_columns_autosize ()gint gtk_clist_columns_autosize (GtkCList *clist); Warning
Auto-sizes all columns in the CList and returns the total width of the CList.
gtk_clist_get_column_title ()gchar* gtk_clist_get_column_title (GtkCList *clist, gint column); Warning
Gets the current title of the specified column
gtk_clist_get_column_widget ()GtkWidget* gtk_clist_get_column_widget (GtkCList *clist, gint column); Warning
Gets the widget in the column header for the specified column. gtk_clist_get_hadjustment ()GtkAdjustment* gtk_clist_get_hadjustment (GtkCList *clist); Warning
Gets the GtkAdjustment currently being used for the horizontal aspect.
gtk_clist_get_vadjustment ()GtkAdjustment* gtk_clist_get_vadjustment (GtkCList *clist); Warning
Gets the GtkAdjustment currently being used for the vertical aspect.
gtk_clist_row_move ()void gtk_clist_row_move (GtkCList *clist, gint source_row, gint dest_row); Warning
Allows you to move a row from one position to another in the list.
gtk_clist_set_button_actions ()void gtk_clist_set_button_actions (GtkCList *clist, guint button, guint8 button_actions); Warning
Sets the action(s) that the specified mouse button will have on the CList.
gtk_clist_set_hadjustment ()void gtk_clist_set_hadjustment (GtkCList *clist, GtkAdjustment *adjustment); Warning
Allows you to set the GtkAdjustment to be used for the horizontal aspect of the GtkCList widget.
gtk_clist_set_reorderable ()void gtk_clist_set_reorderable (GtkCList *clist, gboolean reorderable); Warning
Sets whether the CList's rows are re-orderable using drag-and-drop.
gtk_clist_set_use_drag_icons ()void gtk_clist_set_use_drag_icons (GtkCList *clist, gboolean use_icons); Warning
Determines whether the GtkClist should use icons when doing drag-and-drop operations.
gtk_clist_set_vadjustment ()void gtk_clist_set_vadjustment (GtkCList *clist, GtkAdjustment *adjustment); Warning
Allows you to set the GtkAdjustment to be used for the vertical aspect of the GtkCList widget.
Property DetailsThe
|
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"click-column"
signalvoid user_function (GtkCList *clist, gint column, gpointer user_data) : Run First
This signal is emitted when a column title is clicked.
|
The object which received the signal. |
|
The number of the column. |
|
user data set when the signal handler was connected. |
"end-selection"
signalvoid user_function (GtkCList *clist, gpointer user_data) : Run Last / Action
This signal is emitted when a selection ends in a multiple selection CList.
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"extend-selection"
signalvoid user_function (GtkCList *clist, GtkScrollType scroll_type, gfloat position, gboolean auto_start_selection, gpointer user_data) : Run Last / Action
This signal is emitted when the selection is extended.
|
the object which received the signal. |
|
A GtkScrollType value of any scrolling operation the occured during the selection. |
|
A value between 0.0 and 1.0. |
|
TRUE or FALSE .
|
|
user data set when the signal handler was connected. |
"resize-column"
signalvoid user_function (GtkCList *clist, gint column, gint width, gpointer user_data) : Run Last
This signal is emitted when a column is resized.
|
The object which received the signal. |
|
The number of the column |
|
The new width of the column. |
|
user data set when the signal handler was connected. |
"row-move"
signalvoid user_function (GtkCList *clist, gint arg1, gint arg2, gpointer user_data) : Run Last
This signal is emitted when a row is moved.
|
The object which received the signal. |
|
The source position of the row. |
|
The destination position of the row. |
|
user data set when the signal handler was connected. |
"scroll-horizontal"
signalvoid user_function (GtkCList *clist, GtkScrollType scroll_type, gfloat position, gpointer user_data) : Run Last / Action
This signal is emitted when the CList is scrolled horizontally.
|
the object which received the signal. |
|
A GtkScrollType value of how the scroll operation occured. |
|
a value between 0.0 and 1.0. |
|
user data set when the signal handler was connected. |
"scroll-vertical"
signalvoid user_function (GtkCList *clist, GtkScrollType scroll_type, gfloat position, gpointer user_data) : Run Last / Action
This signal is emitted when the CList is scrolled vertically.
|
the object which received the signal. |
|
A GtkScrollType value of how the scroll operation occured. |
|
A value between 0.0 and 1.0. |
|
user data set when the signal handler was connected. |
"select-all"
signalvoid user_function (GtkCList *clist, gpointer user_data) : Run Last / Action
This signal is emitted when all the rows are selected in a CList.
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"select-row"
signalvoid user_function (GtkCList *clist, gint row, gint column, GdkEventButton *event, gpointer user_data) : Run First
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 gtk_clist_select_all()
.
|
The object which received the signal. |
|
The row selected. |
|
The column where the selection occured. |
|
A GdkEvent structure for the selection. |
|
user data set when the signal handler was connected. |
"set-scroll-adjustments"
signalvoid user_function (GtkCList *clist, GtkAdjustment *arg1, GtkAdjustment *arg2, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
user data set when the signal handler was connected. |
"start-selection"
signalvoid user_function (GtkCList *clist, gpointer user_data) : Run Last / Action
This signal is emitted when a drag-selection is started in a multiple-selection CList.
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"toggle-add-mode"
signalvoid user_function (GtkCList *clist, gpointer user_data) : Run Last / Action
This signal is emitted when "add mode" is toggled.
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"toggle-focus-row"
signalvoid user_function (GtkCList *clist, gpointer user_data) : Run Last / Action
|
The object which received the signal. |
|
user data set when the signal handler was connected. |
"undo-selection"
signalvoid user_function (GtkCList *clist, gpointer user_data) : Run Last / Action
This signal is emitted when an undo selection occurs in the CList,
probably via calling gtk_clist_undo_selection()
.
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"unselect-all"
signalvoid user_function (GtkCList *clist, gpointer user_data) : Run Last / Action
This signal is emitted when all rows are unselected in a CList.
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
"unselect-row"
signalvoid user_function (GtkCList *clist, gint row, gint column, GdkEventButton *event, gpointer user_data) : Run First
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 gtk_clist_unselect_all()
. It is also emitted for the
previously selected row in a "single" or "browse" mode CList.
|
The object which received the signal. |
|
The selected row |
|
The column where the selection occured. |
|
|
|
user data set when the signal handler was connected. |