/* GTK - The GIMP Toolkit * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ /* * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS * file for a list of people on the GTK+ Team. See the ChangeLog * files for a list of changes. These files are distributed with * GTK+ at ftp://ftp.gtk.org/pub/gtk/. */ #include "gtkalignment.h" #include "gtkintl.h" enum { PROP_0, PROP_XALIGN, PROP_YALIGN, PROP_XSCALE, PROP_YSCALE, PROP_PADDING_TOP, PROP_PADDING_BOTTOM, PROP_PADDING_LEFT, PROP_PADDING_RIGHT, PROP_LAST }; #define GTK_ALIGNMENT_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_ALIGNMENT, GtkAlignmentPrivate)) struct _GtkAlignmentPrivate { guint padding_top; guint padding_bottom; guint padding_left; guint padding_right; }; static void gtk_alignment_class_init (GtkAlignmentClass *klass); static void gtk_alignment_init (GtkAlignment *alignment); static void gtk_alignment_size_request (GtkWidget *widget, GtkRequisition *requisition); static void gtk_alignment_size_allocate (GtkWidget *widget, GtkAllocation *allocation); static void gtk_alignment_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec); static void gtk_alignment_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec); GType gtk_alignment_get_type (void) { static GType alignment_type = 0; if (!alignment_type) { static const GTypeInfo alignment_info = { sizeof (GtkAlignmentClass), NULL, /* base_init */ NULL, /* base_finalize */ (GClassInitFunc) gtk_alignment_class_init, NULL, /* class_finalize */ NULL, /* class_data */ sizeof (GtkAlignment), 0, /* n_preallocs */ (GInstanceInitFunc) gtk_alignment_init, }; alignment_type = g_type_register_static (GTK_TYPE_BIN, "GtkAlignment", &alignment_info, 0); } return alignment_type; } static void gtk_alignment_class_init (GtkAlignmentClass *class) { GObjectClass *gobject_class; GtkWidgetClass *widget_class; gobject_class = (GObjectClass*) class; widget_class = (GtkWidgetClass*) class; gobject_class->set_property = gtk_alignment_set_property; gobject_class->get_property = gtk_alignment_get_property; widget_class->size_request = gtk_alignment_size_request; widget_class->size_allocate = gtk_alignment_size_allocate; g_object_class_install_property (gobject_class, PROP_XALIGN, g_param_spec_float("xalign", _("Horizontal alignment"), _("Horizontal position of child in available space. 0.0 is left aligned, 1.0 is right aligned"), 0.0, 1.0, 0.5, G_PARAM_READABLE | G_PARAM_WRITABLE)); g_object_class_install_property (gobject_class, PROP_YALIGN, g_param_spec_float("yalign", _("Vertical alignment"), _("Vertical position of child in available space. 0.0 is top aligned, 1.0 is bottom aligned"), 0.0, 1.0, 0.5, G_PARAM_READABLE | G_PARAM_WRITABLE)); g_object_class_install_property (gobject_class, PROP_XSCALE, g_param_spec_float("xscale", _("Horizontal scale"), _("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"), 0.0, 1.0, 1.0, G_PARAM_READABLE | G_PARAM_WRITABLE)); g_object_class_install_property (gobject_class, PROP_YSCALE, g_param_spec_float("yscale", _("Vertical scale"), _("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"), 0.0, 1.0, 1.0, G_PARAM_READABLE | G_PARAM_WRITABLE)); /** * GtkAlignment:top-padding: * * The padding to insert at the top of the widget. * * Since: 2.4 */ g_object_class_install_property (gobject_class, PROP_PADDING_TOP, g_param_spec_uint("top_padding", _("Top Padding"), _("The padding to insert at the top of the widget."), 0, G_MAXINT, 0, G_PARAM_READABLE | G_PARAM_WRITABLE)); /** * GtkAlignment:top-padding: * * The padding to insert at the bottom of the widget. * * Since: 2.4 */ g_object_class_install_property (gobject_class, PROP_PADDING_BOTTOM, g_param_spec_uint("bottom_padding", _("Bottom Padding"), _("The padding to insert at the bottom of the widget."), 0, G_MAXINT, 0, G_PARAM_READABLE | G_PARAM_WRITABLE)); /** * GtkAlignment:top-padding: * * The padding to insert at the left of the widget. * * Since: 2.4 */ g_object_class_install_property (gobject_class, PROP_PADDING_LEFT, g_param_spec_uint("left_padding", _("Left Padding"), _("The padding to insert at the left of the widget."), 0, G_MAXINT, 0, G_PARAM_READABLE | G_PARAM_WRITABLE)); /** * GtkAlignment:top-padding: * * The padding to insert at the right of the widget. * * Since: 2.4 */ g_object_class_install_property (gobject_class, PROP_PADDING_RIGHT, g_param_spec_uint("right_padding", _("Right Padding"), _("The padding to insert at the right of the widget."), 0, G_MAXINT, 0, G_PARAM_READABLE | G_PARAM_WRITABLE)); g_type_class_add_private (gobject_class, sizeof (GtkAlignmentPrivate)); } static void gtk_alignment_init (GtkAlignment *alignment) { GtkAlignmentPrivate *priv; GTK_WIDGET_SET_FLAGS (alignment, GTK_NO_WINDOW); gtk_widget_set_redraw_on_allocate (GTK_WIDGET (alignment), FALSE); alignment->xalign = 0.5; alignment->yalign = 0.5; alignment->xscale = 1.0; alignment->yscale = 1.0; /* Initialize padding with default values: */ priv = GTK_ALIGNMENT_GET_PRIVATE (alignment); priv->padding_top = 0; priv->padding_bottom = 0; priv->padding_left = 0; priv->padding_right = 0; } GtkWidget* gtk_alignment_new (gfloat xalign, gfloat yalign, gfloat xscale, gfloat yscale) { GtkAlignment *alignment; alignment = g_object_new (GTK_TYPE_ALIGNMENT, NULL); alignment->xalign = CLAMP (xalign, 0.0, 1.0); alignment->yalign = CLAMP (yalign, 0.0, 1.0); alignment->xscale = CLAMP (xscale, 0.0, 1.0); alignment->yscale = CLAMP (yscale, 0.0, 1.0); return GTK_WIDGET (alignment); } static void gtk_alignment_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { GtkAlignment *alignment; GtkAlignmentPrivate *priv; alignment = GTK_ALIGNMENT (object); priv = GTK_ALIGNMENT_GET_PRIVATE (alignment); switch (prop_id) { case PROP_XALIGN: gtk_alignment_set (alignment, g_value_get_float (value), alignment->yalign, alignment->xscale, alignment->yscale); break; case PROP_YALIGN: gtk_alignment_set (alignment, alignment->xalign, g_value_get_float (value), alignment->xscale, alignment->yscale); break; case PROP_XSCALE: gtk_alignment_set (alignment, alignment->xalign, alignment->yalign, g_value_get_float (value), alignment->yscale); break; case PROP_YSCALE: gtk_alignment_set (alignment, alignment->xalign, alignment->yalign, alignment->xscale, g_value_get_float (value)); break; /* Padding: */ case PROP_PADDING_TOP: gtk_alignment_set_padding (alignment, g_value_get_uint (value), priv->padding_bottom, priv->padding_left, priv->padding_right); break; case PROP_PADDING_BOTTOM: gtk_alignment_set_padding (alignment, priv->padding_top, g_value_get_uint (value), priv->padding_left, priv->padding_right); break; case PROP_PADDING_LEFT: gtk_alignment_set_padding (alignment, priv->padding_top, priv->padding_bottom, g_value_get_uint (value), priv->padding_right); break; case PROP_PADDING_RIGHT: gtk_alignment_set_padding (alignment, priv->padding_top, priv->padding_bottom, priv->padding_left, g_value_get_uint (value)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void gtk_alignment_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { GtkAlignment *alignment; GtkAlignmentPrivate *priv; alignment = GTK_ALIGNMENT (object); priv = GTK_ALIGNMENT_GET_PRIVATE (alignment); switch (prop_id) { case PROP_XALIGN: g_value_set_float(value, alignment->xalign); break; case PROP_YALIGN: g_value_set_float(value, alignment->yalign); break; case PROP_XSCALE: g_value_set_float(value, alignment->xscale); break; case PROP_YSCALE: g_value_set_float(value, alignment->yscale); break; /* Padding: */ case PROP_PADDING_TOP: g_value_set_uint (value, priv->padding_top); break; case PROP_PADDING_BOTTOM: g_value_set_uint (value, priv->padding_bottom); break; case PROP_PADDING_LEFT: g_value_set_uint (value, priv->padding_left); break; case PROP_PADDING_RIGHT: g_value_set_uint (value, priv->padding_right); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } void gtk_alignment_set (GtkAlignment *alignment, gfloat xalign, gfloat yalign, gfloat xscale, gfloat yscale) { g_return_if_fail (GTK_IS_ALIGNMENT (alignment)); xalign = CLAMP (xalign, 0.0, 1.0); yalign = CLAMP (yalign, 0.0, 1.0); xscale = CLAMP (xscale, 0.0, 1.0); yscale = CLAMP (yscale, 0.0, 1.0); if ( (alignment->xalign != xalign) || (alignment->yalign != yalign) || (alignment->xscale != xscale) || (alignment->yscale != yscale)) { g_object_freeze_notify (G_OBJECT (alignment)); if (alignment->xalign != xalign) { alignment->xalign = xalign; g_object_notify (G_OBJECT (alignment), "xalign"); } if (alignment->yalign != yalign) { alignment->yalign = yalign; g_object_notify (G_OBJECT (alignment), "yalign"); } if (alignment->xscale != xscale) { alignment->xscale = xscale; g_object_notify (G_OBJECT (alignment), "xscale"); } if (alignment->yscale != yscale) { alignment->yscale = yscale; g_object_notify (G_OBJECT (alignment), "yscale"); } g_object_thaw_notify (G_OBJECT (alignment)); if (GTK_BIN (alignment)->child) gtk_widget_queue_resize (GTK_BIN (alignment)->child); gtk_widget_queue_draw (GTK_WIDGET (alignment)); } } static void gtk_alignment_size_request (GtkWidget *widget, GtkRequisition *requisition) { GtkAlignment *alignment; GtkBin *bin; GtkAlignmentPrivate *priv; alignment = GTK_ALIGNMENT (widget); bin = GTK_BIN (widget); priv = GTK_ALIGNMENT_GET_PRIVATE (widget); requisition->width = GTK_CONTAINER (widget)->border_width * 2; requisition->height = GTK_CONTAINER (widget)->border_width * 2; if (bin->child && GTK_WIDGET_VISIBLE (bin->child)) { GtkRequisition child_requisition; gtk_widget_size_request (bin->child, &child_requisition); requisition->width += child_requisition.width; requisition->height += child_requisition.height; /* Request extra space for the padding: */ requisition->width += (priv->padding_left + priv->padding_right); requisition->height += (priv->padding_top + priv->padding_bottom); } } static void gtk_alignment_size_allocate (GtkWidget *widget, GtkAllocation *allocation) { GtkAlignment *alignment; GtkBin *bin; GtkAllocation child_allocation; GtkRequisition child_requisition; gint width, height; gint border_width; gint padding_horizontal, padding_vertical; GtkAlignmentPrivate *priv; padding_horizontal = 0; padding_vertical = 0; widget->allocation = *allocation; alignment = GTK_ALIGNMENT (widget); bin = GTK_BIN (widget); if (bin->child && GTK_WIDGET_VISIBLE (bin->child)) { gtk_widget_get_child_requisition (bin->child, &child_requisition); border_width = GTK_CONTAINER (alignment)->border_width; priv = GTK_ALIGNMENT_GET_PRIVATE (widget); padding_horizontal = priv->padding_left + priv->padding_right; padding_vertical = priv->padding_top + priv->padding_bottom; width = allocation->width - padding_horizontal - 2 * border_width; height = allocation->height - padding_vertical - 2 * border_width; if (width > child_requisition.width) child_allocation.width = (child_requisition.width * (1.0 - alignment->xscale) + width * alignment->xscale); else child_allocation.width = width; if (height > child_requisition.height) child_allocation.height = (child_requisition.height * (1.0 - alignment->yscale) + height * alignment->yscale); else child_allocation.height = height; child_allocation.x = alignment->xalign * (width - child_allocation.width) + allocation->x + border_width + priv->padding_left; child_allocation.y = alignment->yalign * (height - child_allocation.height) + allocation->y + border_width + priv->padding_top; gtk_widget_size_allocate (bin->child, &child_allocation); } } /** * gtk_alignment_set_padding: * @alignment: a #GtkAlignment * @padding_top: the padding at the top of the widget * @padding_bottom: the padding at the bottom of the widget * @padding_left: the padding at the left of the widget * @padding_right: the padding at the right of the widget. * * Sets the padding on the different sides of the widget. * The padding adds blank space to the sides of the widget. For instance, * this can be used to indent the child widget towards the right by adding * padding on the left. * * Since: 2.4 */ void gtk_alignment_set_padding (GtkAlignment *alignment, guint padding_top, guint padding_bottom, guint padding_left, guint padding_right) { GtkAlignmentPrivate *priv; g_return_if_fail (GTK_IS_ALIGNMENT (alignment)); priv = GTK_ALIGNMENT_GET_PRIVATE (alignment); g_object_freeze_notify (G_OBJECT (alignment)); if (priv->padding_top != padding_top) { priv->padding_top = padding_top; g_object_notify (G_OBJECT (alignment), "top_padding"); } if (priv->padding_bottom != padding_bottom) { priv->padding_bottom = padding_bottom; g_object_notify (G_OBJECT (alignment), "bottom_padding"); } if (priv->padding_left != padding_left) { priv->padding_left = padding_left; g_object_notify (G_OBJECT (alignment), "left_padding"); } if (priv->padding_right != padding_right) { priv->padding_right = padding_right; g_object_notify (G_OBJECT (alignment), "right_padding"); } g_object_thaw_notify (G_OBJECT (alignment)); /* Make sure that the widget and children are redrawn with the new setting: */ if (GTK_BIN (alignment)->child) gtk_widget_queue_resize (GTK_BIN (alignment)->child); gtk_widget_queue_draw (GTK_WIDGET (alignment)); } /** * gtk_alignment_get_padding: * @alignment: a #GtkAlignment * @padding_top: location to store the padding for the top of the widget, or %NULL * @padding_bottom: location to store the padding for the bottom of the widget, or %NULL * @padding_left: location to store the padding for the left of the widget, or %NULL * @padding_right: location to store the padding for the right of the widget, or %NULL * * Gets the padding on the different sides of the widget. * See gtk_alignment_set_padding (). * * Since: 2.4 */ void gtk_alignment_get_padding (GtkAlignment *alignment, guint *padding_top, guint *padding_bottom, guint *padding_left, guint *padding_right) { GtkAlignmentPrivate *priv; g_return_if_fail (GTK_IS_ALIGNMENT (alignment)); priv = GTK_ALIGNMENT_GET_PRIVATE (alignment); if(padding_top) *padding_top = priv->padding_top; if(padding_bottom) *padding_bottom = priv->padding_bottom; if(padding_left) *padding_left = priv->padding_left; if(padding_right) *padding_right = priv->padding_right; }