* 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.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#include "config.h"
#include <string.h>
+
+#include "gtkbuildable.h"
#include "gtkcontainer.h"
#include "gtkintl.h"
+#include "gtktypebuiltins.h"
#include "gtkprivate.h"
-#include "gtksizegroup.h"
-#include "gtkbuildable.h"
-#include "gtksizerequest.h"
+#include "gtksizegroup-private.h"
+#include "gtksizerequestcacheprivate.h"
+#include "gtkwidgetprivate.h"
+#include "gtkcontainerprivate.h"
+/**
+ * SECTION:gtksizegroup
+ * @Short_description: Grouping widgets so they request the same size
+ * @Title: GtkSizeGroup
+ *
+ * #GtkSizeGroup provides a mechanism for grouping a number of widgets
+ * together so they all request the same amount of space. This is
+ * typically useful when you want a column of widgets to have the same
+ * size, but you can't use a #GtkGrid widget.
+ *
+ * In detail, the size requested for each widget in a #GtkSizeGroup is
+ * the maximum of the sizes that would have been requested for each
+ * widget in the size group if they were not in the size group. The mode
+ * of the size group (see gtk_size_group_set_mode()) determines whether
+ * this applies to the horizontal size, the vertical size, or both sizes.
+ *
+ * Note that size groups only affect the amount of space requested, not
+ * the size that the widgets finally receive. If you want the widgets in
+ * a #GtkSizeGroup to actually be the same size, you need to pack them in
+ * such a way that they get the size they request and not more. For
+ * example, if you are packing your widgets into a table, you would not
+ * include the %GTK_FILL flag.
+ *
+ * #GtkSizeGroup objects are referenced by each widget in the size group,
+ * so once you have added all widgets to a #GtkSizeGroup, you can drop
+ * the initial reference to the size group with g_object_unref(). If the
+ * widgets in the size group are subsequently destroyed, then they will
+ * be removed from the size group and drop their references on the size
+ * group; when all widgets have been removed, the size group will be
+ * freed.
+ *
+ * Widgets can be part of multiple size groups; GTK+ will compute the
+ * horizontal size of a widget from the horizontal requisition of all
+ * widgets that can be reached from the widget by a chain of size groups
+ * of type %GTK_SIZE_GROUP_HORIZONTAL or %GTK_SIZE_GROUP_BOTH, and the
+ * vertical size from the vertical requisition of all widgets that can be
+ * reached from the widget by a chain of size groups of type
+ * %GTK_SIZE_GROUP_VERTICAL or %GTK_SIZE_GROUP_BOTH.
+ *
+ * Note that only non-contextual sizes of every widget are ever consulted
+ * by size groups (since size groups have no knowledge of what size a widget
+ * will be allocated in one dimension, it cannot derive how much height
+ * a widget will receive for a given width). When grouping widgets that
+ * trade height for width in mode %GTK_SIZE_GROUP_VERTICAL or %GTK_SIZE_GROUP_BOTH:
+ * the height for the minimum width will be the requested height for all
+ * widgets in the group. The same is of course true when horizontally grouping
+ * width for height widgets.
+ *
+ * Widgets that trade height-for-width should set a reasonably large minimum width
+ * by way of #GtkLabel:width-chars for instance. Widgets with static sizes as well
+ * as widgets that grow (such as ellipsizing text) need no such considerations.
+ *
+ * <refsect2 id="GtkSizeGroup-BUILDER-UI">
+ * <title>GtkSizeGroup as GtkBuildable</title>
+ * <para>
+ * Size groups can be specified in a UI definition by placing an
+ * <object> element with <literal>class="GtkSizeGroup"</literal>
+ * somewhere in the UI definition. The widgets that belong to the
+ * size group are specified by a <widgets> element that may
+ * contain multiple <widget> elements, one for each member
+ * of the size group. The name attribute gives the id of the widget.
+ *
+ * <example>
+ * <title>A UI definition fragment with GtkSizeGroup</title>
+ * <programlisting><![CDATA[
+ * <object class="GtkSizeGroup">
+ * <property name="mode">GTK_SIZE_GROUP_HORIZONTAL</property>
+ * <widgets>
+ * <widget name="radio1"/>
+ * <widget name="radio2"/>
+ * </widgets>
+ * </object>
+ * ]]></programlisting>
+ * </example>
+ * </para>
+ * </refsect2>
+ */
+
struct _GtkSizeGroupPrivate
{
- GtkRequisition requisition;
-
GSList *widgets;
guint8 mode;
- guint have_width : 1;
- guint have_height : 1;
guint ignore_hidden : 1;
};
GValue *value,
GParamSpec *pspec);
-static void add_group_to_closure (GtkSizeGroup *group,
- GtkSizeGroupMode mode,
- GSList **groups,
- GSList **widgets);
-static void add_widget_to_closure (GtkWidget *widget,
- GtkSizeGroupMode mode,
- GSList **groups,
- GSList **widgets);
-
/* GtkBuildable */
static void gtk_size_group_buildable_init (GtkBuildableIface *iface);
static gboolean gtk_size_group_buildable_custom_tag_start (GtkBuildable *buildable,
const gchar *tagname,
gpointer user_data);
-static GQuark size_groups_quark;
-static const gchar size_groups_tag[] = "gtk-size-groups";
-
-static GQuark visited_quark;
-static const gchar visited_tag[] = "gtk-size-group-visited";
-
-static GQuark bumping_quark;
-static const gchar bumping_tag[] = "gtk-size-group-bumping";
-
-static GSList *
-get_size_groups (GtkWidget *widget)
-{
- return g_object_get_qdata (G_OBJECT (widget), size_groups_quark);
-}
+G_STATIC_ASSERT (GTK_SIZE_GROUP_HORIZONTAL == (1 << GTK_ORIENTATION_HORIZONTAL));
+G_STATIC_ASSERT (GTK_SIZE_GROUP_VERTICAL == (1 << GTK_ORIENTATION_VERTICAL));
+G_STATIC_ASSERT (GTK_SIZE_GROUP_BOTH == (GTK_SIZE_GROUP_HORIZONTAL | GTK_SIZE_GROUP_VERTICAL));
static void
-set_size_groups (GtkWidget *widget,
- GSList *groups)
+add_widget_to_closure (GHashTable *widgets,
+ GHashTable *groups,
+ GtkWidget *widget,
+ GtkOrientation orientation)
{
- g_object_set_qdata (G_OBJECT (widget), size_groups_quark, groups);
-}
+ GSList *tmp_groups, *tmp_widgets;
+ gboolean hidden;
-static void
-mark_visited (gpointer object)
-{
- g_object_set_qdata (object, visited_quark, "visited");
-}
+ if (g_hash_table_lookup (widgets, widget))
+ return;
-static void
-mark_unvisited (gpointer object)
-{
- g_object_set_qdata (object, visited_quark, NULL);
-}
+ g_hash_table_add (widgets, widget);
+ hidden = !gtk_widget_is_visible (widget);
-static gboolean
-is_visited (gpointer object)
-{
- return g_object_get_qdata (object, visited_quark) != NULL;
-}
+ for (tmp_groups = _gtk_widget_get_sizegroups (widget); tmp_groups; tmp_groups = tmp_groups->next)
+ {
+ GtkSizeGroup *tmp_group = tmp_groups->data;
+ GtkSizeGroupPrivate *tmp_priv = tmp_group->priv;
-static void
-mark_bumping (gpointer object, gboolean bumping)
-{
- g_object_set_qdata (object, bumping_quark, bumping ? "bumping" : NULL);
-}
+ if (g_hash_table_lookup (groups, tmp_group))
+ continue;
-static gboolean
-is_bumping (gpointer object)
-{
- return g_object_get_qdata (object, bumping_quark) != NULL;
-}
+ if (tmp_priv->ignore_hidden && hidden)
+ continue;
-static void
-add_group_to_closure (GtkSizeGroup *group,
- GtkSizeGroupMode mode,
- GSList **groups,
- GSList **widgets)
-{
- GtkSizeGroupPrivate *priv = group->priv;
- GSList *tmp_widgets;
-
- *groups = g_slist_prepend (*groups, group);
- mark_visited (group);
+ if (!(tmp_priv->mode & (1 << orientation)))
+ continue;
- tmp_widgets = priv->widgets;
- while (tmp_widgets)
- {
- GtkWidget *tmp_widget = tmp_widgets->data;
-
- if (!is_visited (tmp_widget))
- add_widget_to_closure (tmp_widget, mode, groups, widgets);
-
- tmp_widgets = tmp_widgets->next;
+ g_hash_table_add (groups, tmp_group);
+
+ for (tmp_widgets = tmp_priv->widgets; tmp_widgets; tmp_widgets = tmp_widgets->next)
+ add_widget_to_closure (widgets, groups, tmp_widgets->data, orientation);
}
}
-static void
-add_widget_to_closure (GtkWidget *widget,
- GtkSizeGroupMode mode,
- GSList **groups,
- GSList **widgets)
+GHashTable *
+_gtk_size_group_get_widget_peers (GtkWidget *for_widget,
+ GtkOrientation orientation)
{
- GSList *tmp_groups;
+ GHashTable *widgets, *groups;
- *widgets = g_slist_prepend (*widgets, widget);
- mark_visited (widget);
+ widgets = g_hash_table_new (g_direct_hash, g_direct_equal);
+ groups = g_hash_table_new (g_direct_hash, g_direct_equal);
- tmp_groups = get_size_groups (widget);
- while (tmp_groups)
- {
- GtkSizeGroup *tmp_group = tmp_groups->data;
- GtkSizeGroupPrivate *tmp_priv = tmp_group->priv;
+ add_widget_to_closure (widgets, groups, for_widget, orientation);
- if ((tmp_priv->mode == GTK_SIZE_GROUP_BOTH || tmp_priv->mode == mode) &&
- !is_visited (tmp_group))
- add_group_to_closure (tmp_group, mode, groups, widgets);
+ g_hash_table_unref (groups);
- tmp_groups = tmp_groups->next;
- }
+ return widgets;
}
-
+
static void
-real_queue_resize (GtkWidget *widget)
+real_queue_resize (GtkWidget *widget,
+ GtkQueueResizeFlags flags)
{
- GtkWidget *parent;
-
- GTK_PRIVATE_SET_FLAG (widget, GTK_ALLOC_NEEDED);
- GTK_PRIVATE_SET_FLAG (widget, GTK_REQUEST_NEEDED);
- GTK_PRIVATE_SET_FLAG (widget, GTK_WIDTH_REQUEST_NEEDED);
- GTK_PRIVATE_SET_FLAG (widget, GTK_HEIGHT_REQUEST_NEEDED);
-
- parent = gtk_widget_get_parent (widget);
- if (parent)
- _gtk_container_queue_resize (GTK_CONTAINER (parent));
- else if (gtk_widget_is_toplevel (widget) && GTK_IS_CONTAINER (widget))
- _gtk_container_queue_resize (GTK_CONTAINER (widget));
-}
+ GtkWidget *container;
-static void
-reset_group_sizes (GSList *groups)
-{
- GSList *tmp_list = groups;
- while (tmp_list)
- {
- GtkSizeGroup *tmp_group = tmp_list->data;
- GtkSizeGroupPrivate *tmp_priv = tmp_group->priv;
+ _gtk_widget_set_alloc_needed (widget, TRUE);
+ _gtk_size_request_cache_clear (_gtk_widget_peek_request_cache (widget));
- tmp_priv->have_width = FALSE;
- tmp_priv->have_height = FALSE;
+ container = gtk_widget_get_parent (widget);
+ if (!container &&
+ gtk_widget_is_toplevel (widget) && GTK_IS_CONTAINER (widget))
+ container = widget;
- tmp_list = tmp_list->next;
+ if (container)
+ {
+ if (flags & GTK_QUEUE_RESIZE_INVALIDATE_ONLY)
+ _gtk_container_resize_invalidate (GTK_CONTAINER (container));
+ else
+ _gtk_container_queue_resize (GTK_CONTAINER (container));
}
}
static void
-queue_resize_on_widget (GtkWidget *widget,
- gboolean check_siblings)
+queue_resize_on_widget (GtkWidget *widget,
+ gboolean check_siblings,
+ GtkQueueResizeFlags flags)
{
GtkWidget *parent = widget;
- GSList *tmp_list;
while (parent)
{
GSList *widget_groups;
- GSList *groups;
- GSList *widgets;
+ GHashTable *widgets;
+ GHashTableIter iter;
+ gpointer current;
if (widget == parent && !check_siblings)
{
- real_queue_resize (widget);
+ real_queue_resize (widget, flags);
parent = gtk_widget_get_parent (parent);
continue;
}
- widget_groups = get_size_groups (parent);
+ widget_groups = _gtk_widget_get_sizegroups (parent);
if (!widget_groups)
{
if (widget == parent)
- real_queue_resize (widget);
+ real_queue_resize (widget, flags);
parent = gtk_widget_get_parent (parent);
continue;
}
- groups = NULL;
- widgets = NULL;
-
- add_widget_to_closure (parent, GTK_SIZE_GROUP_HORIZONTAL, &groups, &widgets);
- g_slist_foreach (widgets, (GFunc)mark_unvisited, NULL);
- g_slist_foreach (groups, (GFunc)mark_unvisited, NULL);
-
- reset_group_sizes (groups);
-
- tmp_list = widgets;
- while (tmp_list)
+ widgets = _gtk_size_group_get_widget_peers (parent, GTK_ORIENTATION_HORIZONTAL);
+
+ g_hash_table_iter_init (&iter, widgets);
+ while (g_hash_table_iter_next (&iter, ¤t, NULL))
{
- if (tmp_list->data == parent)
+ if (current == parent)
{
if (widget == parent)
- real_queue_resize (parent);
+ real_queue_resize (parent, flags);
}
- else if (tmp_list->data == widget)
+ else if (current == widget)
{
g_warning ("A container and its child are part of this SizeGroup");
}
else
- queue_resize_on_widget (tmp_list->data, FALSE);
-
- tmp_list = tmp_list->next;
+ queue_resize_on_widget (current, FALSE, flags);
}
- g_slist_free (widgets);
- g_slist_free (groups);
-
- groups = NULL;
- widgets = NULL;
-
- add_widget_to_closure (parent, GTK_SIZE_GROUP_VERTICAL, &groups, &widgets);
- g_slist_foreach (widgets, (GFunc)mark_unvisited, NULL);
- g_slist_foreach (groups, (GFunc)mark_unvisited, NULL);
-
- reset_group_sizes (groups);
-
- tmp_list = widgets;
- while (tmp_list)
+ g_hash_table_destroy (widgets);
+
+ widgets = _gtk_size_group_get_widget_peers (parent, GTK_ORIENTATION_VERTICAL);
+
+ g_hash_table_iter_init (&iter, widgets);
+ while (g_hash_table_iter_next (&iter, ¤t, NULL))
{
- if (tmp_list->data == parent)
+ if (current == parent)
{
if (widget == parent)
- real_queue_resize (parent);
+ real_queue_resize (parent, flags);
}
- else if (tmp_list->data == widget)
+ else if (current == widget)
{
g_warning ("A container and its child are part of this SizeGroup");
}
else
- queue_resize_on_widget (tmp_list->data, FALSE);
-
- tmp_list = tmp_list->next;
+ queue_resize_on_widget (current, FALSE, flags);
}
- g_slist_free (widgets);
- g_slist_free (groups);
+ g_hash_table_destroy (widgets);
parent = gtk_widget_get_parent (parent);
}
}
static void
-queue_resize_on_group (GtkSizeGroup *size_group)
+queue_resize_on_group (GtkSizeGroup *size_group)
{
GtkSizeGroupPrivate *priv = size_group->priv;
if (priv->widgets)
- queue_resize_on_widget (priv->widgets->data, TRUE);
-}
-
-static void
-initialize_size_group_quarks (void)
-{
- if (!size_groups_quark)
- {
- size_groups_quark = g_quark_from_static_string (size_groups_tag);
- visited_quark = g_quark_from_static_string (visited_tag);
- bumping_quark = g_quark_from_static_string (bumping_tag);
- }
+ queue_resize_on_widget (priv->widgets->data, TRUE, 0);
}
static void
GTK_PARAM_READWRITE));
g_type_class_add_private (klass, sizeof (GtkSizeGroupPrivate));
-
- initialize_size_group_quarks ();
}
static void
priv->widgets = NULL;
priv->mode = GTK_SIZE_GROUP_HORIZONTAL;
- priv->have_width = 0;
- priv->have_height = 0;
- priv->ignore_hidden = 0;
+ priv->ignore_hidden = FALSE;
}
static void
*
* Sets the #GtkSizeGroupMode of the size group. The mode of the size
* group determines whether the widgets in the size group should
- * all have the same horizontal requisition (%GTK_SIZE_GROUP_MODE_HORIZONTAL)
- * all have the same vertical requisition (%GTK_SIZE_GROUP_MODE_VERTICAL),
+ * all have the same horizontal requisition (%GTK_SIZE_GROUP_HORIZONTAL)
+ * all have the same vertical requisition (%GTK_SIZE_GROUP_VERTICAL),
* or should all have the same requisition in both directions
- * (%GTK_SIZE_GROUP_MODE_BOTH).
+ * (%GTK_SIZE_GROUP_BOTH).
**/
void
gtk_size_group_set_mode (GtkSizeGroup *size_group,
priv = size_group->priv;
- groups = get_size_groups (widget);
+ groups = _gtk_widget_get_sizegroups (widget);
if (!g_slist_find (groups, size_group))
{
- groups = g_slist_prepend (groups, size_group);
- set_size_groups (widget, groups);
+ _gtk_widget_add_sizegroup (widget, size_group);
priv->widgets = g_slist_prepend (priv->widgets, widget);
GtkWidget *widget)
{
GtkSizeGroupPrivate *priv;
- GSList *groups;
g_return_if_fail (GTK_IS_SIZE_GROUP (size_group));
g_return_if_fail (GTK_IS_WIDGET (widget));
gtk_size_group_widget_destroyed,
size_group);
- groups = get_size_groups (widget);
- groups = g_slist_remove (groups, size_group);
- set_size_groups (widget, groups);
+ _gtk_widget_remove_sizegroup (widget, size_group);
priv->widgets = g_slist_remove (priv->widgets, widget);
queue_resize_on_group (size_group);
return size_group->priv->widgets;
}
-static gint
-get_base_dimension (GtkWidget *widget,
- GtkSizeGroupMode mode)
-{
- GtkWidgetAuxInfo *aux_info = _gtk_widget_get_aux_info (widget, FALSE);
-
- if (mode == GTK_SIZE_GROUP_HORIZONTAL)
- {
- if (aux_info && aux_info->width > 0)
- return aux_info->width;
- else
- {
- /* XXX Possibly we should be using natural values and not minimums here. */
- gint width;
-
- gtk_size_request_get_width (GTK_SIZE_REQUEST (widget), &width, NULL);
-
- return width;
- }
- }
- else
- {
- if (aux_info && aux_info->height > 0)
- return aux_info->height;
- else
- {
- /* XXX Possibly we should be using natural values and not minimums here. */
- gint height;
-
- gtk_size_request_get_height (GTK_SIZE_REQUEST (widget), &height, NULL);
-
- return height;
- }
- }
-}
-
-static gint
-compute_dimension (GtkWidget *widget,
- GtkSizeGroupMode mode,
- gint widget_requisition)
-{
- GSList *widgets = NULL;
- GSList *groups = NULL;
- GSList *tmp_list;
- gint result = 0;
-
- add_widget_to_closure (widget, mode, &groups, &widgets);
-
- g_slist_foreach (widgets, (GFunc)mark_unvisited, NULL);
- g_slist_foreach (groups, (GFunc)mark_unvisited, NULL);
-
- g_slist_foreach (widgets, (GFunc)g_object_ref, NULL);
-
- if (!groups)
- {
- result = widget_requisition;
- }
- else
- {
- GtkSizeGroup *group = groups->data;
- GtkSizeGroupPrivate *priv = group->priv;
-
- if (mode == GTK_SIZE_GROUP_HORIZONTAL && priv->have_width)
- result = priv->requisition.width;
- else if (mode == GTK_SIZE_GROUP_VERTICAL && priv->have_height)
- result = priv->requisition.height;
- else
- {
- tmp_list = widgets;
- while (tmp_list)
- {
- GtkWidget *tmp_widget = tmp_list->data;
- gint dimension;
-
- if (tmp_widget == widget)
- dimension = widget_requisition;
- else
- dimension = get_base_dimension (tmp_widget, mode);
-
- if (gtk_widget_get_mapped (tmp_widget) || !priv->ignore_hidden)
- {
- if (dimension > result)
- result = dimension;
- }
-
- tmp_list = tmp_list->next;
- }
-
- tmp_list = groups;
- while (tmp_list)
- {
- GtkSizeGroup *tmp_group = tmp_list->data;
- GtkSizeGroupPrivate *tmp_priv = tmp_group->priv;
-
- if (mode == GTK_SIZE_GROUP_HORIZONTAL)
- {
- tmp_priv->have_width = TRUE;
- tmp_priv->requisition.width = result;
- }
- else
- {
- tmp_priv->have_height = TRUE;
- tmp_priv->requisition.height = result;
- }
-
- tmp_list = tmp_list->next;
- }
- }
- }
-
- g_slist_foreach (widgets, (GFunc)g_object_unref, NULL);
-
- g_slist_free (widgets);
- g_slist_free (groups);
-
- return result;
-}
-
-/**
- * _gtk_size_group_bump_requisition:
- * @widget: a #GtkWidget
- * @mode: either %GTK_SIZE_GROUP_HORIZONTAL or %GTK_SIZE_GROUP_VERTICAL, depending
- * on the dimension in which to bump the size.
- *
- * Refreshes the sizegroup while returning the groups requested
- * value in the dimension @mode.
- *
- * This function is used to update sizegroup minimum size information
- * in multiple passes from the new #GtkSizeRequest manager.
- */
-gint
-_gtk_size_group_bump_requisition (GtkWidget *widget,
- GtkSizeGroupMode mode,
- gint widget_requisition)
-{
- gint result = widget_requisition;
-
- if (!is_bumping (widget))
- {
- GtkWidgetAuxInfo *aux_info =
- _gtk_widget_get_aux_info (widget, FALSE);
-
- /* Avoid recursion here */
- mark_bumping (widget, TRUE);
-
- if (get_size_groups (widget))
- {
- if (aux_info)
- {
- if (mode == GTK_SIZE_GROUP_HORIZONTAL)
- result = compute_dimension (widget, mode, MAX (aux_info->width, widget_requisition));
- else
- result = compute_dimension (widget, mode, MAX (aux_info->height, widget_requisition));
- }
- else
- result = compute_dimension (widget, mode, widget_requisition);
- }
- else if (aux_info)
- {
- if (mode == GTK_SIZE_GROUP_HORIZONTAL)
- result = MAX (aux_info->width, widget_requisition);
- else
- result = MAX (aux_info->height, widget_requisition);
- }
- mark_bumping (widget, FALSE);
- }
- return result;
-}
-
-
-
/**
* _gtk_size_group_queue_resize:
* @widget: a #GtkWidget
* Queue a resize on a widget, and on all other widgets grouped with this widget.
**/
void
-_gtk_size_group_queue_resize (GtkWidget *widget)
+_gtk_size_group_queue_resize (GtkWidget *widget,
+ GtkQueueResizeFlags flags)
{
- initialize_size_group_quarks ();
-
- queue_resize_on_widget (widget, TRUE);
+ queue_resize_on_widget (widget, TRUE, flags);
}
typedef struct {
projects / ~andy / gtk / blobdiff