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