Pileus Git - ~andy/gtk/blob - gtk/gtktreeviewcolumn.h

   1 /* gtktreeviewcolumn.h
   2  * Copyright (C) 2000  Red Hat, Inc.,  Jonathan Blandford <jrb@redhat.com>
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Library General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 #ifndef __GTK_TREE_VIEW_COLUMN_H__
  21 #define __GTK_TREE_VIEW_COLUMN_H__
  22
  23 #include <gtk/gtkobject.h>
  24 #include <gtk/gtkcellrenderer.h>
  25 #include <gtk/gtktreemodel.h>
  26 #include <gtk/gtktreesortable.h>
  27
  28 #ifdef __cplusplus
  29 extern "C" {
  30 #endif /* __cplusplus */
  31
  32 #define GTK_TYPE_TREE_VIEW_COLUMN            (gtk_tree_view_column_get_type ())
  33 #define GTK_TREE_VIEW_COLUMN(obj)            (GTK_CHECK_CAST ((obj), GTK_TYPE_TREE_VIEW_COLUMN, GtkTreeViewColumn))
  34 #define GTK_TREE_VIEW_COLUMN_CLASS(klass)    (GTK_CHECK_CLASS_CAST ((klass), GTK_TYPE_TREE_VIEW_COLUMN, GtkTreeViewColumnClass))
  35 #define GTK_IS_TREE_VIEW_COLUMN(obj)         (GTK_CHECK_TYPE ((obj), GTK_TYPE_TREE_VIEW_COLUMN))
  36 #define GTK_IS_TREE_VIEW_COLUMN_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((obj), GTK_TYPE_TREE_VIEW_COLUMN))
  37
  38 typedef enum
  39 {
  40   GTK_TREE_VIEW_COLUMN_RESIZEABLE,
  41   GTK_TREE_VIEW_COLUMN_AUTOSIZE,
  42   GTK_TREE_VIEW_COLUMN_FIXED
  43 } GtkTreeViewColumnSizing;
  44
  45 typedef struct _GtkTreeViewColumn      GtkTreeViewColumn;
  46 typedef struct _GtkTreeViewColumnClass GtkTreeViewColumnClass;
  47
  48 typedef void (* GtkCellDataFunc) (GtkTreeViewColumn *tree_column,
  49                                   GtkCellRenderer   *cell,
  50                                   GtkTreeModel      *tree_model,
  51                                   GtkTreeIter       *iter,
  52                                   gpointer           data);
  53
  54
  55 struct _GtkTreeViewColumn
  56 {
  57   GtkObject parent;
  58
  59   GtkWidget *tree_view;
  60   GtkWidget *button;
  61   GtkWidget *child;
  62   GtkWidget *arrow;
  63   GtkWidget *alignment;
  64   GdkWindow *window;
  65   gfloat xalign;
  66   guint model_changed_signal;
  67
  68   gint width;
  69   gint min_width;
  70   gint max_width;
  71   gint displayed_width;
  72
  73   /* dragging columns */
  74   gint drag_x;
  75   gint drag_y;
  76
  77   GtkCellDataFunc func;
  78   gpointer func_data;
  79   GtkDestroyNotify destroy;
  80   gchar *title;
  81   GtkCellRenderer *cell;
  82   GSList *attributes;
  83   GtkTreeViewColumnSizing column_type;
  84
  85   /* Sorting */
  86   guint sort_clicked_signal;
  87   guint sort_column_changed_signal;
  88   gint sort_column_id;
  89   GtkTreeSortOrder sort_order;
  90
  91   guint visible       : 1;
  92   guint button_active : 1;
  93   guint dirty         : 1;
  94   guint show_sort_indicator : 1;
  95   guint maybe_reordered     : 1;
  96   guint reorderable   : 1;
  97 };
  98
  99 struct _GtkTreeViewColumnClass
 100 {
 101   GtkObjectClass parent_class;
 102
 103   void (*clicked) (GtkTreeViewColumn *tree_column);
 104 };
 105
 106
 107 GtkType            gtk_tree_view_column_get_type            (void);
 108 GtkTreeViewColumn *gtk_tree_view_column_new                 (void);
 109 GtkTreeViewColumn *gtk_tree_view_column_new_with_attributes (const gchar           *title,
 110                                                              GtkCellRenderer       *cell,
 111                                                              ...);
 112 void               gtk_tree_view_column_set_cell_renderer   (GtkTreeViewColumn     *tree_column,
 113                                                              GtkCellRenderer       *cell);
 114 GtkCellRenderer   *gtk_tree_view_column_get_cell_renderer   (GtkTreeViewColumn     *tree_column);
 115 void               gtk_tree_view_column_add_attribute       (GtkTreeViewColumn     *tree_column,
 116                                                              const gchar           *attribute,
 117                                                              gint                   column);
 118 void               gtk_tree_view_column_set_attributes      (GtkTreeViewColumn     *tree_column,
 119                                                              ...);
 120 void               gtk_tree_view_column_set_cell_data_func  (GtkTreeViewColumn     *tree_column,
 121                                                              GtkCellDataFunc        func,
 122                                                              gpointer               func_data,
 123                                                              GtkDestroyNotify       destroy);
 124 void               gtk_tree_view_column_clear_attributes    (GtkTreeViewColumn     *tree_column);
 125 void               gtk_tree_view_column_set_cell_data       (GtkTreeViewColumn     *tree_column,
 126                                                              GtkTreeModel          *tree_model,
 127                                                              GtkTreeIter           *iter);
 128 void               gtk_tree_view_column_set_visible         (GtkTreeViewColumn     *tree_column,
 129                                                              gboolean               visible);
 130 gboolean           gtk_tree_view_column_get_visible         (GtkTreeViewColumn     *tree_column);
 131 void               gtk_tree_view_column_set_sizing          (GtkTreeViewColumn     *tree_column,
 132                                                              GtkTreeViewColumnSizing type);
 133 gint               gtk_tree_view_column_get_sizing          (GtkTreeViewColumn     *tree_column);
 134 gint               gtk_tree_view_column_get_width           (GtkTreeViewColumn     *tree_column);
 135 void               gtk_tree_view_column_set_width           (GtkTreeViewColumn     *tree_column,
 136                                                              gint                   size);
 137 void               gtk_tree_view_column_set_min_width       (GtkTreeViewColumn     *tree_column,
 138                                                              gint                   min_width);
 139 gint               gtk_tree_view_column_get_min_width       (GtkTreeViewColumn     *tree_column);
 140 void               gtk_tree_view_column_set_max_width       (GtkTreeViewColumn     *tree_column,
 141                                                              gint                   max_width);
 142 gint               gtk_tree_view_column_get_max_width       (GtkTreeViewColumn     *tree_column);
 143
 144
 145 void               gtk_tree_view_column_clicked             (GtkTreeViewColumn     *tree_column);
 146
 147 /* Options for manipulating the column headers
 148  */
 149 void                  gtk_tree_view_column_set_title          (GtkTreeViewColumn *tree_column,
 150                                                                const gchar       *title);
 151 G_CONST_RETURN gchar *gtk_tree_view_column_get_title          (GtkTreeViewColumn *tree_column);
 152 void                  gtk_tree_view_column_set_clickable      (GtkTreeViewColumn *tree_column,
 153                                                                gboolean           active);
 154 gboolean              gtk_tree_view_column_get_clickable      (GtkTreeViewColumn *tree_column);
 155 void                  gtk_tree_view_column_set_widget         (GtkTreeViewColumn *tree_column,
 156                                                                GtkWidget         *widget);
 157 GtkWidget            *gtk_tree_view_column_get_widget         (GtkTreeViewColumn *tree_column);
 158 void                  gtk_tree_view_column_set_alignment      (GtkTreeViewColumn *tree_column,
 159                                                                gfloat             xalign);
 160 gfloat                gtk_tree_view_column_get_alignment      (GtkTreeViewColumn *tree_column);
 161
 162
 163 /* You probably only want to use gtk_tree_view_column_set_sort_column_id.  The
 164  * other sorting functions exist primarily to let others do their own custom sorting.
 165  */
 166
 167 void                  gtk_tree_view_column_set_sort_column_id (GtkTreeViewColumn *tree_column,
 168                                                                gint               sort_column_id);
 169 void                  gtk_tree_view_column_set_sort_indicator (GtkTreeViewColumn *tree_column,
 170                                                                gboolean           setting);
 171 gboolean              gtk_tree_view_column_get_sort_indicator (GtkTreeViewColumn *tree_column);
 172 void                  gtk_tree_view_column_set_sort_order     (GtkTreeViewColumn *tree_column,
 173                                                                GtkTreeSortOrder   order);
 174 GtkTreeSortOrder      gtk_tree_view_column_get_sort_order     (GtkTreeViewColumn *tree_column);
 175
 176
 177
 178
 179
 180 #ifdef __cplusplus
 181 }
 182 #endif /* __cplusplus */
 183
 184 #endif /* __GTK_TREE_VIEW_COLUMN_H__ */
 185