GtkTreeView

GtkTreeView — A widget for displaying both trees and lists

Synopsis


#include <gtk/gtk.h>


            GtkTreeView;
enum        GtkTreeViewDropPosition;
            GtkTreeViewPrivate;
gboolean    (*GtkTreeViewColumnDropFunc)    (GtkTreeView *tree_view,
                                             GtkTreeViewColumn *column,
                                             GtkTreeViewColumn *prev_column,
                                             GtkTreeViewColumn *next_column,
                                             gpointer data);
void        (*GtkTreeViewMappingFunc)       (GtkTreeView *tree_view,
                                             GtkTreePath *path,
                                             gpointer user_data);
gboolean    (*GtkTreeViewSearchEqualFunc)   (GtkTreeModel *model,
                                             gint column,
                                             const gchar *key,
                                             GtkTreeIter *iter,
                                             gpointer search_data);
GtkWidget*  gtk_tree_view_new               (void);
GtkWidget*  gtk_tree_view_new_with_model    (GtkTreeModel *model);
GtkTreeModel* gtk_tree_view_get_model       (GtkTreeView *tree_view);
void        gtk_tree_view_set_model         (GtkTreeView *tree_view,
                                             GtkTreeModel *model);
GtkTreeSelection* gtk_tree_view_get_selection
                                            (GtkTreeView *tree_view);
GtkAdjustment* gtk_tree_view_get_hadjustment
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_hadjustment   (GtkTreeView *tree_view,
                                             GtkAdjustment *adjustment);
GtkAdjustment* gtk_tree_view_get_vadjustment
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_vadjustment   (GtkTreeView *tree_view,
                                             GtkAdjustment *adjustment);
gboolean    gtk_tree_view_get_headers_visible
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_headers_visible
                                            (GtkTreeView *tree_view,
                                             gboolean headers_visible);
void        gtk_tree_view_columns_autosize  (GtkTreeView *tree_view);
gboolean    gtk_tree_view_get_headers_clickable
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_headers_clickable
                                            (GtkTreeView *tree_view,
                                             gboolean setting);
void        gtk_tree_view_set_rules_hint    (GtkTreeView *tree_view,
                                             gboolean setting);
gboolean    gtk_tree_view_get_rules_hint    (GtkTreeView *tree_view);
gint        gtk_tree_view_append_column     (GtkTreeView *tree_view,
                                             GtkTreeViewColumn *column);
gint        gtk_tree_view_remove_column     (GtkTreeView *tree_view,
                                             GtkTreeViewColumn *column);
gint        gtk_tree_view_insert_column     (GtkTreeView *tree_view,
                                             GtkTreeViewColumn *column,
                                             gint position);
gint        gtk_tree_view_insert_column_with_attributes
                                            (GtkTreeView *tree_view,
                                             gint position,
                                             const gchar *title,
                                             GtkCellRenderer *cell,
                                             ...);
gint        gtk_tree_view_insert_column_with_data_func
                                            (GtkTreeView *tree_view,
                                             gint position,
                                             const gchar *title,
                                             GtkCellRenderer *cell,
                                             GtkTreeCellDataFunc func,
                                             gpointer data,
                                             GDestroyNotify dnotify);
GtkTreeViewColumn* gtk_tree_view_get_column (GtkTreeView *tree_view,
                                             gint n);
GList*      gtk_tree_view_get_columns       (GtkTreeView *tree_view);
void        gtk_tree_view_move_column_after (GtkTreeView *tree_view,
                                             GtkTreeViewColumn *column,
                                             GtkTreeViewColumn *base_column);
void        gtk_tree_view_set_expander_column
                                            (GtkTreeView *tree_view,
                                             GtkTreeViewColumn *column);
GtkTreeViewColumn* gtk_tree_view_get_expander_column
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_column_drag_function
                                            (GtkTreeView *tree_view,
                                             GtkTreeViewColumnDropFunc func,
                                             gpointer user_data,
                                             GtkDestroyNotify destroy);
void        gtk_tree_view_scroll_to_point   (GtkTreeView *tree_view,
                                             gint tree_x,
                                             gint tree_y);
