]> Pileus Git - ~andy/gtk/blobdiff - gtk/gtkctree.h
GtkToolPalette: Change gtk_tool_palette_get_drop_group() return.
[~andy/gtk] / gtk / gtkctree.h
index f3cf56d64ec998054b356576a626b178b4fb88aa..a4aa83773bdd4d39e3f3bc67efe9affb634d525f 100644 (file)
@@ -6,35 +6,43 @@
  * Copyright (C) 1998 Lars Hamann and Stefan Jeske
  *
  * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Library General Public
+ * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
  * version 2 of the License, or (at your option) any later version.
  *
  * This library is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Library General Public License for more details.
+ * Lesser General Public License for more details.
  *
- * You should have received a copy of the GNU Library General Public
+ * You should have received a copy of the GNU Lesser General Public
  * License along with this library; if not, write to the
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
 
+/*
+ * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
+ * file for a list of people on the GTK+ Team.  See the ChangeLog
+ * files for a list of changes.  These files are distributed with
+ * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
+ */
+
+#if !defined (GTK_DISABLE_DEPRECATED) || defined (__GTK_CLIST_C__) || defined (__GTK_CTREE_C__)
+
 #ifndef __GTK_CTREE_H__
 #define __GTK_CTREE_H__
 
 #include <gtk/gtkclist.h>
 
