]> Pileus Git - ~andy/gtk/blobdiff - gtk/gtkalignment.c
Practically everything changed.
[~andy/gtk] / gtk / gtkalignment.c
index b4c624e43b842f3833e90492c39ee6ac2f3b7d1a..018e67d255ae835178d68ce06d1a7a652bb1b817 100644 (file)
-/* GTK - The GIMP Toolkit
+/* GTK - The GTK+ 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 Library General Public
+ * 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
- * Library General Public License for more details.
+ * Lesser General Public License for more details.
  *
- * You should have received a copy of the GNU Library General Public
+ * 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 "config.h"
 #include "gtkalignment.h"
+#include "gtkprivate.h"
+#include "gtkintl.h"
+#include "gtkalias.h"
 
+enum {
+  PROP_0,
 
-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);
+  PROP_XALIGN,
+  PROP_YALIGN,
+  PROP_XSCALE,
+  PROP_YSCALE,
+
+  PROP_TOP_PADDING,
+  PROP_BOTTOM_PADDING,
+  PROP_LEFT_PADDING,
+  PROP_RIGHT_PADDING
+};
 
+#define GTK_ALIGNMENT_GET_PRIVATE(o)  (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_ALIGNMENT, GtkAlignmentPrivate))
 
-guint
-gtk_alignment_get_type ()
+struct _GtkAlignmentPrivate
 {
-  static guint alignment_type = 0;
+  guint padding_top;
+  guint padding_bottom;
+  guint padding_left;
+  guint padding_right;
+};
 
-  if (!alignment_type)
-    {
-      GtkTypeInfo alignment_info =
-      {
-       "GtkAlignment",
-       sizeof (GtkAlignment),
-       sizeof (GtkAlignmentClass),
-       (GtkClassInitFunc) gtk_alignment_class_init,
-       (GtkObjectInitFunc) gtk_alignment_init,
-       (GtkArgSetFunc) NULL,
-        (GtkArgGetFunc) NULL,
-      };
-
-      alignment_type = gtk_type_unique (gtk_bin_get_type (), &alignment_info);
-    }
+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);
 
-  return alignment_type;
-}
+G_DEFINE_TYPE (GtkAlignment, gtk_alignment, GTK_TYPE_BIN)
 
 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",
+                                                      P_("Horizontal alignment"),
+                                                      P_("Horizontal position of child in available space. 0.0 is left aligned, 1.0 is right aligned"),
+                                                      0.0,
+                                                      1.0,
+                                                      0.5,
+                                                      GTK_PARAM_READWRITE));
+   
+  g_object_class_install_property (gobject_class,
+                                   PROP_YALIGN,
+                                   g_param_spec_float("yalign",
+                                                      P_("Vertical alignment"),
+                                                      P_("Vertical position of child in available space. 0.0 is top aligned, 1.0 is bottom aligned"),
+                                                      0.0,
+                                                      1.0,
+                                                     0.5,
+                                                      GTK_PARAM_READWRITE));
+  g_object_class_install_property (gobject_class,
+                                   PROP_XSCALE,
+                                   g_param_spec_float("xscale",
+                                                      P_("Horizontal scale"),
+                                                      P_("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,
+                                                      GTK_PARAM_READWRITE));
+  g_object_class_install_property (gobject_class,
+                                   PROP_YSCALE,
+                                   g_param_spec_float("yscale",
+                                                      P_("Vertical scale"),
+                                                      P_("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,
+                                                      GTK_PARAM_READWRITE));
+
+
+/**
+ * GtkAlignment:top-padding:
+ *
+ * The padding to insert at the top of the widget.
+ *
+ * Since: 2.4
+ */
+  g_object_class_install_property (gobject_class,
+                                   PROP_TOP_PADDING,
+                                   g_param_spec_uint("top-padding",
+                                                      P_("Top Padding"),
+                                                      P_("The padding to insert at the top of the widget."),
+                                                      0,
+                                                      G_MAXINT,
+                                                      0,
+                                                      GTK_PARAM_READWRITE));
+
+/**
+ * GtkAlignment:bottom-padding:
+ *
+ * The padding to insert at the bottom of the widget.
+ *
+ * Since: 2.4
+ */
+  g_object_class_install_property (gobject_class,
+                                   PROP_BOTTOM_PADDING,
+                                   g_param_spec_uint("bottom-padding",
+                                                      P_("Bottom Padding"),
+                                                      P_("The padding to insert at the bottom of the widget."),
+                                                      0,
+                                                      G_MAXINT,
+                                                      0,
+                                                      GTK_PARAM_READWRITE));
+
+/**
+ * GtkAlignment:left-padding:
+ *
+ * The padding to insert at the left of the widget.
+ *
+ * Since: 2.4
+ */
+  g_object_class_install_property (gobject_class,
+                                   PROP_LEFT_PADDING,
+                                   g_param_spec_uint("left-padding",
+                                                      P_("Left Padding"),
+                                                      P_("The padding to insert at the left of the widget."),
+                                                      0,
+                                                      G_MAXINT,
+                                                      0,
+                                                      GTK_PARAM_READWRITE));
+
+/**
+ * GtkAlignment:right-padding:
+ *
+ * The padding to insert at the right of the widget.
+ *
+ * Since: 2.4
+ */
+  g_object_class_install_property (gobject_class,
+                                   PROP_RIGHT_PADDING,
+                                   g_param_spec_uint("right-padding",
+                                                      P_("Right Padding"),
+                                                      P_("The padding to insert at the right of the widget."),
+                                                      0,
+                                                      G_MAXINT,
+                                                      0,
+                                                      GTK_PARAM_READWRITE));
+
+  g_type_class_add_private (gobject_class, sizeof (GtkAlignmentPrivate));  
 }
 
 static void
 gtk_alignment_init (GtkAlignment *alignment)
 {
-  GTK_WIDGET_SET_FLAGS (alignment, GTK_NO_WINDOW | GTK_BASIC);
+  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*
@@ -81,7 +223,7 @@ gtk_alignment_new (gfloat xalign,
 {
   GtkAlignment *alignment;
 
-  alignment = gtk_type_new (gtk_alignment_get_type ());
+  alignment = g_object_new (GTK_TYPE_ALIGNMENT, NULL);
 
   alignment->xalign = CLAMP (xalign, 0.0, 1.0);
   alignment->yalign = CLAMP (yalign, 0.0, 1.0);
@@ -91,6 +233,132 @@ gtk_alignment_new (gfloat xalign,
   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_TOP_PADDING:
+      gtk_alignment_set_padding (alignment,
+                        g_value_get_uint (value),
+                        priv->padding_bottom,
+                        priv->padding_left,
+                        priv->padding_right);
+      break;
+    case PROP_BOTTOM_PADDING:
+      gtk_alignment_set_padding (alignment,
+                        priv->padding_top,
+                        g_value_get_uint (value),
+                        priv->padding_left,
+                        priv->padding_right);
+      break;
+    case PROP_LEFT_PADDING:
+      gtk_alignment_set_padding (alignment,
+                        priv->padding_top,
+                        priv->padding_bottom,
+                        g_value_get_uint (value),
+                        priv->padding_right);
+      break;
+    case PROP_RIGHT_PADDING:
+      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_TOP_PADDING:
+      g_value_set_uint (value, priv->padding_top);
+      break;
+    case PROP_BOTTOM_PADDING:
+      g_value_set_uint (value, priv->padding_bottom);
+      break;
+    case PROP_LEFT_PADDING:
+      g_value_set_uint (value, priv->padding_left);
+      break;
+    case PROP_RIGHT_PADDING:
+      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,
@@ -98,7 +366,6 @@ gtk_alignment_set (GtkAlignment *alignment,
                   gfloat        xscale,
                   gfloat        yscale)
 {
-  g_return_if_fail (alignment != NULL);
   g_return_if_fail (GTK_IS_ALIGNMENT (alignment));
 
   xalign = CLAMP (xalign, 0.0, 1.0);
@@ -106,17 +373,36 @@ gtk_alignment_set (GtkAlignment *alignment,
   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))
+  if (   (alignment->xalign != xalign)
+      || (alignment->yalign != yalign)
+      || (alignment->xscale != xscale)
+      || (alignment->yscale != yscale))
     {
-      alignment->xalign = xalign;
-      alignment->yalign = yalign;
-      alignment->xscale = xscale;
-      alignment->yscale = yscale;
-
-      gtk_widget_size_allocate (GTK_WIDGET (alignment), &(GTK_WIDGET (alignment)->allocation));
+      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));
     }
 }
@@ -126,25 +412,27 @@ static void
 gtk_alignment_size_request (GtkWidget      *widget,
                            GtkRequisition *requisition)
 {
-  GtkAlignment *alignment;
   GtkBin *bin;
+  GtkAlignmentPrivate *priv;
 
-  g_return_if_fail (widget != NULL);
-  g_return_if_fail (GTK_IS_ALIGNMENT (widget));
-  g_return_if_fail (requisition != NULL);
-
-  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))
     {
-      gtk_widget_size_request (bin->child, &bin->child->requisition);
+      GtkRequisition child_requisition;
+      
+      gtk_widget_size_request (bin->child, &child_requisition);
+
+      requisition->width += child_requisition.width;
+      requisition->height += child_requisition.height;
 
-      requisition->width += bin->child->requisition.width;
-      requisition->height += bin->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);
     }
 }
 