void        gtk_tree_view_scroll_to_cell    (GtkTreeView *tree_view,
                                             GtkTreePath *path,
                                             GtkTreeViewColumn *column,
                                             gboolean use_align,
                                             gfloat row_align,
                                             gfloat col_align);
void        gtk_tree_view_set_cursor        (GtkTreeView *tree_view,
                                             GtkTreePath *path,
                                             GtkTreeViewColumn *focus_column,
                                             gboolean start_editing);
void        gtk_tree_view_set_cursor_on_cell
                                            (GtkTreeView *tree_view,
                                             GtkTreePath *path,
                                             GtkTreeViewColumn *focus_column,
                                             GtkCellRenderer *focus_cell,
                                             gboolean start_editing);
void        gtk_tree_view_get_cursor        (GtkTreeView *tree_view,
                                             GtkTreePath **path,
                                             GtkTreeViewColumn **focus_column);
void        gtk_tree_view_row_activated     (GtkTreeView *tree_view,
                                             GtkTreePath *path,
                                             GtkTreeViewColumn *column);
void        gtk_tree_view_expand_all        (GtkTreeView *tree_view);
void        gtk_tree_view_collapse_all      (GtkTreeView *tree_view);
void        gtk_tree_view_expand_to_path    (GtkTreeView *tree_view,
                                             GtkTreePath *path);
gboolean    gtk_tree_view_expand_row        (GtkTreeView *tree_view,
                                             GtkTreePath *path,
                                             gboolean open_all);
gboolean    gtk_tree_view_collapse_row      (GtkTreeView *tree_view,
                                             GtkTreePath *path);
void        gtk_tree_view_map_expanded_rows (GtkTreeView *tree_view,
                                             GtkTreeViewMappingFunc func,
                                             gpointer data);
gboolean    gtk_tree_view_row_expanded      (GtkTreeView *tree_view,
                                             GtkTreePath *path);
void        gtk_tree_view_set_reorderable   (GtkTreeView *tree_view,
                                             gboolean reorderable);
gboolean    gtk_tree_view_get_reorderable   (GtkTreeView *tree_view);
gboolean    gtk_tree_view_get_path_at_pos   (GtkTreeView *tree_view,
                                             gint x,
                                             gint y,
                                             GtkTreePath **path,
                                             GtkTreeViewColumn **column,
                                             gint *cell_x,
                                             gint *cell_y);
void        gtk_tree_view_get_cell_area     (GtkTreeView *tree_view,
                                             GtkTreePath *path,
                                             GtkTreeViewColumn *column,
                                             GdkRectangle *rect);
void        gtk_tree_view_get_background_area
                                            (GtkTreeView *tree_view,
                                             GtkTreePath *path,
                                             GtkTreeViewColumn *column,
                                             GdkRectangle *rect);
void        gtk_tree_view_get_visible_rect  (GtkTreeView *tree_view,
                                             GdkRectangle *visible_rect);
gboolean    gtk_tree_view_get_visible_range (GtkTreeView *tree_view,
                                             GtkTreePath **start_path,
                                             GtkTreePath **end_path);
GdkWindow*  gtk_tree_view_get_bin_window    (GtkTreeView *tree_view);
void        gtk_tree_view_widget_to_tree_coords
                                            (GtkTreeView *tree_view,
                                             gint wx,
                                             gint wy,
                                             gint *tx,
                                             gint *ty);
void        gtk_tree_view_tree_to_widget_coords
                                            (GtkTreeView *tree_view,
                                             gint tx,
                                             gint ty,
                                             gint *wx,
                                             gint *wy);
void        gtk_tree_view_enable_model_drag_dest
                                            (GtkTreeView *tree_view,
                                             const GtkTargetEntry *targets,
                                             gint n_targets,
                                             GdkDragAction actions);
void        gtk_tree_view_enable_model_drag_source
                                            (GtkTreeView *tree_view,
                                             GdkModifierType start_button_mask,
                                             const GtkTargetEntry *targets,
                                             gint n_targets,
                                             GdkDragAction actions);
void        gtk_tree_view_unset_rows_drag_source
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_unset_rows_drag_dest
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_drag_dest_row (GtkTreeView *tree_view,
                                             GtkTreePath *path,
                                             GtkTreeViewDropPosition pos);