-#ifdef __cplusplus
-extern "C" {
-#endif                         /* __cplusplus */
+G_BEGIN_DECLS
 
 #define GTK_TYPE_CTREE            (gtk_ctree_get_type ())
-#define GTK_CTREE(obj)            (GTK_CHECK_CAST ((obj), GTK_TYPE_CTREE, GtkCTree))
-#define GTK_CTREE_CLASS(klass)    (GTK_CHECK_CLASS_CAST ((klass), GTK_TYPE_CTREE, GtkCTreeClass))
-#define GTK_IS_CTREE(obj)         (GTK_CHECK_TYPE ((obj), GTK_TYPE_CTREE))
-#define GTK_IS_CTREE_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GTK_TYPE_CTREE))
+#define GTK_CTREE(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_CTREE, GtkCTree))
+#define GTK_CTREE_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_CTREE, GtkCTreeClass))
+#define GTK_IS_CTREE(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_CTREE))
+#define GTK_IS_CTREE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_CTREE))
+#define GTK_CTREE_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_CTREE, GtkCTreeClass))
 
 #define GTK_CTREE_ROW(_node_) ((GtkCTreeRow *)(((GList *)(_node_))->data))
 #define GTK_CTREE_NODE(_node_) ((GtkCTreeNode *)((_node_)))
@@ -42,6 +50,8 @@ extern "C" {
 #define GTK_CTREE_NODE_PREV(_pnode_) ((GtkCTreeNode *)(((GList *)(_pnode_))->prev))
 #define GTK_CTREE_FUNC(_func_) ((GtkCTreeFunc)(_func_))
 
+#define GTK_TYPE_CTREE_NODE (gtk_ctree_node_get_type ())
+
 typedef enum
 {
   GTK_CTREE_POS_BEFORE,
@@ -51,12 +61,20 @@ typedef enum
 
 typedef enum
 {
+  GTK_CTREE_LINES_NONE,
   GTK_CTREE_LINES_SOLID,
   GTK_CTREE_LINES_DOTTED,
-  GTK_CTREE_LINES_TABBED,
-  GTK_CTREE_LINES_NONE
+  GTK_CTREE_LINES_TABBED
 } GtkCTreeLineStyle;
 
+typedef enum
+{
+  GTK_CTREE_EXPANDER_NONE,
+  GTK_CTREE_EXPANDER_SQUARE,
+  GTK_CTREE_EXPANDER_TRIANGLE,
+  GTK_CTREE_EXPANDER_CIRCULAR
+} GtkCTreeExpanderStyle;
+
 typedef enum
 {
   GTK_CTREE_EXPANSION_EXPAND,
@@ -92,23 +110,14 @@ struct _GtkCTree
   GtkCList clist;
   
   GdkGC *lines_gc;
-  GdkWindow *drag_icon;
-  gint icon_width;
-  gint icon_height;
   
   gint tree_indent;
+  gint tree_spacing;
   gint tree_column;
-  gint drag_row;
-  GtkCTreeNode *drag_source;
-  GtkCTreeNode *drag_target;
-  gint insert_pos;
-
-  guint reorderable : 1;
-  guint use_icons   : 1;
-  guint in_drag     : 1;
-  guint drag_rect   : 1;
-  guint line_style  : 2;
-  guint show_stub   : 1;
+
+  guint line_style     : 2;
+  guint expander_style : 2;
+  guint show_stub      : 1;
 
   GtkCTreeCompareDragFunc drag_compare;
 };
@@ -163,11 +172,7 @@ struct _GtkCTreeNode {
  *           Creation, insertion, deletion                 *
  ***********************************************************/
 
-GtkType gtk_ctree_get_type                       (void);
-void gtk_ctree_construct                         (GtkCTree     *ctree,
-                                                 gint          columns, 
-                                                 gint          tree_column,
-                                                 gchar        *titles[]);
+GType   gtk_ctree_get_type                       (void) G_GNUC_CONST;
 GtkWidget * gtk_ctree_new_with_titles            (gint          columns, 
                                                  gint          tree_column,
                                                  gchar        *titles[]);
@@ -228,6 +233,8 @@ GtkCTreeNode * gtk_ctree_last                    (GtkCTree     *ctree,
                                                  GtkCTreeNode *node);
 GtkCTreeNode * gtk_ctree_find_node_ptr           (GtkCTree     *ctree,
                                                  GtkCTreeRow  *ctree_row);
+GtkCTreeNode * gtk_ctree_node_nth                (GtkCTree     *ctree,
+                                                 guint         row);
 gboolean gtk_ctree_find                          (GtkCTree     *ctree,
                                                  GtkCTreeNode *node,
                                                  GtkCTreeNode *child);
@@ -335,23 +342,23 @@ gboolean gtk_ctree_node_get_selectable           (GtkCTree     *ctree,
 GtkCellType gtk_ctree_node_get_cell_type         (GtkCTree     *ctree,
                                                  GtkCTreeNode *node,
                                                  gint          column);
-gint gtk_ctree_node_get_text                     (GtkCTree     *ctree,
+gboolean gtk_ctree_node_get_text                 (GtkCTree     *ctree,
                                                  GtkCTreeNode *node,
                                                  gint          column,
                                                  gchar       **text);
-gint gtk_ctree_node_get_pixmap                   (GtkCTree     *ctree,
+gboolean gtk_ctree_node_get_pixmap               (GtkCTree     *ctree,
                                                  GtkCTreeNode *node,
                                                  gint          column,
                                                  GdkPixmap   **pixmap,
                                                  GdkBitmap   **mask);
-gint gtk_ctree_node_get_pixtext                  (GtkCTree     *ctree,
+gboolean gtk_ctree_node_get_pixtext              (GtkCTree     *ctree,
                                                  GtkCTreeNode *node,
                                                  gint          column,
                                                  gchar       **text,
                                                  guint8       *spacing,
                                                  GdkPixmap   **pixmap,
                                                  GdkBitmap   **mask);
-gint gtk_ctree_get_node_info                     (GtkCTree     *ctree,
+gboolean gtk_ctree_get_node_info                 (GtkCTree     *ctree,
                                                  GtkCTreeNode *node,
                                                  gchar       **text,
                                                  guint8       *spacing,
@@ -361,19 +368,31 @@ gint gtk_ctree_get_node_info                     (GtkCTree     *ctree,
                                                  GdkBitmap   **mask_opened,
                                                  gboolean     *is_leaf,
                                                  gboolean     *expanded);
-void gtk_ctree_node_set_foreground               (GtkCTree     *ctree,
+void gtk_ctree_node_set_row_style                (GtkCTree     *ctree,
                                                  GtkCTreeNode *node,
-                                                 GdkColor     *color);
-void gtk_ctree_node_set_background               (GtkCTree     *ctree,
+                                                 GtkStyle     *style);
+GtkStyle * gtk_ctree_node_get_row_style          (GtkCTree     *ctree,
+                                                 GtkCTreeNode *node);
+void gtk_ctree_node_set_cell_style               (GtkCTree     *ctree,
+                                                 GtkCTreeNode *node,
+                                                 gint          column,
+                                                 GtkStyle     *style);
+GtkStyle * gtk_ctree_node_get_cell_style         (GtkCTree     *ctree,
                                                  GtkCTreeNode *node,
-                                                 GdkColor     *color);
+                                                 gint          column);
+void gtk_ctree_node_set_foreground               (GtkCTree       *ctree,
+                                                 GtkCTreeNode   *node,
+                                                 const GdkColor *color);
+void gtk_ctree_node_set_background               (GtkCTree       *ctree,
+                                                 GtkCTreeNode   *node,
+                                                 const GdkColor *color);
 void gtk_ctree_node_set_row_data                 (GtkCTree     *ctree,
                                                  GtkCTreeNode *node,
                                                  gpointer      data);
 void gtk_ctree_node_set_row_data_full            (GtkCTree     *ctree,
                                                  GtkCTreeNode *node,
                                                  gpointer      data,
-                                                 GtkDestroyNotify destroy);
+                                                 GDestroyNotify destroy);
 gpointer gtk_ctree_node_get_row_data             (GtkCTree     *ctree,
                                                  GtkCTreeNode *node);
 void gtk_ctree_node_moveto                       (GtkCTree     *ctree,
@@ -388,18 +407,18 @@ GtkVisibility gtk_ctree_node_is_visible          (GtkCTree     *ctree,
  *             GtkCTree specific functions                 *
  ***********************************************************/
 
-void gtk_ctree_set_indent                        (GtkCTree     *ctree, 
-                                                 gint          indent);
-void gtk_ctree_show_stub                         (GtkCTree     *ctree, 
-                                                 gboolean      show_stub);
-void gtk_ctree_set_reorderable                   (GtkCTree     *ctree,
-                                                 gboolean      reorderable);
-void gtk_ctree_set_use_drag_icons                (GtkCTree     *ctree,
-                                                 gboolean      use_icons);
-void gtk_ctree_set_line_style                    (GtkCTree     *ctree, 
-                                                 GtkCTreeLineStyle line_style);
-void gtk_ctree_set_drag_compare_func              (GtkCTree                    *ctree,
-                                                  GtkCTreeCompareDragFunc      cmp_func);
+void gtk_ctree_set_indent            (GtkCTree                *ctree, 
+                                     gint                     indent);
+void gtk_ctree_set_spacing           (GtkCTree                *ctree, 
+                                     gint                     spacing);
+void gtk_ctree_set_show_stub         (GtkCTree                *ctree, 
+                                     gboolean                 show_stub);
+void gtk_ctree_set_line_style        (GtkCTree                *ctree, 
+                                     GtkCTreeLineStyle        line_style);
+void gtk_ctree_set_expander_style    (GtkCTree                *ctree, 
+                                     GtkCTreeExpanderStyle    expander_style);
+void gtk_ctree_set_drag_compare_func (GtkCTree               *ctree,
+                                     GtkCTreeCompareDragFunc  cmp_func);
 
 /***********************************************************
  *             Tree sorting functions                      *
@@ -409,8 +428,18 @@ void gtk_ctree_sort_node                         (GtkCTree     *ctree,
                                                  GtkCTreeNode *node);
 void gtk_ctree_sort_recursive                    (GtkCTree     *ctree, 
                                                  GtkCTreeNode *node);
-#ifdef __cplusplus
-}
-#endif                         /* __cplusplus */
+
+
+#define gtk_ctree_set_reorderable(t,r)                    gtk_clist_set_reorderable((GtkCList*) (t),(r))
+
+/* GType for the GtkCTreeNode.  This is a boxed type, although it uses
+ * no-op's for the copy and free routines.  It is defined in order to
+ * provide type information for the signal arguments
+ */
+GType   gtk_ctree_node_get_type                  (void) G_GNUC_CONST;
+
+G_END_DECLS
 
 #endif                         /* __GTK_CTREE_H__ */
+
+#endif /* GTK_DISABLE_DEPRECATED */