]> Pileus Git - ~andy/gtk/blob - gtk/gtkfixed.c
Fix a typo, spotted by David Odin.
[~andy/gtk] / gtk / gtkfixed.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 Lesser 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  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser 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 <config.h>
28 #include "gtkfixed.h"
29 #include "gtkprivate.h"
30 #include "gtkintl.h"
31 #include "gtkalias.h"
32
33 enum {
34   CHILD_PROP_0,
35   CHILD_PROP_X,
36   CHILD_PROP_Y
37 };
38
39 static void gtk_fixed_class_init    (GtkFixedClass    *klass);
40 static void gtk_fixed_init          (GtkFixed         *fixed);
41 static void gtk_fixed_realize       (GtkWidget        *widget);
42 static void gtk_fixed_size_request  (GtkWidget        *widget,
43                                      GtkRequisition   *requisition);
44 static void gtk_fixed_size_allocate (GtkWidget        *widget,
45                                      GtkAllocation    *allocation);
46 static void gtk_fixed_add           (GtkContainer     *container,
47                                      GtkWidget        *widget);
48 static void gtk_fixed_remove        (GtkContainer     *container,
49                                      GtkWidget        *widget);
50 static void gtk_fixed_forall        (GtkContainer     *container,
51                                      gboolean          include_internals,
52                                      GtkCallback       callback,
53                                      gpointer          callback_data);
54 static GType gtk_fixed_child_type   (GtkContainer     *container);
55
56 static void gtk_fixed_set_child_property (GtkContainer *container,
57                                           GtkWidget    *child,
58                                           guint         property_id,
59                                           const GValue *value,
60                                           GParamSpec   *pspec);
61 static void gtk_fixed_get_child_property (GtkContainer *container,
62                                           GtkWidget    *child,
63                                           guint         property_id,
64                                           GValue       *value,
65                                           GParamSpec   *pspec);
66
67 static GtkContainerClass *parent_class = NULL;
68
69
70 GType
71 gtk_fixed_get_type (void)
72 {
73   static GType fixed_type = 0;
74
75   if (!fixed_type)
76     {
77       static const GTypeInfo fixed_info =
78       {
79         sizeof (GtkFixedClass),
80         NULL,           /* base_init */
81         NULL,           /* base_finalize */
82         (GClassInitFunc) gtk_fixed_class_init,
83         NULL,           /* class_finalize */
84         NULL,           /* class_data */
85         sizeof (GtkFixed),
86         0,              /* n_preallocs */
87         (GInstanceInitFunc) gtk_fixed_init,
88       };
89
90       fixed_type = g_type_register_static (GTK_TYPE_CONTAINER, "GtkFixed",
91                                            &fixed_info, 0);
92     }
93
94   return fixed_type;
95 }
96
97 static void
98 gtk_fixed_class_init (GtkFixedClass *class)
99 {
100   GtkWidgetClass *widget_class;
101   GtkContainerClass *container_class;
102
103   widget_class = (GtkWidgetClass*) class;
104   container_class = (GtkContainerClass*) class;
105
106   parent_class = g_type_class_peek_parent (class);
107
108   widget_class->realize = gtk_fixed_realize;
109   widget_class->size_request = gtk_fixed_size_request;
110   widget_class->size_allocate = gtk_fixed_size_allocate;
111
112   container_class->add = gtk_fixed_add;
113   container_class->remove = gtk_fixed_remove;
114   container_class->forall = gtk_fixed_forall;
115   container_class->child_type = gtk_fixed_child_type;
116
117   container_class->set_child_property = gtk_fixed_set_child_property;
118   container_class->get_child_property = gtk_fixed_get_child_property;
119
120   gtk_container_class_install_child_property (container_class,
121                                               CHILD_PROP_X,
122                                               g_param_spec_int ("x",
123                                                                 P_("X position"),
124                                                                 P_("X position of child widget"),
125                                                                 G_MININT,
126                                                                 G_MAXINT,
127                                                                 0,
128                                                                 GTK_PARAM_READWRITE));
129
130   gtk_container_class_install_child_property (container_class,
131                                               CHILD_PROP_Y,
132                                               g_param_spec_int ("y",
133                                                                 P_("Y position"),
134                                                                 P_("Y position of child widget"),
135                                                                 G_MININT,
136                                                                 G_MAXINT,
137                                                                 0,
138                                                                 GTK_PARAM_READWRITE));
139 }
140
141 static GType
142 gtk_fixed_child_type (GtkContainer     *container)
143 {
144   return GTK_TYPE_WIDGET;
145 }
146
147 static void
148 gtk_fixed_init (GtkFixed *fixed)
149 {
150   GTK_WIDGET_SET_FLAGS (fixed, GTK_NO_WINDOW);
151  
152   fixed->children = NULL;
153 }
154
155 GtkWidget*
156 gtk_fixed_new (void)
157 {
158   return g_object_new (GTK_TYPE_FIXED, NULL);
159 }
160
161 static GtkFixedChild*
162 get_child (GtkFixed  *fixed,
163            GtkWidget *widget)
164 {
165   GList *children;
166   
167   children = fixed->children;
168   while (children)
169     {
170       GtkFixedChild *child;
171       
172       child = children->data;
173       children = children->next;
174
175       if (child->widget == widget)
176         return child;
177     }
178
179   return NULL;
180 }
181
182 void
183 gtk_fixed_put (GtkFixed       *fixed,
184                GtkWidget      *widget,
185                gint            x,
186                gint            y)
187 {
188   GtkFixedChild *child_info;
189
190   g_return_if_fail (GTK_IS_FIXED (fixed));
191   g_return_if_fail (GTK_IS_WIDGET (widget));
192
193   child_info = g_new (GtkFixedChild, 1);
194   child_info->widget = widget;
195   child_info->x = x;
196   child_info->y = y;
197
198   gtk_widget_set_parent (widget, GTK_WIDGET (fixed));
199
200   fixed->children = g_list_append (fixed->children, child_info);
201 }
202
203 static void
204 gtk_fixed_move_internal (GtkFixed       *fixed,
205                          GtkWidget      *widget,
206                          gboolean        change_x,
207                          gint            x,
208                          gboolean        change_y,
209                          gint            y)
210 {
211   GtkFixedChild *child;
212   
213   g_return_if_fail (GTK_IS_FIXED (fixed));
214   g_return_if_fail (GTK_IS_WIDGET (widget));
215   g_return_if_fail (widget->parent == GTK_WIDGET (fixed));  
216   
217   child = get_child (fixed, widget);
218
219   g_assert (child);
220
221   gtk_widget_freeze_child_notify (widget);
222   
223   if (change_x)
224     {
225       child->x = x;
226       gtk_widget_child_notify (widget, "x");
227     }
228
229   if (change_y)
230     {
231       child->y = y;
232       gtk_widget_child_notify (widget, "y");
233     }
234
235   gtk_widget_thaw_child_notify (widget);
236   
237   if (GTK_WIDGET_VISIBLE (widget) && GTK_WIDGET_VISIBLE (fixed))
238     gtk_widget_queue_resize (GTK_WIDGET (fixed));
239 }
240
241 void
242 gtk_fixed_move (GtkFixed       *fixed,
243                 GtkWidget      *widget,
244                 gint            x,
245                 gint            y)
246 {
247   gtk_fixed_move_internal (fixed, widget, TRUE, x, TRUE, y);
248 }
249
250 static void
251 gtk_fixed_set_child_property (GtkContainer    *container,
252                               GtkWidget       *child,
253                               guint            property_id,
254                               const GValue    *value,
255                               GParamSpec      *pspec)
256 {
257   switch (property_id)
258     {
259     case CHILD_PROP_X:
260       gtk_fixed_move_internal (GTK_FIXED (container),
261                                child,
262                                TRUE, g_value_get_int (value),
263                                FALSE, 0);
264       break;
265     case CHILD_PROP_Y:
266       gtk_fixed_move_internal (GTK_FIXED (container),
267                                child,
268                                FALSE, 0,
269                                TRUE, g_value_get_int (value));
270       break;
271     default:
272       GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
273       break;
274     }
275 }
276
277 static void
278 gtk_fixed_get_child_property (GtkContainer *container,
279                               GtkWidget    *child,
280                               guint         property_id,
281                               GValue       *value,
282                               GParamSpec   *pspec)
283 {
284   GtkFixedChild *fixed_child;
285
286   fixed_child = get_child (GTK_FIXED (container), child);
287   
288   switch (property_id)
289     {
290     case CHILD_PROP_X:
291       g_value_set_int (value, fixed_child->x);
292       break;
293     case CHILD_PROP_Y:
294       g_value_set_int (value, fixed_child->y);
295       break;
296     default:
297       GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
298       break;
299     }
300 }
301
302 static void
303 gtk_fixed_realize (GtkWidget *widget)
304 {
305   GdkWindowAttr attributes;
306   gint attributes_mask;
307
308   if (GTK_WIDGET_NO_WINDOW (widget))
309     GTK_WIDGET_CLASS (parent_class)->realize (widget);
310   else
311     {
312       GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
313
314       attributes.window_type = GDK_WINDOW_CHILD;
315       attributes.x = widget->allocation.x;
316       attributes.y = widget->allocation.y;
317       attributes.width = widget->allocation.width;
318       attributes.height = widget->allocation.height;
319       attributes.wclass = GDK_INPUT_OUTPUT;
320       attributes.visual = gtk_widget_get_visual (widget);
321       attributes.colormap = gtk_widget_get_colormap (widget);
322       attributes.event_mask = gtk_widget_get_events (widget);
323       attributes.event_mask |= GDK_EXPOSURE_MASK | GDK_BUTTON_PRESS_MASK;
324       
325       attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
326       
327       widget->window = gdk_window_new (gtk_widget_get_parent_window (widget), &attributes, 
328                                        attributes_mask);
329       gdk_window_set_user_data (widget->window, widget);
330       
331       widget->style = gtk_style_attach (widget->style, widget->window);
332       gtk_style_set_background (widget->style, widget->window, GTK_STATE_NORMAL);
333     }
334 }
335
336 static void
337 gtk_fixed_size_request (GtkWidget      *widget,
338                         GtkRequisition *requisition)
339 {
340   GtkFixed *fixed;  
341   GtkFixedChild *child;
342   GList *children;
343   GtkRequisition child_requisition;
344
345   fixed = GTK_FIXED (widget);
346   requisition->width = 0;
347   requisition->height = 0;
348
349   children = fixed->children;
350   while (children)
351     {
352       child = children->data;
353       children = children->next;
354
355       if (GTK_WIDGET_VISIBLE (child->widget))
356         {
357           gtk_widget_size_request (child->widget, &child_requisition);
358
359           requisition->height = MAX (requisition->height,
360                                      child->y +
361                                      child_requisition.height);
362           requisition->width = MAX (requisition->width,
363                                     child->x +
364                                     child_requisition.width);
365         }
366     }
367
368   requisition->height += GTK_CONTAINER (fixed)->border_width * 2;
369   requisition->width += GTK_CONTAINER (fixed)->border_width * 2;
370 }
371
372 static void
373 gtk_fixed_size_allocate (GtkWidget     *widget,
374                          GtkAllocation *allocation)
375 {
376   GtkFixed *fixed;
377   GtkFixedChild *child;
378   GtkAllocation child_allocation;
379   GtkRequisition child_requisition;
380   GList *children;
381   guint16 border_width;
382
383   fixed = GTK_FIXED (widget);
384
385   widget->allocation = *allocation;
386
387   if (!GTK_WIDGET_NO_WINDOW (widget))
388     {
389       if (GTK_WIDGET_REALIZED (widget))
390         gdk_window_move_resize (widget->window,
391                                 allocation->x, 
392                                 allocation->y,
393                                 allocation->width, 
394                                 allocation->height);
395     }
396       
397   border_width = GTK_CONTAINER (fixed)->border_width;
398   
399   children = fixed->children;
400   while (children)
401     {
402       child = children->data;
403       children = children->next;
404       
405       if (GTK_WIDGET_VISIBLE (child->widget))
406         {
407           gtk_widget_get_child_requisition (child->widget, &child_requisition);
408           child_allocation.x = child->x + border_width;
409           child_allocation.y = child->y + border_width;
410
411           if (GTK_WIDGET_NO_WINDOW (widget))
412             {
413               child_allocation.x += widget->allocation.x;
414               child_allocation.y += widget->allocation.y;
415             }
416           
417           child_allocation.width = child_requisition.width;
418           child_allocation.height = child_requisition.height;
419           gtk_widget_size_allocate (child->widget, &child_allocation);
420         }
421     }
422 }
423
424 static void
425 gtk_fixed_add (GtkContainer *container,
426                GtkWidget    *widget)
427 {
428   gtk_fixed_put (GTK_FIXED (container), widget, 0, 0);
429 }
430
431 static void
432 gtk_fixed_remove (GtkContainer *container,
433                   GtkWidget    *widget)
434 {
435   GtkFixed *fixed;
436   GtkFixedChild *child;
437   GList *children;
438
439   fixed = GTK_FIXED (container);
440
441   children = fixed->children;
442   while (children)
443     {
444       child = children->data;
445
446       if (child->widget == widget)
447         {
448           gboolean was_visible = GTK_WIDGET_VISIBLE (widget);
449           
450           gtk_widget_unparent (widget);
451
452           fixed->children = g_list_remove_link (fixed->children, children);
453           g_list_free (children);
454           g_free (child);
455
456           if (was_visible && GTK_WIDGET_VISIBLE (container))
457             gtk_widget_queue_resize (GTK_WIDGET (container));
458
459           break;
460         }
461
462       children = children->next;
463     }
464 }
465
466 static void
467 gtk_fixed_forall (GtkContainer *container,
468                   gboolean      include_internals,
469                   GtkCallback   callback,
470                   gpointer      callback_data)
471 {
472   GtkFixed *fixed;
473   GtkFixedChild *child;
474   GList *children;
475
476   g_return_if_fail (callback != NULL);
477
478   fixed = GTK_FIXED (container);
479
480   children = fixed->children;
481   while (children)
482     {
483       child = children->data;
484       children = children->next;
485
486       (* callback) (child->widget, callback_data);
487     }
488 }
489
490 /**
491  * gtk_fixed_set_has_window:
492  * @fixed: a #GtkFixed
493  * @has_window: %TRUE if a separate window should be created
494  * 
495  * Sets whether a #GtkFixed widget is created with a separate
496  * #GdkWindow for @widget->window or not. (By default, it will be
497  * created with no separate #GdkWindow). This function must be called
498  * while the #GtkFixed is not realized, for instance, immediately after the
499  * window is created.
500  * 
501  * This function was added to provide an easy migration path for
502  * older applications which may expect #GtkFixed to have a separate window.
503  **/
504 void
505 gtk_fixed_set_has_window (GtkFixed *fixed,
506                           gboolean  has_window)
507 {
508   g_return_if_fail (GTK_IS_FIXED (fixed));
509   g_return_if_fail (!GTK_WIDGET_REALIZED (fixed));
510
511   if (!has_window != GTK_WIDGET_NO_WINDOW (fixed))
512     {
513       if (has_window)
514         GTK_WIDGET_UNSET_FLAGS (fixed, GTK_NO_WINDOW);
515       else
516         GTK_WIDGET_SET_FLAGS (fixed, GTK_NO_WINDOW);
517     }
518 }
519
520 /**
521  * gtk_fixed_get_has_window:
522  * @fixed: a #GtkWidget
523  * 
524  * Gets whether the #GtkFixed has its own #GdkWindow.
525  * See gdk_fixed_set_has_window().
526  * 
527  * Return value: %TRUE if @fixed has its own window.
528  **/
529 gboolean
530 gtk_fixed_get_has_window (GtkFixed *fixed)
531 {
532   g_return_val_if_fail (GTK_IS_FIXED (fixed), FALSE);
533
534   return !GTK_WIDGET_NO_WINDOW (fixed);
535 }
536
537 #define __GTK_FIXED_C__
538 #include "gtkaliasdef.c"