void        gtk_tree_view_get_drag_dest_row (GtkTreeView *tree_view,
                                             GtkTreePath **path,
                                             GtkTreeViewDropPosition *pos);
gboolean    gtk_tree_view_get_dest_row_at_pos
                                            (GtkTreeView *tree_view,
                                             gint drag_x,
                                             gint drag_y,
                                             GtkTreePath **path,
                                             GtkTreeViewDropPosition *pos);
GdkPixmap*  gtk_tree_view_create_row_drag_icon
                                            (GtkTreeView *tree_view,
                                             GtkTreePath *path);
void        gtk_tree_view_set_enable_search (GtkTreeView *tree_view,
                                             gboolean enable_search);
gboolean    gtk_tree_view_get_enable_search (GtkTreeView *tree_view);
gint        gtk_tree_view_get_search_column (GtkTreeView *tree_view);
void        gtk_tree_view_set_search_column (GtkTreeView *tree_view,
                                             gint column);
GtkTreeViewSearchEqualFunc gtk_tree_view_get_search_equal_func
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_search_equal_func
                                            (GtkTreeView *tree_view,
                                             GtkTreeViewSearchEqualFunc search_equal_func,
                                             gpointer search_user_data,
                                             GtkDestroyNotify search_destroy);
GtkEntry*   gtk_tree_view_get_search_entry  (GtkTreeView *tree_view);
void        gtk_tree_view_set_search_entry  (GtkTreeView *tree_view,
                                             GtkEntry *entry);
void        (*GtkTreeViewSearchPositionFunc)
                                            (GtkTreeView *tree_view,
                                             GtkWidget *search_dialog,
                                             gpointer user_data);
GtkTreeViewSearchPositionFunc gtk_tree_view_get_search_position_func
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_search_position_func
                                            (GtkTreeView *tree_view,
                                             GtkTreeViewSearchPositionFunc func,
                                             gpointer data,
                                             GDestroyNotify destroy);
gboolean    gtk_tree_view_get_fixed_height_mode
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_fixed_height_mode
                                            (GtkTreeView *tree_view,
                                             gboolean enable);
gboolean    gtk_tree_view_get_hover_selection
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_hover_selection
                                            (GtkTreeView *tree_view,
                                             gboolean hover);
gboolean    gtk_tree_view_get_hover_expand  (GtkTreeView *tree_view);
void        gtk_tree_view_set_hover_expand  (GtkTreeView *tree_view,
                                             gboolean expand);
void        (*GtkTreeDestroyCountFunc)      (GtkTreeView *tree_view,
                                             GtkTreePath *path,
                                             gint children,
                                             gpointer user_data);
void        gtk_tree_view_set_destroy_count_func
                                            (GtkTreeView *tree_view,
                                             GtkTreeDestroyCountFunc func,
                                             gpointer data,
                                             GtkDestroyNotify destroy);
gboolean    (*GtkTreeViewRowSeparatorFunc)  (GtkTreeModel *model,
                                             GtkTreeIter *iter,
                                             gpointer data);
GtkTreeViewRowSeparatorFunc gtk_tree_view_get_row_separator_func
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_row_separator_func
                                            (GtkTreeView *tree_view,
                                             GtkTreeViewRowSeparatorFunc func,
                                             gpointer data,
                                             GtkDestroyNotify destroy);
gboolean    gtk_tree_view_get_rubber_banding
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_rubber_banding
                                            (GtkTreeView *tree_view,
                                             gboolean enable);
gboolean    gtk_tree_view_get_enable_tree_lines
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_enable_tree_lines
                                            (GtkTreeView *tree_view,
                                             gboolean enabled);
enum        GtkTreeViewGridLines;
GtkTreeViewGridLines gtk_tree_view_get_grid_lines
                                            (GtkTreeView *tree_view);
void        gtk_tree_view_set_grid_lines    (GtkTreeView *tree_view,
                                             GtkTreeViewGridLines grid_lines);


Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkTreeView

Implemented Interfaces

GtkTreeView implements GtkBuildable and AtkImplementorIface.

