]> Pileus Git - ~andy/gtk/blobdiff - gtk/gtktreeviewcolumn.h
Updated Bulgarian translation by Alexander Shopov <ash@contact.bg>
[~andy/gtk] / gtk / gtktreeviewcolumn.h
index b64a667377e57eed036825d0f064334e0aab726f..a2edd2090aaad8363a029e10de11d3c61eea7c69 100644 (file)
 #ifndef __GTK_TREE_VIEW_COLUMN_H__
 #define __GTK_TREE_VIEW_COLUMN_H__
 
-#include <gtk/gtkobject.h>
+#include <glib-object.h>
 #include <gtk/gtkcellrenderer.h>
 #include <gtk/gtktreemodel.h>
+#include <gtk/gtktreesortable.h>
+
+/* Not needed, retained for compatibility -Yosh */
+#include <gtk/gtkobject.h>
+
 
-#ifdef __cplusplus
-extern "C" {
-#endif /* __cplusplus */
+G_BEGIN_DECLS
 
-#define GTK_TYPE_TREE_COLUMN                (gtk_tree_view_column_get_type ())
-#define GTK_TREE_VIEW_COLUMN(obj)           (GTK_CHECK_CAST ((obj), GTK_TYPE_TREE_COLUMN, GtkTreeViewColumn))
-#define GTK_TREE_VIEW_COLUMN_CLASS(klass)    (GTK_CHECK_CLASS_CAST ((klass), GTK_TYPE_TREE_COLUMN, GtkTreeViewColumnClass))
-#define GTK_IS_TREE_VIEW_COLUMN(obj)        (GTK_CHECK_TYPE ((obj), GTK_TYPE_TREE_COLUMN))
-#define GTK_IS_TREE_VIEW_COLUMN_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((obj), GTK_TYPE_TREE_COLUMN))
+
+#define GTK_TYPE_TREE_VIEW_COLUMN           (gtk_tree_view_column_get_type ())
+#define GTK_TREE_VIEW_COLUMN(obj)           (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_TREE_VIEW_COLUMN, GtkTreeViewColumn))
+#define GTK_TREE_VIEW_COLUMN_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_TREE_VIEW_COLUMN, GtkTreeViewColumnClass))
+#define GTK_IS_TREE_VIEW_COLUMN(obj)        (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TREE_VIEW_COLUMN))
+#define GTK_IS_TREE_VIEW_COLUMN_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_TREE_VIEW_COLUMN))
+#define GTK_TREE_VIEW_COLUMN_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_TREE_VIEW_COLUMN, GtkTreeViewColumnClass))
 
 typedef enum
 {
-  GTK_TREE_VIEW_COLUMN_RESIZEABLE,
+  GTK_TREE_VIEW_COLUMN_GROW_ONLY,
   GTK_TREE_VIEW_COLUMN_AUTOSIZE,
   GTK_TREE_VIEW_COLUMN_FIXED
 } GtkTreeViewColumnSizing;
@@ -44,35 +49,62 @@ typedef enum
 typedef struct _GtkTreeViewColumn      GtkTreeViewColumn;
 typedef struct _GtkTreeViewColumnClass GtkTreeViewColumnClass;
 
-typedef gboolean (* GtkTreeViewColumnFunc) (GtkTreeViewColumn *tree_column,
-                                           GtkTreeModel      *tree_model,
-                                           GtkTreeIter       *iter,
-                                           gpointer           data);
+typedef void (* GtkTreeCellDataFunc) (GtkTreeViewColumn *tree_column,
+                                     GtkCellRenderer   *cell,
+                                     GtkTreeModel      *tree_model,
+                                     GtkTreeIter       *iter,
+                                     gpointer           data);
 
+  
 struct _GtkTreeViewColumn
 {
   GtkObject parent;
 
   GtkWidget *tree_view;
   GtkWidget *button;
+  GtkWidget *child;  
+  GtkWidget *arrow;
+  GtkWidget *alignment;
   GdkWindow *window;
-  GtkJustification justification;
+  GtkCellEditable *editable_widget;
+  gfloat xalign;
+  guint property_changed_signal;
+  gint spacing;
 
-  gint id;
-  /* FIXME change this field to "width" bug 40061 */
-  gint size;
+  /* Sizing fields */
+  /* see gtk+/doc/tree-column-sizing.txt for more information on them */
+  GtkTreeViewColumnSizing column_type;
+  gint requested_width;
+  gint button_request;
+  gint resized_width;
+  gint width;
+  gint fixed_width;
   gint min_width;
   gint max_width;
 
-  GtkTreeViewColumnFunc *func;
-  gpointer func_data;
+  /* dragging columns */
+  gint drag_x;
+  gint drag_y;
+
   gchar *title;
-  GtkCellRenderer *cell;
-  GSList *attributes;
-  GtkTreeViewColumnSizing column_type;
-  guint visible       : 1;
-  guint button_active : 1;
-  guint dirty         : 1;
+  GList *cell_list;
+
+  /* Sorting */
+  guint sort_clicked_signal;
+  guint sort_column_changed_signal;
+  gint sort_column_id;
+  GtkSortType sort_order;
+
+  /* Flags */
+  guint visible             : 1;
+  guint resizable           : 1;
+  guint clickable           : 1;
+  guint dirty               : 1;
+  guint show_sort_indicator : 1;
+  guint maybe_reordered     : 1;
+  guint reorderable         : 1;
+  guint use_resized_width   : 1;
+  guint expand              : 1;
 };
 
 struct _GtkTreeViewColumnClass
@@ -80,61 +112,129 @@ struct _GtkTreeViewColumnClass
   GtkObjectClass parent_class;
 
   void (*clicked) (GtkTreeViewColumn *tree_column);
+
+  /* Padding for future expansion */
+  void (*_gtk_reserved1) (void);
+  void (*_gtk_reserved2) (void);
+  void (*_gtk_reserved3) (void);
+  void (*_gtk_reserved4) (void);
 };
 
