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

   1 /* gtktreeprivate.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_PRIVATE_H__
  21 #define __GTK_TREE_PRIVATE_H__
  22
  23
  24 G_BEGIN_DECLS
  25
  26
  27 #include <gtk/gtktreeview.h>
  28 #include <gtk/gtktreeselection.h>
  29 #include <gtk/gtkrbtree.h>
  30
  31 #define TREE_VIEW_DRAG_WIDTH 6
  32
  33 typedef enum
  34 {
  35   GTK_TREE_VIEW_IS_LIST = 1 << 0,
  36   GTK_TREE_VIEW_SHOW_EXPANDERS = 1 << 1,
  37   GTK_TREE_VIEW_IN_COLUMN_RESIZE = 1 << 2,
  38   GTK_TREE_VIEW_ARROW_PRELIT = 1 << 3,
  39   GTK_TREE_VIEW_HEADERS_VISIBLE = 1 << 4,
  40   GTK_TREE_VIEW_DRAW_KEYFOCUS = 1 << 5,
  41   GTK_TREE_VIEW_MODEL_SETUP = 1 << 6,
  42   GTK_TREE_VIEW_IN_COLUMN_DRAG = 1 << 7
  43 } GtkTreeViewFlags;
  44
  45 typedef enum
  46 {
  47   GTK_TREE_SELECT_MODE_TOGGLE = 1 << 0,
  48   GTK_TREE_SELECT_MODE_EXTEND = 1 << 1
  49 }
  50 GtkTreeSelectMode;
  51
  52 enum
  53 {
  54   DRAG_COLUMN_WINDOW_STATE_UNSET = 0,
  55   DRAG_COLUMN_WINDOW_STATE_ORIGINAL = 1,
  56   DRAG_COLUMN_WINDOW_STATE_ARROW = 2,
  57   DRAG_COLUMN_WINDOW_STATE_ARROW_LEFT = 3,
  58   DRAG_COLUMN_WINDOW_STATE_ARROW_RIGHT = 4
  59 };
  60
  61 enum
  62 {
  63   RUBBER_BAND_OFF = 0,
  64   RUBBER_BAND_MAYBE_START = 1,
  65   RUBBER_BAND_ACTIVE = 2
  66 };
  67
  68 #define GTK_TREE_VIEW_SET_FLAG(tree_view, flag)   G_STMT_START{ (tree_view->priv->flags|=flag); }G_STMT_END
  69 #define GTK_TREE_VIEW_UNSET_FLAG(tree_view, flag) G_STMT_START{ (tree_view->priv->flags&=~(flag)); }G_STMT_END
  70 #define GTK_TREE_VIEW_FLAG_SET(tree_view, flag)   ((tree_view->priv->flags&flag)==flag)
  71 #define TREE_VIEW_HEADER_HEIGHT(tree_view)        (GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_HEADERS_VISIBLE)?tree_view->priv->header_height:0)
  72 #define TREE_VIEW_COLUMN_REQUESTED_WIDTH(column)  (CLAMP (column->requested_width, (column->min_width!=-1)?column->min_width:column->requested_width, (column->max_width!=-1)?column->max_width:column->requested_width))
  73 #define TREE_VIEW_DRAW_EXPANDERS(tree_view)       (!GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_IS_LIST)&&GTK_TREE_VIEW_FLAG_SET (tree_view, GTK_TREE_VIEW_SHOW_EXPANDERS))
  74
  75  /* This lovely little value is used to determine how far away from the title bar
  76   * you can move the mouse and still have a column drag work.
  77   */
  78 #define TREE_VIEW_COLUMN_DRAG_DEAD_MULTIPLIER(tree_view) (10*TREE_VIEW_HEADER_HEIGHT(tree_view))
  79
  80 #define GTK_TREE_VIEW_COLUMN_GET_PRIVATE(column) (G_TYPE_INSTANCE_GET_PRIVATE ((column), GTK_TYPE_TREE_VIEW_COLUMN, GtkTreeViewColumnPrivate))
  81
  82 typedef struct _GtkTreeViewColumnReorder GtkTreeViewColumnReorder;
  83 struct _GtkTreeViewColumnReorder
  84 {
  85   gint left_align;
  86   gint right_align;
  87   GtkTreeViewColumn *left_column;
  88   GtkTreeViewColumn *right_column;
  89 };
  90
  91 struct _GtkTreeViewPrivate
  92 {
  93   GtkTreeModel *model;
  94
  95   guint flags;
  96   /* tree information */
  97   GtkRBTree *tree;
  98
  99   /* Container info */
 100   GList *children;
 101   gint width;
 102   gint height;
 103
 104   /* Adjustments */
 105   GtkAdjustment *hadjustment;
 106   GtkAdjustment *vadjustment;
 107
 108   /* Sub windows */
 109   GdkWindow *bin_window;
 110   GdkWindow *header_window;
 111
 112   /* Scroll position state keeping */
 113   GtkTreeRowReference *top_row;
 114   gint top_row_dy;
 115   /* dy == y pos of top_row + top_row_dy */
 116   /* we cache it for simplicity of the code */
 117   gint dy;
 118
 119   guint presize_handler_timer;
 120   guint validate_rows_timer;
 121   guint scroll_sync_timer;
 122
 123   /* Indentation and expander layout */
 124   gint expander_size;
 125   GtkTreeViewColumn *expander_column;
 126
 127   gint level_indentation;
 128
 129   /* Key navigation (focus), selection */
 130   gint cursor_offset;
 131
 132   GtkTreeRowReference *anchor;
 133   GtkTreeRowReference *cursor;
 134
 135   GtkTreeViewColumn *focus_column;
 136
 137   /* Current pressed node, previously pressed, prelight */
 138   GtkRBNode *button_pressed_node;
 139   GtkRBTree *button_pressed_tree;
 140
 141   gint pressed_button;
 142   gint press_start_x;
 143   gint press_start_y;
 144
 145   gint event_last_x;
 146   gint event_last_y;
 147
 148   guint last_button_time;
 149   gint last_button_x;
 150   gint last_button_y;
 151
 152   GtkRBNode *prelight_node;
 153   GtkRBTree *prelight_tree;
 154
 155   /* Cell Editing */
 156   GtkTreeViewColumn *edited_column;
 157
 158   /* The node that's currently being collapsed or expanded */
 159   GtkRBNode *expanded_collapsed_node;
 160   GtkRBTree *expanded_collapsed_tree;
 161   guint expand_collapse_timeout;
 162
 163   /* Auto expand/collapse timeout in hover mode */
 164   guint auto_expand_timeout;
 165
 166   /* Selection information */
 167   GtkTreeSelection *selection;
 168
 169   /* Header information */
 170   gint n_columns;
 171   GList *columns;
 172   gint header_height;
 173
 174   GtkTreeViewColumnDropFunc column_drop_func;
 175   gpointer column_drop_func_data;
 176   GDestroyNotify column_drop_func_data_destroy;
 177   GList *column_drag_info;
 178   GtkTreeViewColumnReorder *cur_reorder;
 179
 180   gint prev_width_before_expander;
 181
 182   /* Interactive Header reordering */
 183   GdkWindow *drag_window;
 184   GdkWindow *drag_highlight_window;
 185   GtkTreeViewColumn *drag_column;
 186   gint drag_column_x;
 187
 188   /* Interactive Header Resizing */
 189   gint drag_pos;
 190   gint x_drag;
 191
 192   /* Non-interactive Header Resizing, expand flag support */
 193   gint prev_width;
 194
 195   gint last_extra_space;
 196   gint last_extra_space_per_column;
 197   gint last_number_of_expand_columns;
 198
 199   /* ATK Hack */
 200   GtkTreeDestroyCountFunc destroy_count_func;
 201   gpointer destroy_count_data;
 202   GDestroyNotify destroy_count_destroy;
 203
 204   /* Scroll timeout (e.g. during dnd, rubber banding) */
 205   guint scroll_timeout;
 206
 207   /* Row drag-and-drop */
 208   GtkTreeRowReference *drag_dest_row;
 209   GtkTreeViewDropPosition drag_dest_pos;
 210   guint open_dest_timeout;
 211
 212   /* Rubber banding */
 213   gint rubber_band_status;
 214   gint rubber_band_x;
 215   gint rubber_band_y;
 216   gint rubber_band_shift;
 217   gint rubber_band_ctrl;
 218
 219   GtkRBNode *rubber_band_start_node;
 220   GtkRBTree *rubber_band_start_tree;
 221
 222   GtkRBNode *rubber_band_end_node;
 223   GtkRBTree *rubber_band_end_tree;
 224
 225   /* fixed height */
 226   gint fixed_height;
 227
 228   /* Scroll-to functionality when unrealized */
 229   GtkTreeRowReference *scroll_to_path;
 230   GtkTreeViewColumn *scroll_to_column;
 231   gfloat scroll_to_row_align;
 232   gfloat scroll_to_col_align;
 233
 234   /* Interactive search */
 235   gint selected_iter;
 236   gint search_column;
 237   GtkTreeViewSearchPositionFunc search_position_func;
 238   GtkTreeViewSearchEqualFunc search_equal_func;
 239   gpointer search_user_data;
 240   GDestroyNotify search_destroy;
 241   gpointer search_position_user_data;
 242   GDestroyNotify search_position_destroy;
 243   GtkWidget *search_window;
 244   GtkWidget *search_entry;
 245   guint search_entry_changed_id;
 246   guint typeselect_flush_timeout;
 247
 248   /* Grid and tree lines */
 249   GtkTreeViewGridLines grid_lines;
 250   GdkGC *grid_line_gc;
 251
 252   gboolean tree_lines_enabled;
 253   GdkGC *tree_line_gc;
 254
 255   /* Row separators */
 256   GtkTreeViewRowSeparatorFunc row_separator_func;
 257   gpointer row_separator_data;
 258   GDestroyNotify row_separator_destroy;
 259
 260   /* Tooltip support */
 261   gint tooltip_column;
 262
 263   /* Here comes the bitfield */
 264   guint scroll_to_use_align : 1;
 265
 266   guint fixed_height_mode : 1;
 267   guint fixed_height_check : 1;
 268
 269   guint reorderable : 1;
 270   guint header_has_focus : 1;
 271   guint drag_column_window_state : 3;
 272   /* hint to display rows in alternating colors */
 273   guint has_rules : 1;
 274   guint mark_rows_col_dirty : 1;
 275
 276   /* for DnD */
 277   guint empty_view_drop : 1;
 278
 279   guint ctrl_pressed : 1;
 280   guint shift_pressed : 1;
 281
 282   guint init_hadjust_value : 1;
 283
 284   guint in_top_row_to_dy : 1;
 285
 286   /* interactive search */
 287   guint enable_search : 1;
 288   guint disable_popdown : 1;
 289   guint search_custom_entry_set : 1;
 290
 291   guint hover_selection : 1;
 292   guint hover_expand : 1;
 293   guint imcontext_changed : 1;
 294
 295   guint rubber_banding_enable : 1;
 296
 297   guint in_grab : 1;
 298
 299   guint post_validation_flag : 1;
 300
 301   /* Whether our key press handler is to avoid sending an unhandled binding to the search entry */
 302   guint search_entry_avoid_unhandled_binding : 1;
 303 };
 304
 305 struct _GtkTreeViewColumnPrivate
 306 {
 307   gint natural_width;
 308 };
 309
 310 #ifdef __GNUC__
 311
 312 #define TREE_VIEW_INTERNAL_ASSERT(expr, ret)     G_STMT_START{          \
 313      if (!(expr))                                                       \
 314        {                                                                \
 315          g_log (G_LOG_DOMAIN,                                           \
 316                 G_LOG_LEVEL_CRITICAL,                                   \
 317                 "%s (%s): assertion `%s' failed.\n"                     \
 318                 "There is a disparity between the internal view of the GtkTreeView,\n"    \
 319                 "and the GtkTreeModel.  This generally means that the model has changed\n"\
 320                 "without letting the view know.  Any display from now on is likely to\n"  \
 321                 "be incorrect.\n",                                                        \
 322                 G_STRLOC,                                               \
 323                 G_STRFUNC,                                              \
 324                 #expr);                                                 \
 325          return ret;                                                    \
 326        };                               }G_STMT_END
 327
 328 #define TREE_VIEW_INTERNAL_ASSERT_VOID(expr)     G_STMT_START{          \
 329      if (!(expr))                                                       \
 330        {                                                                \
 331          g_log (G_LOG_DOMAIN,                                           \
 332                 G_LOG_LEVEL_CRITICAL,                                   \
 333                 "%s (%s): assertion `%s' failed.\n"                     \
 334                 "There is a disparity between the internal view of the GtkTreeView,\n"    \
 335                 "and the GtkTreeModel.  This generally means that the model has changed\n"\
 336                 "without letting the view know.  Any display from now on is likely to\n"  \
 337                 "be incorrect.\n",                                                        \
 338                 G_STRLOC,                                               \
 339                 G_STRFUNC,                                              \
 340                 #expr);                                                 \
 341          return;                                                        \
 342        };                               }G_STMT_END
 343
 344 #else
 345
 346 #define TREE_VIEW_INTERNAL_ASSERT(expr, ret)     G_STMT_START{          \
 347      if (!(expr))                                                       \
 348        {                                                                \
 349          g_log (G_LOG_DOMAIN,                                           \
 350                 G_LOG_LEVEL_CRITICAL,                                   \
 351                 "file %s: line %d: assertion `%s' failed.\n"       \
 352                 "There is a disparity between the internal view of the GtkTreeView,\n"    \
 353                 "and the GtkTreeModel.  This generally means that the model has changed\n"\
 354                 "without letting the view know.  Any display from now on is likely to\n"  \
 355                 "be incorrect.\n",                                                        \
 356                 __FILE__,                                               \
 357                 __LINE__,                                               \
 358                 #expr);                                                 \
 359          return ret;                                                    \
 360        };                               }G_STMT_END
 361
 362 #define TREE_VIEW_INTERNAL_ASSERT_VOID(expr)     G_STMT_START{          \
 363      if (!(expr))                                                       \
 364        {                                                                \
 365          g_log (G_LOG_DOMAIN,                                           \
 366                 G_LOG_LEVEL_CRITICAL,                                   \
 367                 "file %s: line %d: assertion '%s' failed.\n"            \
 368                 "There is a disparity between the internal view of the GtkTreeView,\n"    \
 369                 "and the GtkTreeModel.  This generally means that the model has changed\n"\
 370                 "without letting the view know.  Any display from now on is likely to\n"  \
 371                 "be incorrect.\n",                                                        \
 372                 __FILE__,                                               \
 373                 __LINE__,                                               \
 374                 #expr);                                                 \
 375          return;                                                        \
 376        };                               }G_STMT_END
 377 #endif
 378
 379
 380 /* functions that shouldn't be exported */
 381 void         _gtk_tree_selection_internal_select_node (GtkTreeSelection  *selection,
 382                                                        GtkRBNode         *node,
 383                                                        GtkRBTree         *tree,
 384                                                        GtkTreePath       *path,
 385                                                        GtkTreeSelectMode  mode,
 386                                                        gboolean           override_browse_mode);
 387 void         _gtk_tree_selection_emit_changed         (GtkTreeSelection  *selection);
 388 gboolean     _gtk_tree_view_find_node                 (GtkTreeView       *tree_view,
 389                                                        GtkTreePath       *path,
 390                                                        GtkRBTree        **tree,
 391                                                        GtkRBNode        **node);
 392 GtkTreePath *_gtk_tree_view_find_path                 (GtkTreeView       *tree_view,
 393                                                        GtkRBTree         *tree,
 394                                                        GtkRBNode         *node);
 395 void         _gtk_tree_view_child_move_resize         (GtkTreeView       *tree_view,
 396                                                        GtkWidget         *widget,
 397                                                        gint               x,
 398                                                        gint               y,
 399                                                        gint               width,
 400                                                        gint               height);
 401 void         _gtk_tree_view_queue_draw_node           (GtkTreeView       *tree_view,
 402                                                        GtkRBTree         *tree,
 403                                                        GtkRBNode         *node,
 404                                                        const GdkRectangle *clip_rect);
 405
 406 void _gtk_tree_view_column_realize_button   (GtkTreeViewColumn *column);
 407 void _gtk_tree_view_column_unrealize_button (GtkTreeViewColumn *column);
 408 void _gtk_tree_view_column_set_tree_view    (GtkTreeViewColumn *column,
 409                                              GtkTreeView       *tree_view);
 410 void _gtk_tree_view_column_unset_model      (GtkTreeViewColumn *column,
 411                                              GtkTreeModel      *old_model);
 412 void _gtk_tree_view_column_unset_tree_view  (GtkTreeViewColumn *column);
 413 void _gtk_tree_view_column_set_width        (GtkTreeViewColumn *column,
 414                                              gint               width);
 415 void _gtk_tree_view_column_start_drag       (GtkTreeView       *tree_view,
 416                                              GtkTreeViewColumn *column);
 417 gboolean _gtk_tree_view_column_cell_event   (GtkTreeViewColumn  *tree_column,
 418                                              GtkCellEditable   **editable_widget,
 419                                              GdkEvent           *event,
 420                                              gchar              *path_string,
 421                                              const GdkRectangle *background_area,
 422                                              const GdkRectangle *cell_area,
 423                                              guint               flags);
 424 void _gtk_tree_view_column_start_editing (GtkTreeViewColumn *tree_column,
 425                                           GtkCellEditable   *editable_widget);
 426 void _gtk_tree_view_column_stop_editing  (GtkTreeViewColumn *tree_column);
 427 void _gtk_tree_view_install_mark_rows_col_dirty (GtkTreeView *tree_view);
 428 void             _gtk_tree_view_column_autosize          (GtkTreeView       *tree_view,
 429                                                           GtkTreeViewColumn *column);
 430
 431 gboolean         _gtk_tree_view_column_has_editable_cell (GtkTreeViewColumn *column);
 432 GtkCellRenderer *_gtk_tree_view_column_get_edited_cell   (GtkTreeViewColumn *column);
 433 gint             _gtk_tree_view_column_count_special_cells (GtkTreeViewColumn *column);
 434 GtkCellRenderer *_gtk_tree_view_column_get_cell_at_pos   (GtkTreeViewColumn *column,
 435                                                           gint               x);
 436
 437 GtkTreeSelection* _gtk_tree_selection_new                (void);
 438 GtkTreeSelection* _gtk_tree_selection_new_with_tree_view (GtkTreeView      *tree_view);
 439 void              _gtk_tree_selection_set_tree_view      (GtkTreeSelection *selection,
 440                                                           GtkTreeView      *tree_view);
 441 gboolean          _gtk_tree_selection_row_is_selectable  (GtkTreeSelection *selection,
 442                                                           GtkRBNode        *node,
 443                                                           GtkTreePath      *path);
 444
 445 void              _gtk_tree_view_column_cell_render      (GtkTreeViewColumn  *tree_column,
 446                                                           GdkWindow          *window,
 447                                                           const GdkRectangle *background_area,
 448                                                           const GdkRectangle *cell_area,
 449                                                           const GdkRectangle *expose_area,
 450                                                           guint               flags);
 451 void              _gtk_tree_view_column_get_focus_area   (GtkTreeViewColumn  *tree_column,
 452                                                           const GdkRectangle *background_area,
 453                                                           const GdkRectangle *cell_area,
 454                                                           GdkRectangle       *focus_area);
 455 gboolean          _gtk_tree_view_column_cell_focus       (GtkTreeViewColumn  *tree_column,
 456                                                           gint                direction,
 457                                                           gboolean            left,
 458                                                           gboolean            right);
 459 void              _gtk_tree_view_column_cell_draw_focus  (GtkTreeViewColumn  *tree_column,
 460                                                           GdkWindow          *window,
 461                                                           const GdkRectangle *background_area,
 462                                                           const GdkRectangle *cell_area,
 463                                                           const GdkRectangle *expose_area,
 464                                                           guint               flags);
 465 void              _gtk_tree_view_column_cell_set_dirty   (GtkTreeViewColumn  *tree_column,
 466                                                           gboolean            install_handler);
 467 void              _gtk_tree_view_column_get_neighbor_sizes (GtkTreeViewColumn *column,
 468                                                             GtkCellRenderer   *cell,
 469                                                             gint              *left,
 470                                                             gint              *right);
 471
 472
 473 G_END_DECLS
 474
 475
 476 #endif /* __GTK_TREE_PRIVATE_H__ */
 477