Properties


  "enable-grid-lines"    GtkTreeViewGridLines  : Read / Write
  "enable-search"        gboolean              : Read / Write
  "enable-tree-lines"    gboolean              : Read / Write
  "expander-column"      GtkTreeViewColumn     : Read / Write
  "fixed-height-mode"    gboolean              : Read / Write
  "hadjustment"          GtkAdjustment         : Read / Write
  "headers-clickable"    gboolean              : Read / Write
  "headers-visible"      gboolean              : Read / Write
  "hover-expand"         gboolean              : Read / Write
  "hover-selection"      gboolean              : Read / Write
  "level-indentation"    gint                  : Read / Write
  "model"                GtkTreeModel          : Read / Write
  "reorderable"          gboolean              : Read / Write
  "rubber-banding"       gboolean              : Read / Write
  "rules-hint"           gboolean              : Read / Write
  "search-column"        gint                  : Read / Write
  "show-expanders"       gboolean              : Read / Write
  "vadjustment"          GtkAdjustment         : Read / Write

Style Properties


  "allow-rules"          gboolean              : Read
  "even-row-color"       GdkColor              : Read
  "expander-size"        gint                  : Read
  "grid-line-pattern"    gchararray            : Read
  "grid-line-width"      gint                  : Read
  "horizontal-separator" gint                  : Read
  "indent-expanders"     gboolean              : Read
  "odd-row-color"        GdkColor              : Read
  "row-ending-details"   gboolean              : Read
  "separator-height"     gint                  : Read
  "tree-line-pattern"    gchararray            : Read
  "tree-line-width"      gint                  : Read
  "vertical-separator"   gint                  : Read

Signals


"columns-changed"
            void        user_function      (GtkTreeView *tree_view,
                                            gpointer     user_data)      : Run last
"cursor-changed"
            void        user_function      (GtkTreeView *tree_view,
                                            gpointer     user_data)      : Run last
"expand-collapse-cursor-row"
            gboolean    user_function      (GtkTreeView *treeview,
                                            gboolean     arg1,
                                            gboolean     arg2,
                                            gboolean     arg3,
                                            gpointer     user_data)      : Run last / Action
"move-cursor"
            gboolean    user_function      (GtkTreeView     *treeview,
                                            GtkMovementStep *arg1,
                                            gint             arg2,
                                            gpointer         user_data)      : Run last / Action
"row-activated"
            void        user_function      (GtkTreeView       *tree_view,
                                            GtkTreePath       *path,
                                            GtkTreeViewColumn *column,
                                            gpointer           user_data)      : Run last / Action
"row-collapsed"
            void        user_function      (GtkTreeView *tree_view,
                                            GtkTreeIter *iter,
                                            GtkTreePath *path,
                                            gpointer     user_data)      : Run last
"row-expanded"
            void        user_function      (GtkTreeView *tree_view,
                                            GtkTreeIter *iter,
                                            GtkTreePath *path,
                                            gpointer     user_data)      : Run last
"row-insensitive"
            void        user_function      (GtkTreeView *tree_view,
                                            GtkTreePath *path,
                                            gpointer     user_data)      : Run last / Action
"select-all"
            gboolean    user_function      (GtkTreeView *treeview,
                                            gpointer     user_data)      : Run last / Action
"select-cursor-parent"
            gboolean    user_function      (GtkTreeView *treeview,
                                            gpointer     user_data)      : Run last / Action
"select-cursor-row"
            gboolean    user_function      (GtkTreeView *treeview,
                                            gboolean     arg1,
                                            gpointer     user_data)      : Run last / Action
"set-scroll-adjustments"
            void        user_function      (GtkTreeView   *treeview,
                                            GtkAdjustment *arg1,
                                            GtkAdjustment *arg2,
                                            gpointer       user_data)      : Run last / Action
"start-interactive-search"
            gboolean    user_function      (GtkTreeView *treeview,
                                            gpointer     user_data)      : Run last / Action
"test-collapse-row"
            gboolean    user_function      (GtkTreeView *tree_view,
                                            GtkTreeIter *iter,
                                            GtkTreePath *path,
                                            gpointer     user_data)      : Run last