+GType                   gtk_tree_view_column_get_type            (void) G_GNUC_CONST;
+GtkTreeViewColumn      *gtk_tree_view_column_new                 (void);
+GtkTreeViewColumn      *gtk_tree_view_column_new_with_attributes (const gchar             *title,
+                                                                 GtkCellRenderer         *cell,
+                                                                 ...) G_GNUC_NULL_TERMINATED;
+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,
+                                                                 ...) G_GNUC_NULL_TERMINATED;
+void                    gtk_tree_view_column_set_cell_data_func  (GtkTreeViewColumn       *tree_column,
+                                                                 GtkCellRenderer         *cell_renderer,
+                                                                 GtkTreeCellDataFunc      func,
+                                                                 gpointer                 func_data,
+                                                                 GtkDestroyNotify         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);
+
 
-GtkType            gtk_tree_view_column_get_type            (void);
-GtkTreeViewColumn *gtk_tree_view_column_new                 (void);
-GtkTreeViewColumn *gtk_tree_view_column_new_with_attributes (gchar                 *title,
-                                                            GtkCellRenderer       *cell,
-                                                            ...);
-void               gtk_tree_view_column_set_cell_renderer   (GtkTreeViewColumn     *tree_column,
-                                                            GtkCellRenderer       *cell);
-void               gtk_tree_view_column_add_attribute       (GtkTreeViewColumn     *tree_column,
-                                                            gchar                 *attribute,
-                                                            gint                   column);
-void               gtk_tree_view_column_set_attributes      (GtkTreeViewColumn     *tree_column,
-                                                            ...);
-void               gtk_tree_view_column_set_cell_data       (GtkTreeViewColumn     *tree_column,
-                                                            GtkTreeModel          *tree_model,
-                                                            GtkTreeIter           *iter);
-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_sizing        (GtkTreeViewColumn     *tree_column,
-                                                            GtkTreeViewColumnSizing  type);
-gint               gtk_tree_view_column_get_col_type        (GtkTreeViewColumn     *tree_column);
-gint               gtk_tree_view_column_get_size            (GtkTreeViewColumn     *tree_column);
-void               gtk_tree_view_column_set_width            (GtkTreeViewColumn     *tree_column,
-                                                            gint                   size);
-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);
 
 /* Options for manipulating the column headers
  */
-void               gtk_tree_view_column_set_title           (GtkTreeViewColumn     *tree_column,
-                                                            gchar                 *title);
-gchar             *gtk_tree_view_column_get_title           (GtkTreeViewColumn     *tree_column);
-void               gtk_tree_view_column_set_header_clickable   (GtkTreeViewColumn     *tree_column,
-                                                            gboolean               active);
-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_justification   (GtkTreeViewColumn     *tree_column,
-                                                            GtkJustification       justification);
-GtkJustification   gtk_tree_view_column_get_justification   (GtkTreeViewColumn     *tree_column);
-
-
+void                    gtk_tree_view_column_set_title           (GtkTreeViewColumn       *tree_column,
+                                                                 const gchar             *title);
+G_CONST_RETURN 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);
+
+
+
+/* You probably only want to use gtk_tree_view_column_set_sort_column_id.  The
+ * other sorting functions exist primarily to let others do their own custom sorting.
+ */
+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);
+
+
+/* These functions are meant primarily for interaction between the GtkTreeView and the 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,
+                                                                 GdkRectangle            *cell_area,
+                                                                 gint                    *x_offset,
+                                                                 gint                    *y_offset,
+                                                                 gint                    *width,
+                                                                 gint                    *height);
+gboolean                gtk_tree_view_column_cell_is_visible     (GtkTreeViewColumn       *tree_column);
+void                    gtk_tree_view_column_focus_cell          (GtkTreeViewColumn       *tree_column,
+                                                                 GtkCellRenderer         *cell);
+gboolean                gtk_tree_view_column_cell_get_position   (GtkTreeViewColumn       *tree_column,
+                                                                 GtkCellRenderer         *cell_renderer,
+                                                                 gint                    *start_pos,
+                                                                 gint                    *width);
+void                    gtk_tree_view_column_queue_resize        (GtkTreeViewColumn       *tree_column);
+
+
+G_END_DECLS
 
-#ifdef __cplusplus
-}
-#endif /* __cplusplus */
 
 #endif /* __GTK_TREE_VIEW_COLUMN_H__ */
+