@@ -155,41 +443,151 @@ gtk_alignment_size_allocate (GtkWidget     *widget,
   GtkAlignment *alignment;
   GtkBin *bin;
   GtkAllocation child_allocation;
+  GtkRequisition child_requisition;
   gint width, height;
-  gint x, y;
+  gint border_width;
+  gint padding_horizontal, padding_vertical;
+  GtkAlignmentPrivate *priv;
 
-  g_return_if_fail (widget != NULL);
-  g_return_if_fail (GTK_IS_ALIGNMENT (widget));
-  g_return_if_fail (allocation != NULL);
+  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))
     {
-      x = GTK_CONTAINER (alignment)->border_width;
-      y = GTK_CONTAINER (alignment)->border_width;
-      width = MAX (allocation->width - 2 * x, 0);
-      height = MAX (allocation->height - 2 * y, 0);
+      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;
 
-      if (width > bin->child->requisition.width)
-       child_allocation.width = (bin->child->requisition.width *
+      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 > bin->child->requisition.height)
-       child_allocation.height = (bin->child->requisition.height *
-                                 (1.0 - alignment->yscale) +
-                                 height * alignment->yscale);
+      
+      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 + x;
-      child_allocation.y = alignment->yalign * (height - child_allocation.height) + allocation->y + y;
+      if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL)
+       child_allocation.x = (1.0 - alignment->xalign) * (width - child_allocation.width) + allocation->x + border_width + priv->padding_right;
+      else 
+       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;
+}
+
+#define __GTK_ALIGNMENT_C__
+#include "gtkaliasdef.c"