"test-expand-row"
            gboolean    user_function      (GtkTreeView *tree_view,
                                            GtkTreeIter *iter,
                                            GtkTreePath *path,
                                            gpointer     user_data)      : Run last
"toggle-cursor-row"
            gboolean    user_function      (GtkTreeView *treeview,
                                            gpointer     user_data)      : Run last / Action
"unselect-all"
            gboolean    user_function      (GtkTreeView *treeview,
                                            gpointer     user_data)      : Run last / Action

Description

Widget that displays any object that implements the GtkTreeModel interface.

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.

GtkTreeView as GtkBuildable

The GtkTreeView implementation of the GtkBuildable interface accepts GtkTreeViewColumn objects as <child> elements in UI definitions.

Example 16. A UI definition fragment with GtkTreeView

<object class="GtkTreeView">
  <property name="model">liststore1</property>
  <child>
    <object class="GtkTreeViewColumn">
      <property name="title">Test</property>
      <child>
        <object class="GtkCellRendererText"/>
        <attributes>"
          <attribute name="text">1</attribute>
        </attributes>
      </child>
    </object>
  </child>
</object>

Details

GtkTreeView

typedef struct _GtkTreeView GtkTreeView;


enum GtkTreeViewDropPosition

typedef enum
{
  /* drop before/after this row */
  GTK_TREE_VIEW_DROP_BEFORE,
  GTK_TREE_VIEW_DROP_AFTER,
  /* drop as a child of this row (with fallback to before or after
   * if into is not possible)
   */
  GTK_TREE_VIEW_DROP_INTO_OR_BEFORE,
  GTK_TREE_VIEW_DROP_INTO_OR_AFTER
} GtkTreeViewDropPosition;

An enum for determining where a dropped row goes.

GTK_TREE_VIEW_DROP_BEFORE dropped row is inserted before
GTK_TREE_VIEW_DROP_AFTER dropped row is inserted after
GTK_TREE_VIEW_DROP_INTO_OR_BEFORE dropped row becomes a child or is inserted before
GTK_TREE_VIEW_DROP_INTO_OR_AFTER dropped row becomes a child or is inserted after

GtkTreeViewPrivate

typedef struct _GtkTreeViewPrivate GtkTreeViewPrivate;

A private struct for internal use only. The definition of this structure is not publically available.


GtkTreeViewColumnDropFunc ()

gboolean    (*GtkTreeViewColumnDropFunc)    (GtkTreeView *tree_view,
                                             GtkTreeViewColumn *column,
                                             GtkTreeViewColumn *prev_column,
                                             GtkTreeViewColumn *next_column,
                                             gpointer data);

Function type for determining whether column can be dropped in a particular spot (as determined by prev_column and next_column). In left to right locales, prev_column is on the left of the potential drop spot, and next_column is on the right. In right to left mode, this is reversed. This function should return TRUE if the spot is a valid drop spot. Please note that returning TRUE does not actually indicate that the column drop was made, but is meant only to indicate a possible drop spot to the user.

tree_view : A GtkTreeView
column : The GtkTreeViewColumn being dragged
prev_column : A GtkTreeViewColumn on one side of column
next_column : A GtkTreeViewColumn on the other side of column
data : user data
Returns : TRUE, if column can be dropped in this spot

GtkTreeViewMappingFunc ()

void        (*GtkTreeViewMappingFunc)       (GtkTreeView *tree_view,
                                             GtkTreePath *path,
                                             gpointer user_data);

Function used for gtk_tree_view_map_expanded_rows.

tree_view : A GtkTreeView
path : The path that's expanded
user_data : user data

GtkTreeViewSearchEqualFunc ()

gboolean    (*GtkTreeViewSearchEqualFunc)   (GtkTreeModel *model,
                                             gint column,
                                             const gchar *key,
                                             GtkTreeIter *iter,
                                             gpointer search_data);

A function used for checking whether a row in model matches a search key string entered by the user. Note the return value is reversed from what you would normally expect, though it has some similarity to strcmp() returning 0 for equal strings.

model : the GtkTreeModel being searched
column : the search column set by gtk_tree_view_set_search_column()
key : the key string to compare with
iter : a GtkTreeIter pointing the row of model that should be compared with key.
search_data : user data from gtk_tree_view_set_search_equal_func()
Returns : FALSE if the row matches, TRUE otherwise.

