Synopsis#include <gtk/gtk.h> enum GtkTreeViewColumnSizing; void (*GtkTreeCellDataFunc) (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell, GtkTreeModel *tree_model, GtkTreeIter *iter, gpointer data); GtkTreeViewColumn; GtkTreeViewColumn* gtk_tree_view_column_new (void); GtkTreeViewColumn* gtk_tree_view_column_new_with_attributes (const gchar *title, GtkCellRenderer *cell, ...); void gtk_tree_view_column_pack_start (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell, gboolean expand); void gtk_tree_view_column_pack_end (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell, gboolean expand); void gtk_tree_view_column_clear (GtkTreeViewColumn *tree_column); GList* gtk_tree_view_column_get_cell_renderers (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_add_attribute (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, const gchar *attribute, gint column); void gtk_tree_view_column_set_attributes (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, ...); void gtk_tree_view_column_set_cell_data_func (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, GtkTreeCellDataFunc func, gpointer func_data, GDestroyNotify destroy); void gtk_tree_view_column_clear_attributes (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer); void gtk_tree_view_column_set_spacing (GtkTreeViewColumn *tree_column, gint spacing); gint gtk_tree_view_column_get_spacing (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_visible (GtkTreeViewColumn *tree_column, gboolean visible); gboolean gtk_tree_view_column_get_visible (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_resizable (GtkTreeViewColumn *tree_column, gboolean resizable); gboolean gtk_tree_view_column_get_resizable (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_sizing (GtkTreeViewColumn *tree_column, GtkTreeViewColumnSizing type); GtkTreeViewColumnSizing gtk_tree_view_column_get_sizing (GtkTreeViewColumn *tree_column); gint gtk_tree_view_column_get_width (GtkTreeViewColumn *tree_column); gint gtk_tree_view_column_get_fixed_width (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_fixed_width (GtkTreeViewColumn *tree_column, gint fixed_width); void gtk_tree_view_column_set_min_width (GtkTreeViewColumn *tree_column, gint min_width); gint gtk_tree_view_column_get_min_width (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_max_width (GtkTreeViewColumn *tree_column, gint max_width); gint gtk_tree_view_column_get_max_width (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_clicked (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_title (GtkTreeViewColumn *tree_column, const gchar *title); const gchar* gtk_tree_view_column_get_title (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_expand (GtkTreeViewColumn *tree_column, gboolean expand); gboolean gtk_tree_view_column_get_expand (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_clickable (GtkTreeViewColumn *tree_column, gboolean clickable); gboolean gtk_tree_view_column_get_clickable (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_widget (GtkTreeViewColumn *tree_column, GtkWidget *widget); GtkWidget* gtk_tree_view_column_get_widget (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_alignment (GtkTreeViewColumn *tree_column, gfloat xalign); gfloat gtk_tree_view_column_get_alignment (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_reorderable (GtkTreeViewColumn *tree_column, gboolean reorderable); gboolean gtk_tree_view_column_get_reorderable (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_sort_column_id (GtkTreeViewColumn *tree_column, gint sort_column_id); gint gtk_tree_view_column_get_sort_column_id (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_sort_indicator (GtkTreeViewColumn *tree_column, gboolean setting); gboolean gtk_tree_view_column_get_sort_indicator (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_set_sort_order (GtkTreeViewColumn *tree_column, GtkSortType order); GtkSortType gtk_tree_view_column_get_sort_order (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_cell_set_cell_data (GtkTreeViewColumn *tree_column, GtkTreeModel *tree_model, GtkTreeIter *iter, gboolean is_expander, gboolean is_expanded); void gtk_tree_view_column_cell_get_size (GtkTreeViewColumn *tree_column, const GdkRectangle *cell_area, gint *x_offset, gint *y_offset, gint *width, gint *height); gboolean gtk_tree_view_column_cell_get_position (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, gint *start_pos, gint *width); gboolean gtk_tree_view_column_cell_is_visible (GtkTreeViewColumn *tree_column); void gtk_tree_view_column_focus_cell (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell); void gtk_tree_view_column_queue_resize (GtkTreeViewColumn *tree_column); GtkWidget* gtk_tree_view_column_get_tree_view (GtkTreeViewColumn *tree_column); Properties"alignment" gfloat : Read / Write "clickable" gboolean : Read / Write "expand" gboolean : Read / Write "fixed-width" gint : Read / Write "max-width" gint : Read / Write "min-width" gint : Read / Write "reorderable" gboolean : Read / Write "resizable" gboolean : Read / Write "sizing" GtkTreeViewColumnSizing : Read / Write "sort-indicator" gboolean : Read / Write "sort-order" GtkSortType : Read / Write "spacing" gint : Read / Write "title" gchar* : Read / Write "visible" gboolean : Read / Write "widget" GtkWidget* : Read / Write "width" gint : Read DescriptionThe GtkTreeViewColumn object represents a visible column in a GtkTreeView widget. It allows to set properties of the column header, and functions as a holding pen for the cell renderers which determine how the data in the column is displayed. Please refer to the tree widget conceptual overview for an overview of all the objects and data types related to the tree widget and how they work together. Detailsenum GtkTreeViewColumnSizingtypedef enum { GTK_TREE_VIEW_COLUMN_GROW_ONLY, GTK_TREE_VIEW_COLUMN_AUTOSIZE, GTK_TREE_VIEW_COLUMN_FIXED } GtkTreeViewColumnSizing;
The sizing method the column uses to determine its width. Please note
that GtkTreeCellDataFunc ()void (*GtkTreeCellDataFunc) (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell, GtkTreeModel *tree_model, GtkTreeIter *iter, gpointer data);
A function to set the properties of a cell instead of just using the
straight mapping between the cell and the model. This is useful for
customizing the cell renderer. For example, a function might get an
integer from the
gtk_tree_view_column_new ()GtkTreeViewColumn* gtk_tree_view_column_new (void); Creates a new GtkTreeViewColumn.
gtk_tree_view_column_new_with_attributes ()GtkTreeViewColumn* gtk_tree_view_column_new_with_attributes (const gchar *title, GtkCellRenderer *cell, ...);
Creates a new GtkTreeViewColumn with a number of default values. This is
equivalent to calling Here's a simple example: enum { TEXT_COLUMN, COLOR_COLUMN, N_COLUMNS }; ... { GtkTreeViewColumn *column; GtkCellRenderer *renderer = gtk_cell_renderer_text_new (); column = gtk_tree_view_column_new_with_attributes ("Title", renderer, "text", TEXT_COLUMN, "foreground", COLOR_COLUMN, NULL); }
gtk_tree_view_column_pack_start ()void gtk_tree_view_column_pack_start (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell, gboolean expand);
Packs the
gtk_tree_view_column_pack_end ()void gtk_tree_view_column_pack_end (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell, gboolean expand);
Adds the
gtk_tree_view_column_clear ()void gtk_tree_view_column_clear (GtkTreeViewColumn *tree_column);
Unsets all the mappings on all renderers on the
gtk_tree_view_column_get_cell_renderers ()GList* gtk_tree_view_column_get_cell_renderers (GtkTreeViewColumn *tree_column);
Returns a newly-allocated GList of all the cell renderers in the column,
in no particular order. The list must be freed with
gtk_tree_view_column_add_attribute ()void gtk_tree_view_column_add_attribute (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, const gchar *attribute, gint column);
Adds an attribute mapping to the list in
gtk_tree_view_column_set_attributes ()void gtk_tree_view_column_set_attributes (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, ...);
Sets the attributes in the list as the attributes of
gtk_tree_view_column_set_cell_data_func ()void gtk_tree_view_column_set_cell_data_func (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, GtkTreeCellDataFunc func, gpointer func_data, GDestroyNotify destroy);
Sets the GtkTreeViewColumnFunc to use for the column. This
function is used instead of the standard attributes mapping for
setting the column value, and should set the value of
gtk_tree_view_column_clear_attributes ()void gtk_tree_view_column_clear_attributes (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer);
Clears all existing attributes previously set with
gtk_tree_view_column_set_spacing ()void gtk_tree_view_column_set_spacing (GtkTreeViewColumn *tree_column, gint spacing);
Sets the spacing field of
gtk_tree_view_column_get_spacing ()gint gtk_tree_view_column_get_spacing (GtkTreeViewColumn *tree_column);
Returns the spacing of
gtk_tree_view_column_set_visible ()void gtk_tree_view_column_set_visible (GtkTreeViewColumn *tree_column, gboolean visible);
Sets the visibility of
gtk_tree_view_column_get_visible ()gboolean gtk_tree_view_column_get_visible (GtkTreeViewColumn *tree_column);
Returns
gtk_tree_view_column_set_resizable ()void gtk_tree_view_column_set_resizable (GtkTreeViewColumn *tree_column, gboolean resizable);
If
gtk_tree_view_column_get_resizable ()gboolean gtk_tree_view_column_get_resizable (GtkTreeViewColumn *tree_column);
Returns
gtk_tree_view_column_set_sizing ()void gtk_tree_view_column_set_sizing (GtkTreeViewColumn *tree_column, GtkTreeViewColumnSizing type);
Sets the growth behavior of
gtk_tree_view_column_get_sizing ()GtkTreeViewColumnSizing gtk_tree_view_column_get_sizing (GtkTreeViewColumn *tree_column);
Returns the current type of
gtk_tree_view_column_get_width ()gint gtk_tree_view_column_get_width (GtkTreeViewColumn *tree_column);
Returns the current size of
gtk_tree_view_column_get_fixed_width ()gint gtk_tree_view_column_get_fixed_width (GtkTreeViewColumn *tree_column); Gets the fixed width of the column. This value is only meaning may not be the actual width of the column on the screen, just what is requested.
gtk_tree_view_column_set_fixed_width ()void gtk_tree_view_column_set_fixed_width (GtkTreeViewColumn *tree_column, gint fixed_width); Sets the size of the column in pixels. This is meaningful only if the sizing type is GTK_TREE_VIEW_COLUMN_FIXED. The size of the column is clamped to the min/max width for the column. Please note that the min/max width of the column doesn't actually affect the "fixed_width" property of the widget, just the actual size when displayed.
gtk_tree_view_column_set_min_width ()void gtk_tree_view_column_set_min_width (GtkTreeViewColumn *tree_column, gint min_width);
Sets the minimum width of the
gtk_tree_view_column_get_min_width ()gint gtk_tree_view_column_get_min_width (GtkTreeViewColumn *tree_column);
Returns the minimum width in pixels of the
gtk_tree_view_column_set_max_width ()void gtk_tree_view_column_set_max_width (GtkTreeViewColumn *tree_column, gint max_width);
Sets the maximum width of the
gtk_tree_view_column_get_max_width ()gint gtk_tree_view_column_get_max_width (GtkTreeViewColumn *tree_column);
Returns the maximum width in pixels of the
gtk_tree_view_column_clicked ()void gtk_tree_view_column_clicked (GtkTreeViewColumn *tree_column);
Emits the "clicked" signal on the column. This function will only work if
gtk_tree_view_column_set_title ()void gtk_tree_view_column_set_title (GtkTreeViewColumn *tree_column, const gchar *title);
Sets the title of the
gtk_tree_view_column_get_title ()const gchar* gtk_tree_view_column_get_title (GtkTreeViewColumn *tree_column); Returns the title of the widget.
gtk_tree_view_column_set_expand ()void gtk_tree_view_column_set_expand (GtkTreeViewColumn *tree_column, gboolean expand);
Sets the column to take available extra space. This space is shared equally
amongst all columns that have the expand set to
Since 2.4 gtk_tree_view_column_get_expand ()gboolean gtk_tree_view_column_get_expand (GtkTreeViewColumn *tree_column);
Return
Since 2.4 gtk_tree_view_column_set_clickable ()void gtk_tree_view_column_set_clickable (GtkTreeViewColumn *tree_column, gboolean clickable);
Sets the header to be active if
gtk_tree_view_column_get_clickable ()gboolean gtk_tree_view_column_get_clickable (GtkTreeViewColumn *tree_column);
Returns
gtk_tree_view_column_set_widget ()void gtk_tree_view_column_set_widget (GtkTreeViewColumn *tree_column, GtkWidget *widget);
Sets the widget in the header to be
gtk_tree_view_column_get_widget ()GtkWidget* gtk_tree_view_column_get_widget (GtkTreeViewColumn *tree_column);
Returns the GtkWidget in the button on the column header. If a custom
widget has not been set then
gtk_tree_view_column_set_alignment ()void gtk_tree_view_column_set_alignment (GtkTreeViewColumn *tree_column, gfloat xalign); Sets the alignment of the title or custom widget inside the column header. The alignment determines its location inside the button -- 0.0 for left, 0.5 for center, 1.0 for right.
gtk_tree_view_column_get_alignment ()gfloat gtk_tree_view_column_get_alignment (GtkTreeViewColumn *tree_column);
Returns the current x alignment of
gtk_tree_view_column_set_reorderable ()void gtk_tree_view_column_set_reorderable (GtkTreeViewColumn *tree_column, gboolean reorderable);
If
gtk_tree_view_column_get_reorderable ()gboolean gtk_tree_view_column_get_reorderable (GtkTreeViewColumn *tree_column);
Returns
gtk_tree_view_column_set_sort_column_id ()void gtk_tree_view_column_set_sort_column_id (GtkTreeViewColumn *tree_column, gint sort_column_id);
Sets the logical
gtk_tree_view_column_get_sort_column_id ()gint gtk_tree_view_column_get_sort_column_id (GtkTreeViewColumn *tree_column);
Gets the logical
gtk_tree_view_column_set_sort_indicator ()void gtk_tree_view_column_set_sort_indicator (GtkTreeViewColumn *tree_column, gboolean setting);
Call this function with a
gtk_tree_view_column_get_sort_indicator ()gboolean gtk_tree_view_column_get_sort_indicator (GtkTreeViewColumn *tree_column);
Gets the value set by
gtk_tree_view_column_set_sort_order ()void gtk_tree_view_column_set_sort_order (GtkTreeViewColumn *tree_column, GtkSortType order); Changes the appearance of the sort indicator.
This does not actually sort the model. Use
The sort indicator changes direction to indicate normal sort or reverse sort.
Note that you must have the sort indicator enabled to see anything when
calling this function; see
gtk_tree_view_column_get_sort_order ()GtkSortType gtk_tree_view_column_get_sort_order (GtkTreeViewColumn *tree_column);
Gets the value set by
gtk_tree_view_column_cell_set_cell_data ()void gtk_tree_view_column_cell_set_cell_data (GtkTreeViewColumn *tree_column, GtkTreeModel *tree_model, GtkTreeIter *iter, gboolean is_expander, gboolean is_expanded);
Sets the cell renderer based on the
gtk_tree_view_column_cell_get_size ()void gtk_tree_view_column_cell_get_size (GtkTreeViewColumn *tree_column, const GdkRectangle *cell_area, gint *x_offset, gint *y_offset, gint *width, gint *height); Obtains the width and height needed to render the column. This is used primarily by the GtkTreeView.
gtk_tree_view_column_cell_get_position ()gboolean gtk_tree_view_column_cell_get_position (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell_renderer, gint *start_pos, gint *width);
Obtains the horizontal position and size of a cell in a column. If the
cell is not found in the column,
gtk_tree_view_column_cell_is_visible ()gboolean gtk_tree_view_column_cell_is_visible (GtkTreeViewColumn *tree_column);
Returns
gtk_tree_view_column_focus_cell ()void gtk_tree_view_column_focus_cell (GtkTreeViewColumn *tree_column, GtkCellRenderer *cell);
Sets the current keyboard focus to be at
Since 2.2 gtk_tree_view_column_queue_resize ()void gtk_tree_view_column_queue_resize (GtkTreeViewColumn *tree_column); Flags the column, and the cell renderers added to this column, to have their sizes renegotiated.
Since 2.8 gtk_tree_view_column_get_tree_view ()GtkWidget* gtk_tree_view_column_get_tree_view (GtkTreeViewColumn *tree_column);
Returns the GtkTreeView wherein
Since 2.12 Property DetailsThe
|
|
the object which received the signal. |
|
user data set when the signal handler was connected. |
GtkTreeView, GtkTreeSelection, GtkTreeDnd, GtkTreeMode, GtkTreeSortable, GtkTreeModelSort, GtkListStore, GtkTreeStore, GtkCellRenderer, GtkCellEditable, GtkCellRendererPixbuf, GtkCellRendererText, GtkCellRendererToggle