Pileus Git - ~andy/gtk/blob - gtk/gtkpaned.c

   1 /* GTK - The GIMP Toolkit
   2  * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
   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 /*
  21  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
  22  * file for a list of people on the GTK+ Team.  See the ChangeLog
  23  * files for a list of changes.  These files are distributed with
  24  * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
  25  */
  26
  27 #include "gtkpaned.h"
  28
  29 enum {
  30   ARG_0,
  31   ARG_HANDLE_SIZE
  32 };
  33
  34 static void    gtk_paned_class_init (GtkPanedClass  *klass);
  35 static void    gtk_paned_init       (GtkPaned       *paned);
  36 static void    gtk_paned_set_arg    (GtkObject      *object,
  37                                      GtkArg         *arg,
  38                                      guint           arg_id);
  39 static void    gtk_paned_get_arg    (GtkObject      *object,
  40                                      GtkArg         *arg,
  41                                      guint           arg_id);
  42 static void    gtk_paned_realize    (GtkWidget      *widget);
  43 static void    gtk_paned_map        (GtkWidget      *widget);
  44 static void    gtk_paned_unmap      (GtkWidget      *widget);
  45 static void    gtk_paned_unrealize  (GtkWidget      *widget);
  46 static gint    gtk_paned_expose     (GtkWidget      *widget,
  47                                      GdkEventExpose *event);
  48 static void    gtk_paned_add        (GtkContainer   *container,
  49                                      GtkWidget      *widget);
  50 static void    gtk_paned_remove     (GtkContainer   *container,
  51                                      GtkWidget      *widget);
  52 static void    gtk_paned_forall     (GtkContainer   *container,
  53                                      gboolean        include_internals,
  54                                      GtkCallback     callback,
  55                                      gpointer        callback_data);
  56 static GtkType gtk_paned_child_type (GtkContainer   *container);
  57
  58 static GtkContainerClass *parent_class = NULL;
  59
  60
  61 GtkType
  62 gtk_paned_get_type (void)
  63 {
  64   static GtkType paned_type = 0;
  65
  66   if (!paned_type)
  67     {
  68       static const GtkTypeInfo paned_info =
  69       {
  70         "GtkPaned",
  71         sizeof (GtkPaned),
  72         sizeof (GtkPanedClass),
  73         (GtkClassInitFunc) gtk_paned_class_init,
  74         (GtkObjectInitFunc) gtk_paned_init,
  75         /* reserved_1 */ NULL,
  76         /* reserved_2 */ NULL,
  77         (GtkClassInitFunc) NULL,
  78       };
  79
  80       paned_type = gtk_type_unique (GTK_TYPE_CONTAINER, &paned_info);
  81     }
  82
  83   return paned_type;
  84 }
  85
  86 static void
  87 gtk_paned_class_init (GtkPanedClass *class)
  88 {
  89   GtkObjectClass *object_class;
  90   GtkWidgetClass *widget_class;
  91   GtkContainerClass *container_class;
  92
  93   object_class = (GtkObjectClass *) class;
  94   widget_class = (GtkWidgetClass *) class;
  95   container_class = (GtkContainerClass *) class;
  96
  97   parent_class = gtk_type_class (GTK_TYPE_CONTAINER);
  98
  99   object_class->set_arg = gtk_paned_set_arg;
 100   object_class->get_arg = gtk_paned_get_arg;
 101
 102   widget_class->realize = gtk_paned_realize;
 103   widget_class->map = gtk_paned_map;
 104   widget_class->unmap = gtk_paned_unmap;
 105   widget_class->unrealize = gtk_paned_unrealize;
 106   widget_class->expose_event = gtk_paned_expose;
 107
 108   container_class->add = gtk_paned_add;
 109   container_class->remove = gtk_paned_remove;
 110   container_class->forall = gtk_paned_forall;
 111   container_class->child_type = gtk_paned_child_type;
 112
 113   gtk_object_add_arg_type("GtkPaned::handle_size", GTK_TYPE_UINT,
 114                           GTK_ARG_READWRITE, ARG_HANDLE_SIZE);
 115 }
 116
 117 static GtkType
 118 gtk_paned_child_type (GtkContainer *container)
 119 {
 120   if (!GTK_PANED (container)->child1 || !GTK_PANED (container)->child2)
 121     return GTK_TYPE_WIDGET;
 122   else
 123     return GTK_TYPE_NONE;
 124 }
 125
 126 static void
 127 gtk_paned_init (GtkPaned *paned)
 128 {
 129   GTK_WIDGET_UNSET_FLAGS (paned, GTK_NO_WINDOW);
 130
 131   paned->child1 = NULL;
 132   paned->child2 = NULL;
 133   paned->handle = NULL;
 134   paned->xor_gc = NULL;
 135   paned->cursor_type = GDK_CROSS;
 136
 137   paned->handle_width = 5;
 138   paned->handle_height = 5;
 139   paned->handle_size = 5;
 140   paned->position_set = FALSE;
 141   paned->last_allocation = -1;
 142   paned->in_drag = FALSE;
 143
 144   paned->handle_xpos = -1;
 145   paned->handle_ypos = -1;
 146 }
 147
 148 static void
 149 gtk_paned_set_arg (GtkObject *object,
 150                    GtkArg    *arg,
 151                    guint      arg_id)
 152 {
 153   GtkPaned *paned = GTK_PANED (object);
 154
 155   switch (arg_id)
 156     {
 157     case ARG_HANDLE_SIZE:
 158       gtk_paned_set_handle_size (paned, GTK_VALUE_UINT (*arg));
 159       break;
 160     default:
 161       break;
 162     }
 163 }
 164
 165 static void
 166 gtk_paned_get_arg (GtkObject *object,
 167                    GtkArg    *arg,
 168                    guint      arg_id)
 169 {
 170   GtkPaned *paned = GTK_PANED (object);
 171
 172   switch (arg_id)
 173     {
 174     case ARG_HANDLE_SIZE:
 175       GTK_VALUE_UINT (*arg) = paned->handle_size;
 176       break;
 177     default:
 178       arg->type = GTK_TYPE_INVALID;
 179       break;
 180     }
 181 }
 182
 183 static void
 184 gtk_paned_realize (GtkWidget *widget)
 185 {
 186   GtkPaned *paned;
 187   GdkWindowAttr attributes;
 188   gint attributes_mask;
 189
 190   g_return_if_fail (widget != NULL);
 191   g_return_if_fail (GTK_IS_PANED (widget));
 192
 193   GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
 194   paned = GTK_PANED (widget);
 195
 196   attributes.x = widget->allocation.x;
 197   attributes.y = widget->allocation.y;
 198   attributes.width = widget->allocation.width;
 199   attributes.height = widget->allocation.height;
 200   attributes.window_type = GDK_WINDOW_CHILD;
 201   attributes.wclass = GDK_INPUT_OUTPUT;
 202   attributes.visual = gtk_widget_get_visual (widget);
 203   attributes.colormap = gtk_widget_get_colormap (widget);
 204   attributes.event_mask = gtk_widget_get_events (widget) | GDK_EXPOSURE_MASK;
 205   attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
 206
 207   widget->window = gdk_window_new (gtk_widget_get_parent_window(widget),
 208                                    &attributes, attributes_mask);
 209   gdk_window_set_user_data (widget->window, paned);
 210
 211   attributes.x = paned->handle_xpos;
 212   attributes.y = paned->handle_ypos;
 213   attributes.width = paned->handle_width;
 214   attributes.height = paned->handle_height;
 215   attributes.cursor = gdk_cursor_new (paned->cursor_type);
 216   attributes.event_mask |= (GDK_BUTTON_PRESS_MASK |
 217                             GDK_BUTTON_RELEASE_MASK |
 218                             GDK_POINTER_MOTION_MASK |
 219                             GDK_POINTER_MOTION_HINT_MASK);
 220   attributes_mask |= GDK_WA_CURSOR;
 221
 222   paned->handle = gdk_window_new (widget->window,
 223                                   &attributes, attributes_mask);
 224   gdk_window_set_user_data (paned->handle, paned);
 225   gdk_cursor_destroy (attributes.cursor);
 226
 227   widget->style = gtk_style_attach (widget->style, widget->window);
 228
 229   gtk_style_set_background (widget->style, widget->window, GTK_STATE_NORMAL);
 230   gtk_style_set_background (widget->style, paned->handle, GTK_STATE_NORMAL);
 231
 232   gdk_window_set_back_pixmap (widget->window, NULL, TRUE);
 233
 234   gdk_window_show (paned->handle);
 235 }
 236
 237 static void
 238 gtk_paned_map (GtkWidget *widget)
 239 {
 240   GtkPaned *paned;
 241
 242   g_return_if_fail (widget != NULL);
 243   g_return_if_fail (GTK_IS_PANED (widget));
 244
 245   GTK_WIDGET_SET_FLAGS (widget, GTK_MAPPED);
 246   paned = GTK_PANED (widget);
 247
 248   if (paned->child1 &&
 249       GTK_WIDGET_VISIBLE (paned->child1) &&
 250       !GTK_WIDGET_MAPPED (paned->child1))
 251     gtk_widget_map (paned->child1);
 252   if (paned->child2 &&
 253       GTK_WIDGET_VISIBLE (paned->child2) &&
 254       !GTK_WIDGET_MAPPED (paned->child2))
 255     gtk_widget_map (paned->child2);
 256
 257   gdk_window_show (widget->window);
 258 }
 259
 260 static void
 261 gtk_paned_unmap (GtkWidget *widget)
 262 {
 263   g_return_if_fail (widget != NULL);
 264   g_return_if_fail (GTK_IS_PANED (widget));
 265
 266   GTK_WIDGET_UNSET_FLAGS (widget, GTK_MAPPED);
 267
 268   gdk_window_hide (widget->window);
 269 }
 270
 271 static void
 272 gtk_paned_unrealize (GtkWidget *widget)
 273 {
 274   GtkPaned *paned;
 275
 276   g_return_if_fail (widget != NULL);
 277   g_return_if_fail (GTK_IS_PANED (widget));
 278
 279   paned = GTK_PANED (widget);
 280
 281   if (paned->xor_gc)
 282     {
 283       gdk_gc_destroy (paned->xor_gc);
 284       paned->xor_gc = NULL;
 285     }
 286
 287   if (paned->handle)
 288     {
 289       gdk_window_set_user_data (paned->handle, NULL);
 290       gdk_window_destroy (paned->handle);
 291       paned->handle = NULL;
 292     }
 293
 294   if (GTK_WIDGET_CLASS (parent_class)->unrealize)
 295     (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
 296 }
 297
 298 static gint
 299 gtk_paned_expose (GtkWidget      *widget,
 300                   GdkEventExpose *event)
 301 {
 302   GtkPaned *paned;
 303   GdkEventExpose child_event;
 304
 305   g_return_val_if_fail (widget != NULL, FALSE);
 306   g_return_val_if_fail (GTK_IS_PANED (widget), FALSE);
 307   g_return_val_if_fail (event != NULL, FALSE);
 308
 309   if (GTK_WIDGET_DRAWABLE (widget))
 310     {
 311       paned = GTK_PANED (widget);
 312
 313       if (event->window == paned->handle)
 314         {
 315           child_event = *event;
 316           event->area.x += paned->handle_xpos;
 317           event->area.y += paned->handle_ypos;
 318           gtk_widget_draw (widget, &event->area);
 319         }
 320       else
 321         {
 322           child_event = *event;
 323           if (paned->child1 &&
 324               GTK_WIDGET_NO_WINDOW (paned->child1) &&
 325               gtk_widget_intersect (paned->child1, &event->area, &child_event.area))
 326             gtk_widget_event (paned->child1, (GdkEvent *) &child_event);
 327
 328           if (paned->child2 &&
 329               GTK_WIDGET_NO_WINDOW (paned->child2) &&
 330               gtk_widget_intersect (paned->child2, &event->area, &child_event.area))
 331             gtk_widget_event (paned->child2, (GdkEvent *) &child_event);
 332         }
 333     }
 334
 335   return FALSE;
 336 }
 337
 338 void
 339 gtk_paned_add1 (GtkPaned  *paned,
 340                 GtkWidget *widget)
 341 {
 342   gtk_paned_pack1 (paned, widget, FALSE, TRUE);
 343 }
 344
 345 void
 346 gtk_paned_add2 (GtkPaned  *paned,
 347                 GtkWidget *widget)
 348 {
 349   gtk_paned_pack2 (paned, widget, TRUE, TRUE);
 350 }
 351
 352 void
 353 gtk_paned_pack1 (GtkPaned  *paned,
 354                  GtkWidget *child,
 355                  gboolean   resize,
 356                  gboolean   shrink)
 357 {
 358   g_return_if_fail (paned != NULL);
 359   g_return_if_fail (GTK_IS_PANED (paned));
 360   g_return_if_fail (GTK_IS_WIDGET (child));
 361
 362   if (!paned->child1)
 363     {
 364       paned->child1 = child;
 365       paned->child1_resize = resize;
 366       paned->child1_shrink = shrink;
 367
 368       gtk_widget_set_parent (child, GTK_WIDGET (paned));
 369
 370       if (GTK_WIDGET_REALIZED (child->parent))
 371         gtk_widget_realize (child);
 372
 373       if (GTK_WIDGET_VISIBLE (child->parent) && GTK_WIDGET_VISIBLE (child))
 374         {
 375           if (GTK_WIDGET_MAPPED (child->parent))
 376             gtk_widget_map (child);
 377
 378           gtk_widget_queue_resize (child);
 379         }
 380     }
 381 }
 382
 383 void
 384 gtk_paned_pack2 (GtkPaned  *paned,
 385                  GtkWidget *child,
 386                  gboolean   resize,
 387                  gboolean   shrink)
 388 {
 389   g_return_if_fail (paned != NULL);
 390   g_return_if_fail (GTK_IS_PANED (paned));
 391   g_return_if_fail (GTK_IS_WIDGET (child));
 392
 393   if (!paned->child2)
 394     {
 395       paned->child2 = child;
 396       paned->child2_resize = resize;
 397       paned->child2_shrink = shrink;
 398
 399       gtk_widget_set_parent (child, GTK_WIDGET (paned));
 400
 401       if (GTK_WIDGET_REALIZED (child->parent))
 402         gtk_widget_realize (child);
 403
 404       if (GTK_WIDGET_VISIBLE (child->parent) && GTK_WIDGET_VISIBLE (child))
 405         {
 406           if (GTK_WIDGET_MAPPED (child->parent))
 407             gtk_widget_map (child);
 408
 409           gtk_widget_queue_resize (child);
 410         }
 411     }
 412 }
 413
 414
 415 static void
 416 gtk_paned_add (GtkContainer *container,
 417                GtkWidget    *widget)
 418 {
 419   GtkPaned *paned;
 420
 421   g_return_if_fail (container != NULL);
 422   g_return_if_fail (GTK_IS_PANED (container));
 423   g_return_if_fail (widget != NULL);
 424
 425   paned = GTK_PANED (container);
 426
 427   if (!paned->child1)
 428     gtk_paned_add1 (GTK_PANED (container), widget);
 429   else if (!paned->child2)
 430     gtk_paned_add2 (GTK_PANED (container), widget);
 431 }
 432
 433 static void
 434 gtk_paned_remove (GtkContainer *container,
 435                   GtkWidget    *widget)
 436 {
 437   GtkPaned *paned;
 438   gboolean was_visible;
 439
 440   g_return_if_fail (container != NULL);
 441   g_return_if_fail (GTK_IS_PANED (container));
 442   g_return_if_fail (widget != NULL);
 443
 444   paned = GTK_PANED (container);
 445   was_visible = GTK_WIDGET_VISIBLE (widget);
 446
 447   if (paned->child1 == widget)
 448     {
 449       gtk_widget_unparent (widget);
 450
 451       paned->child1 = NULL;
 452
 453       if (was_visible && GTK_WIDGET_VISIBLE (container))
 454         gtk_widget_queue_resize (GTK_WIDGET (container));
 455     }
 456   else if (paned->child2 == widget)
 457     {
 458       gtk_widget_unparent (widget);
 459
 460       paned->child2 = NULL;
 461
 462       if (was_visible && GTK_WIDGET_VISIBLE (container))
 463         gtk_widget_queue_resize (GTK_WIDGET (container));
 464     }
 465 }
 466
 467 static void
 468 gtk_paned_forall (GtkContainer *container,
 469                   gboolean      include_internals,
 470                   GtkCallback   callback,
 471                   gpointer      callback_data)
 472 {
 473   GtkPaned *paned;
 474
 475   g_return_if_fail (container != NULL);
 476   g_return_if_fail (GTK_IS_PANED (container));
 477   g_return_if_fail (callback != NULL);
 478
 479   paned = GTK_PANED (container);
 480
 481   if (paned->child1)
 482     (*callback) (paned->child1, callback_data);
 483   if (paned->child2)
 484     (*callback) (paned->child2, callback_data);
 485 }
 486
 487 void
 488 gtk_paned_set_position (GtkPaned *paned,
 489                         gint      position)
 490 {
 491   g_return_if_fail (paned != NULL);
 492   g_return_if_fail (GTK_IS_PANED (paned));
 493
 494   if (position >= 0)
 495     {
 496       /* We don't clamp here - the assumption is that
 497        * if the total allocation changes at the same time
 498        * as the position, the position set is with reference
 499        * to the new total size. If only the position changes,
 500        * then clamping will occur in gtk_paned_compute_position()
 501        */
 502       paned->child1_size = position;
 503       paned->position_set = TRUE;
 504     }
 505   else
 506     {
 507       paned->position_set = FALSE;
 508     }
 509
 510   gtk_widget_queue_resize (GTK_WIDGET (paned));
 511 }
 512
 513 void
 514 gtk_paned_set_handle_size (GtkPaned *paned,
 515                            guint16   size)
 516 {
 517   g_return_if_fail (paned != NULL);
 518   g_return_if_fail (GTK_IS_PANED (paned));
 519
 520   gtk_widget_queue_resize (GTK_WIDGET (paned));
 521
 522   paned->handle_size = size;
 523 }
 524
 525 void
 526 gtk_paned_compute_position(GtkPaned *paned,
 527                            gint      allocation,
 528                            gint      child1_req,
 529                            gint      child2_req)
 530 {
 531   g_return_if_fail (paned != NULL);
 532   g_return_if_fail (GTK_IS_PANED (paned));
 533
 534   paned->min_position = paned->child1_shrink ? 0 : child1_req;
 535
 536   paned->max_position = allocation;
 537   if (!paned->child2_shrink)
 538     paned->max_position -= child2_req;
 539
 540   if (!paned->position_set)
 541     {
 542       if (paned->child1_resize && !paned->child2_resize)
 543         paned->child1_size = allocation - child2_req;
 544       else if (!paned->child1_resize && paned->child2_resize)
 545         paned->child1_size = child1_req;
 546       else
 547         paned->child1_size = allocation * ((gdouble) child1_req /
 548                                            (child1_req + child2_req));
 549     }
 550   else
 551     {
 552       /* If the position was set before the initial allocation.
 553        * (paned->last_allocation < 0) just clamp it and leave it.
 554        */
 555       if (paned->last_allocation >= 0)
 556         {
 557           if (paned->child1_resize && !paned->child2_resize)
 558             paned->child1_size += allocation - paned->last_allocation;
 559           else if (!(!paned->child1_resize && paned->child2_resize))
 560             paned->child1_size = allocation * ((gdouble) paned->child1_size / (paned->last_allocation));
 561         }
 562     }
 563
 564   paned->child1_size = CLAMP (paned->child1_size,
 565                               paned->min_position,
 566                               paned->max_position);
 567
 568   paned->last_allocation = allocation;
 569 }