gtk_tree_view_new ()

GtkWidget*  gtk_tree_view_new               (void);

Creates a new GtkTreeView widget.

Returns : A newly created GtkTreeView widget.

gtk_tree_view_new_with_model ()

GtkWidget*  gtk_tree_view_new_with_model    (GtkTreeModel *model);

Creates a new GtkTreeView widget with the model initialized to model.

model : the model.
Returns : A newly created GtkTreeView widget.

gtk_tree_view_get_model ()

GtkTreeModel* gtk_tree_view_get_model       (GtkTreeView *tree_view);

Returns the model the GtkTreeView is based on. Returns NULL if the model is unset.

tree_view : a GtkTreeView
Returns : A GtkTreeModel, or NULL if none is currently being used.

gtk_tree_view_set_model ()

void        gtk_tree_view_set_model         (GtkTreeView *tree_view,
                                             GtkTreeModel *model);

Sets the model for a GtkTreeView. If the tree_view already has a model set, it will remove it before setting the new model. If model is NULL, then it will unset the old model.

tree_view : A GtkTreeNode.
model : The model.

gtk_tree_view_get_selection ()

GtkTreeSelection* gtk_tree_view_get_selection
                                            (GtkTreeView *tree_view);

Gets the GtkTreeSelection associated with tree_view.

tree_view : A GtkTreeView.
Returns : A GtkTreeSelection object.

gtk_tree_view_get_hadjustment ()

GtkAdjustment* gtk_tree_view_get_hadjustment
                                            (GtkTreeView *tree_view);

Gets the GtkAdjustment currently being used for the horizontal aspect.

tree_view : A GtkTreeView
Returns : A GtkAdjustment object, or NULL if none is currently being used.

gtk_tree_view_set_hadjustment ()

void        gtk_tree_view_set_hadjustment   (GtkTreeView *tree_view,
                                             GtkAdjustment *adjustment);

Sets the GtkAdjustment for the current horizontal aspect.

tree_view : A GtkTreeView
adjustment : The GtkAdjustment to set, or NULL

gtk_tree_view_get_vadjustment ()

GtkAdjustment* gtk_tree_view_get_vadjustment
                                            (GtkTreeView *tree_view);

Gets the GtkAdjustment currently being used for the vertical aspect.

tree_view : A GtkTreeView
Returns : A GtkAdjustment object, or NULL if none is currently being used.

gtk_tree_view_set_vadjustment ()

void        gtk_tree_view_set_vadjustment   (GtkTreeView *tree_view,
                                             GtkAdjustment *adjustment);

Sets the GtkAdjustment for the current vertical aspect.

tree_view : A GtkTreeView
adjustment : The GtkAdjustment to set, or NULL

gtk_tree_view_get_headers_visible ()

gboolean    gtk_tree_view_get_headers_visible
                                            (GtkTreeView *tree_view);

Returns TRUE if the headers on the tree_view are visible.

tree_view : A GtkTreeView.
Returns : Whether the headers are visible or not.

gtk_tree_view_set_headers_visible ()

void        gtk_tree_view_set_headers_visible
                                            (GtkTreeView *tree_view,
                                             gboolean headers_visible);

Sets the visibility state of the headers.

tree_view : A GtkTreeView.
headers_visible : TRUE if the headers are visible

gtk_tree_view_columns_autosize ()

void        gtk_tree_view_columns_autosize  (GtkTreeView *tree_view);

Resizes all columns to their optimal width. Only works after the treeview has been realized.

tree_view : A GtkTreeView.

gtk_tree_view_get_headers_clickable ()

gboolean    gtk_tree_view_get_headers_clickable
                                            (GtkTreeView *tree_view);

Returns whether all header columns are clickable.

tree_view : A GtkTreeView.
Returns : TRUE if all header columns are clickable, otherwise FALSE

Since 2.10


gtk_tree_view_set_headers_clickable ()

void        gtk_tree_view_set_headers_clickable
                                            (GtkTreeView *tree_view,
                                             gboolean setting);

Allow the column title buttons to be clicked.

