1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
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.
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.
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.
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/.
27 #include "gtkalignment.h"
42 static void gtk_alignment_class_init (GtkAlignmentClass *klass);
43 static void gtk_alignment_init (GtkAlignment *alignment);
44 static void gtk_alignment_size_request (GtkWidget *widget,
45 GtkRequisition *requisition);
46 static void gtk_alignment_size_allocate (GtkWidget *widget,
47 GtkAllocation *allocation);
48 static void gtk_alignment_set_property (GObject *object,
52 static void gtk_alignment_get_property (GObject *object,
58 gtk_alignment_get_type (void)
60 static GtkType alignment_type = 0;
64 static const GtkTypeInfo alignment_info =
67 sizeof (GtkAlignment),
68 sizeof (GtkAlignmentClass),
69 (GtkClassInitFunc) gtk_alignment_class_init,
70 (GtkObjectInitFunc) gtk_alignment_init,
71 /* reserved_1 */ NULL,
72 /* reserved_2 */ NULL,
73 (GtkClassInitFunc) NULL,
76 alignment_type = gtk_type_unique (GTK_TYPE_BIN, &alignment_info);
79 return alignment_type;
83 gtk_alignment_class_init (GtkAlignmentClass *class)
85 GObjectClass *gobject_class;
86 GtkObjectClass *object_class;
87 GtkWidgetClass *widget_class;
89 gobject_class = (GObjectClass*) class;
90 object_class = (GtkObjectClass*) class;
91 widget_class = (GtkWidgetClass*) class;
93 gobject_class->set_property = gtk_alignment_set_property;
94 gobject_class->get_property = gtk_alignment_get_property;
96 widget_class->size_request = gtk_alignment_size_request;
97 widget_class->size_allocate = gtk_alignment_size_allocate;
99 g_object_class_install_property (gobject_class,
101 g_param_spec_float("xalign",
102 _("Horizontal alignment"),
103 _("Horizontal position of child in available space. 0.0 is left aligned, 1.0 is right aligned"),
107 G_PARAM_READABLE | G_PARAM_WRITABLE));
109 g_object_class_install_property (gobject_class,
111 g_param_spec_float("yalign",
112 _("Vertical alignment"),
113 _("Vertical position of child in available space. 0.0 is top aligned, 1.0 is bottom aligned"),
117 G_PARAM_READABLE | G_PARAM_WRITABLE));
118 g_object_class_install_property (gobject_class,
120 g_param_spec_float("xscale",
121 _("Horizontal scale"),
122 _("If available horizontal space is bigger than needed for the child, how much of it to use for the child. 0.0 means none, 1.0 means all"),
126 G_PARAM_READABLE | G_PARAM_WRITABLE));
127 g_object_class_install_property (gobject_class,
129 g_param_spec_float("yscale",
131 _("If available vertical space is bigger than needed for the child, how much of it to use for the child. 0.0 means none, 1.0 means all"),
135 G_PARAM_READABLE | G_PARAM_WRITABLE));
139 gtk_alignment_init (GtkAlignment *alignment)
141 GTK_WIDGET_SET_FLAGS (alignment, GTK_NO_WINDOW);
143 alignment->xalign = 0.5;
144 alignment->yalign = 0.5;
145 alignment->xscale = 1.0;
146 alignment->yscale = 1.0;
150 gtk_alignment_new (gfloat xalign,
155 GtkAlignment *alignment;
157 alignment = gtk_type_new (gtk_alignment_get_type ());
159 alignment->xalign = CLAMP (xalign, 0.0, 1.0);
160 alignment->yalign = CLAMP (yalign, 0.0, 1.0);
161 alignment->xscale = CLAMP (xscale, 0.0, 1.0);
162 alignment->yscale = CLAMP (yscale, 0.0, 1.0);
164 return GTK_WIDGET (alignment);
168 gtk_alignment_set_property (GObject *object,
173 GtkAlignment *alignment;
175 alignment = GTK_ALIGNMENT (object);
180 gtk_alignment_set (alignment,
181 g_value_get_float (value),
187 gtk_alignment_set (alignment,
189 g_value_get_float (value),
194 gtk_alignment_set (alignment,
197 g_value_get_float (value),
201 gtk_alignment_set (alignment,
205 g_value_get_float (value));
208 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
214 gtk_alignment_get_property (GObject *object,
219 GtkAlignment *alignment;
221 alignment = GTK_ALIGNMENT (object);
226 g_value_set_float(value, alignment->xalign);
229 g_value_set_float(value, alignment->yalign);
232 g_value_set_float(value, alignment->xscale);
235 g_value_set_float(value, alignment->yscale);
238 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
244 gtk_alignment_set (GtkAlignment *alignment,
250 g_return_if_fail (GTK_IS_ALIGNMENT (alignment));
252 xalign = CLAMP (xalign, 0.0, 1.0);
253 yalign = CLAMP (yalign, 0.0, 1.0);
254 xscale = CLAMP (xscale, 0.0, 1.0);
255 yscale = CLAMP (yscale, 0.0, 1.0);
257 if ( (alignment->xalign != xalign)
258 || (alignment->yalign != yalign)
259 || (alignment->xscale != xscale)
260 || (alignment->yscale != yscale))
262 g_object_freeze_notify (G_OBJECT (alignment));
263 if (alignment->xalign != xalign)
265 alignment->xalign = xalign;
266 g_object_notify (G_OBJECT(alignment), "xalign");
268 if (alignment->yalign != yalign)
270 alignment->yalign = yalign;
271 g_object_notify (G_OBJECT(alignment), "yalign");
273 if (alignment->xscale != xscale)
275 alignment->xscale = xscale;
276 g_object_notify (G_OBJECT(alignment), "xscale");
278 if (alignment->yscale != yscale)
280 alignment->yscale = yscale;
281 g_object_notify (G_OBJECT(alignment), "yscale");
283 g_object_thaw_notify (G_OBJECT (alignment));
285 if (GTK_BIN (alignment)->child)
286 gtk_widget_queue_resize (GTK_BIN (alignment)->child);
287 gtk_widget_queue_draw (GTK_WIDGET (alignment));
293 gtk_alignment_size_request (GtkWidget *widget,
294 GtkRequisition *requisition)
296 GtkAlignment *alignment;
299 g_return_if_fail (GTK_IS_ALIGNMENT (widget));
300 g_return_if_fail (requisition != NULL);
302 alignment = GTK_ALIGNMENT (widget);
303 bin = GTK_BIN (widget);
305 requisition->width = GTK_CONTAINER (widget)->border_width * 2;
306 requisition->height = GTK_CONTAINER (widget)->border_width * 2;
308 if (bin->child && GTK_WIDGET_VISIBLE (bin->child))
310 GtkRequisition child_requisition;
312 gtk_widget_size_request (bin->child, &child_requisition);
314 requisition->width += child_requisition.width;
315 requisition->height += child_requisition.height;
320 gtk_alignment_size_allocate (GtkWidget *widget,
321 GtkAllocation *allocation)
323 GtkAlignment *alignment;
325 GtkAllocation child_allocation;
326 GtkRequisition child_requisition;
330 g_return_if_fail (GTK_IS_ALIGNMENT (widget));
331 g_return_if_fail (allocation != NULL);
333 widget->allocation = *allocation;
334 alignment = GTK_ALIGNMENT (widget);
335 bin = GTK_BIN (widget);
337 if (bin->child && GTK_WIDGET_VISIBLE (bin->child))
339 gtk_widget_get_child_requisition (bin->child, &child_requisition);
341 x = GTK_CONTAINER (alignment)->border_width;
342 y = GTK_CONTAINER (alignment)->border_width;
343 width = MAX (allocation->width - 2 * x, 0);
344 height = MAX (allocation->height - 2 * y, 0);
346 if (width > child_requisition.width)
347 child_allocation.width = (child_requisition.width *
348 (1.0 - alignment->xscale) +
349 width * alignment->xscale);
351 child_allocation.width = width;
353 if (height > child_requisition.height)
354 child_allocation.height = (child_requisition.height *
355 (1.0 - alignment->yscale) +
356 height * alignment->yscale);
358 child_allocation.height = height;
360 child_allocation.x = alignment->xalign * (width - child_allocation.width) + allocation->x + x;
361 child_allocation.y = alignment->yalign * (height - child_allocation.height) + allocation->y + y;
363 gtk_widget_size_allocate (bin->child, &child_allocation);