tree_view : A GtkTreeView.
setting : TRUE if the columns are clickable.

gtk_tree_view_set_rules_hint ()

void        gtk_tree_view_set_rules_hint    (GtkTreeView *tree_view,
                                             gboolean setting);

This function tells GTK+ that the user interface for your application requires users to read across tree rows and associate cells with one another. By default, GTK+ will then render the tree with alternating row colors. Do not use it just because you prefer the appearance of the ruled tree; that's a question for the theme. Some themes will draw tree rows in alternating colors even when rules are turned off, and users who prefer that appearance all the time can choose those themes. You should call this function only as a semantic hint to the theme engine that your tree makes alternating colors useful from a functional standpoint (since it has lots of columns, generally).

tree_view : a GtkTreeView
setting : TRUE if the tree requires reading across rows

gtk_tree_view_get_rules_hint ()

gboolean    gtk_tree_view_get_rules_hint    (GtkTreeView *tree_view);

Gets the setting set by gtk_tree_view_set_rules_hint().

tree_view : a GtkTreeView
Returns : TRUE if rules are useful for the user of this tree

gtk_tree_view_append_column ()

gint        gtk_tree_view_append_column     (GtkTreeView *tree_view,
                                             GtkTreeViewColumn *column);

Appends column to the list of columns. If tree_view has "fixed_height" mode enabled, then column must have its "sizing" property set to be GTK_TREE_VIEW_COLUMN_FIXED.

tree_view : A GtkTreeView.
column : The GtkTreeViewColumn to add.
Returns : The number of columns in tree_view after appending.

gtk_tree_view_remove_column ()

gint        gtk_tree_view_remove_column     (GtkTreeView *tree_view,
                                             GtkTreeViewColumn *column);

Removes column from tree_view.

tree_view : A GtkTreeView.
column : The GtkTreeViewColumn to remove.
Returns : The number of columns in tree_view after removing.

gtk_tree_view_insert_column ()

gint        gtk_tree_view_insert_column     (GtkTreeView *tree_view,
                                             GtkTreeViewColumn *column,
                                             gint position);

This inserts the column into the tree_view at position. If position is -1, then the column is inserted at the end. If tree_view has "fixed_height" mode enabled, then column must have its "sizing" property set to be GTK_TREE_VIEW_COLUMN_FIXED.

tree_view : A GtkTreeView.
column : The GtkTreeViewColumn to be inserted.
position : The position to insert column in.
Returns : The number of columns in tree_view after insertion.

gtk_tree_view_insert_column_with_attributes ()

gint        gtk_tree_view_insert_column_with_attributes
                                            (GtkTreeView *tree_view,
                                             gint position,
                                             const gchar *title,
                                             GtkCellRenderer *cell,
                                             ...);

Creates a new GtkTreeViewColumn and inserts it into the tree_view at position. If position is -1, then the newly created column is inserted at the end. The column is initialized with the attributes given. If tree_view has "fixed_height" mode enabled, then the new column will have its sizing property set to be GTK_TREE_VIEW_COLUMN_FIXED.

tree_view : A GtkTreeView
position : The position to insert the new column in.
title : The title to set the header to.
cell : The GtkCellRenderer.
... : A NULL-terminated list of attributes.
Returns : The number of columns in tree_view after insertion.

gtk_tree_view_insert_column_with_data_func ()

gint        gtk_tree_view_insert_column_with_data_func
                                            (GtkTreeView *tree_view,
                                             gint position,
                                             const gchar *title,
                                             GtkCellRenderer *cell,
                                             GtkTreeCellDataFunc func,
                                             gpointer data,
                                             GDestroyNotify dnotify);

Convenience function that inserts a new column into the GtkTreeView with the given cell renderer and a GtkCellDataFunc to set cell renderer attributes (normally using data from the model). See also gtk_tree_view_column_set_cell_data_func(), gtk_tree_view_column_pack_start(). If tree_view has "fixed_height" mode enabled, then the new column will have its "sizing" property set to be GTK_TREE_VIEW_COLUMN_FIXED.

tree_view : a GtkTreeView
position : Position to insert, -1 for append
title : column title
cell : cell renderer for column
func : function to set attributes of cell renderer
data : data for func