forked from AuroraMiddleware/gtk
70bf6d4b97
We no longer have any child properties in our containers, so drop the infrastructure for it.
910 lines
29 KiB
C
910 lines
29 KiB
C
/* 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, see <http://www.gnu.org/licenses/>.
|
||
*/
|
||
|
||
/*
|
||
* 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 "gtkcontainerprivate.h"
|
||
|
||
#include "gtkadjustment.h"
|
||
#include "gtkbuildable.h"
|
||
#include "gtkbuilderprivate.h"
|
||
#include "gtkintl.h"
|
||
#include "gtkprivate.h"
|
||
#include "gtkmarshalers.h"
|
||
#include "gtksizerequest.h"
|
||
#include "gtkstylecontextprivate.h"
|
||
#include "gtktypebuiltins.h"
|
||
#include "gtkwidgetprivate.h"
|
||
//#include "gtkwindowprivate.h"
|
||
|
||
#include "a11y/gtkcontaineraccessibleprivate.h"
|
||
|
||
#include <gobject/gobjectnotifyqueue.c>
|
||
#include <gobject/gvaluecollector.h>
|
||
#include <stdarg.h>
|
||
#include <stdlib.h>
|
||
#include <string.h>
|
||
|
||
/**
|
||
* SECTION:gtkcontainer
|
||
* @Short_description: Base class for widgets which contain other widgets
|
||
* @Title: GtkContainer
|
||
*
|
||
* A GTK+ user interface is constructed by nesting widgets inside widgets.
|
||
* Container widgets are the inner nodes in the resulting tree of widgets:
|
||
* they contain other widgets. So, for example, you might have a #GtkWindow
|
||
* containing a #GtkFrame containing a #GtkLabel. If you wanted an image instead
|
||
* of a textual label inside the frame, you might replace the #GtkLabel widget
|
||
* with a #GtkImage widget.
|
||
*
|
||
* There are two major kinds of container widgets in GTK+. Both are subclasses
|
||
* of the abstract GtkContainer base class.
|
||
*
|
||
* The first type of container widget has a single child widget and derives
|
||
* from #GtkBin. These containers are decorators, which
|
||
* add some kind of functionality to the child. For example, a #GtkButton makes
|
||
* its child into a clickable button; a #GtkFrame draws a frame around its child
|
||
* and a #GtkWindow places its child widget inside a top-level window.
|
||
*
|
||
* The second type of container can have more than one child; its purpose is to
|
||
* manage layout. This means that these containers assign
|
||
* sizes and positions to their children. For example, a horizontal #GtkBox arranges its
|
||
* children in a horizontal row, and a #GtkGrid arranges the widgets it contains
|
||
* in a two-dimensional grid.
|
||
*
|
||
* For implementations of #GtkContainer the virtual method #GtkContainerClass.forall()
|
||
* is always required, since it's used for drawing and other internal operations
|
||
* on the children.
|
||
* If the #GtkContainer implementation expect to have non internal children
|
||
* it's needed to implement both #GtkContainerClass.add() and #GtkContainerClass.remove().
|
||
* If the GtkContainer implementation has internal children, they should be added
|
||
* with gtk_widget_set_parent() on init() and removed with gtk_widget_unparent()
|
||
* in the #GtkWidgetClass.destroy() implementation.
|
||
* See more about implementing custom widgets at https://wiki.gnome.org/HowDoI/CustomWidgets
|
||
*/
|
||
|
||
|
||
struct _GtkContainerPrivate
|
||
{
|
||
guint resize_handler;
|
||
|
||
guint restyle_pending : 1;
|
||
};
|
||
|
||
enum {
|
||
ADD,
|
||
REMOVE,
|
||
LAST_SIGNAL
|
||
};
|
||
|
||
#define PARAM_SPEC_PARAM_ID(pspec) ((pspec)->param_id)
|
||
#define PARAM_SPEC_SET_PARAM_ID(pspec, id) ((pspec)->param_id = (id))
|
||
|
||
|
||
/* --- prototypes --- */
|
||
static void gtk_container_base_class_init (GtkContainerClass *klass);
|
||
static void gtk_container_base_class_finalize (GtkContainerClass *klass);
|
||
static void gtk_container_class_init (GtkContainerClass *klass);
|
||
static void gtk_container_init (GtkContainer *container);
|
||
static void gtk_container_destroy (GtkWidget *widget);
|
||
static void gtk_container_add_unimplemented (GtkContainer *container,
|
||
GtkWidget *widget);
|
||
static void gtk_container_remove_unimplemented (GtkContainer *container,
|
||
GtkWidget *widget);
|
||
static void gtk_container_compute_expand (GtkWidget *widget,
|
||
gboolean *hexpand_p,
|
||
gboolean *vexpand_p);
|
||
static void gtk_container_real_set_focus_child (GtkContainer *container,
|
||
GtkWidget *widget);
|
||
|
||
static void gtk_container_children_callback (GtkWidget *widget,
|
||
gpointer client_data);
|
||
static GtkSizeRequestMode gtk_container_get_request_mode (GtkWidget *widget);
|
||
|
||
static GtkWidgetPath * gtk_container_real_get_path_for_child (GtkContainer *container,
|
||
GtkWidget *child);
|
||
|
||
/* GtkBuildable */
|
||
static void gtk_container_buildable_init (GtkBuildableIface *iface);
|
||
static void gtk_container_buildable_add_child (GtkBuildable *buildable,
|
||
GtkBuilder *builder,
|
||
GObject *child,
|
||
const gchar *type);
|
||
|
||
/* --- variables --- */
|
||
static GQuark vadjustment_key_id;
|
||
static GQuark hadjustment_key_id;
|
||
static guint container_signals[LAST_SIGNAL] = { 0 };
|
||
static gint GtkContainer_private_offset;
|
||
static GtkWidgetClass *gtk_container_parent_class = NULL;
|
||
static GtkBuildableIface *parent_buildable_iface;
|
||
|
||
|
||
/* --- functions --- */
|
||
static inline gpointer
|
||
gtk_container_get_instance_private (GtkContainer *self)
|
||
{
|
||
return G_STRUCT_MEMBER_P (self, GtkContainer_private_offset);
|
||
}
|
||
|
||
GType
|
||
gtk_container_get_type (void)
|
||
{
|
||
static GType container_type = 0;
|
||
|
||
if (!container_type)
|
||
{
|
||
const GTypeInfo container_info =
|
||
{
|
||
sizeof (GtkContainerClass),
|
||
(GBaseInitFunc) gtk_container_base_class_init,
|
||
(GBaseFinalizeFunc) gtk_container_base_class_finalize,
|
||
(GClassInitFunc) gtk_container_class_init,
|
||
NULL /* class_finalize */,
|
||
NULL /* class_data */,
|
||
sizeof (GtkContainer),
|
||
0 /* n_preallocs */,
|
||
(GInstanceInitFunc) gtk_container_init,
|
||
NULL, /* value_table */
|
||
};
|
||
|
||
const GInterfaceInfo buildable_info =
|
||
{
|
||
(GInterfaceInitFunc) gtk_container_buildable_init,
|
||
NULL,
|
||
NULL
|
||
};
|
||
|
||
container_type =
|
||
g_type_register_static (GTK_TYPE_WIDGET, I_("GtkContainer"),
|
||
&container_info, G_TYPE_FLAG_ABSTRACT);
|
||
|
||
GtkContainer_private_offset =
|
||
g_type_add_instance_private (container_type, sizeof (GtkContainerPrivate));
|
||
|
||
g_type_add_interface_static (container_type,
|
||
GTK_TYPE_BUILDABLE,
|
||
&buildable_info);
|
||
|
||
}
|
||
|
||
return container_type;
|
||
}
|
||
|
||
static void
|
||
gtk_container_base_class_init (GtkContainerClass *class)
|
||
{
|
||
}
|
||
|
||
static void
|
||
gtk_container_base_class_finalize (GtkContainerClass *class)
|
||
{
|
||
}
|
||
|
||
static void
|
||
gtk_container_class_init (GtkContainerClass *class)
|
||
{
|
||
GObjectClass *gobject_class = G_OBJECT_CLASS (class);
|
||
GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (class);
|
||
|
||
gtk_container_parent_class = g_type_class_peek_parent (class);
|
||
|
||
vadjustment_key_id = g_quark_from_static_string ("gtk-vadjustment");
|
||
hadjustment_key_id = g_quark_from_static_string ("gtk-hadjustment");
|
||
|
||
widget_class->destroy = gtk_container_destroy;
|
||
widget_class->compute_expand = gtk_container_compute_expand;
|
||
widget_class->get_request_mode = gtk_container_get_request_mode;
|
||
|
||
class->add = gtk_container_add_unimplemented;
|
||
class->remove = gtk_container_remove_unimplemented;
|
||
class->forall = NULL;
|
||
class->set_focus_child = gtk_container_real_set_focus_child;
|
||
class->child_type = NULL;
|
||
class->get_path_for_child = gtk_container_real_get_path_for_child;
|
||
|
||
container_signals[ADD] =
|
||
g_signal_new (I_("add"),
|
||
G_OBJECT_CLASS_TYPE (gobject_class),
|
||
G_SIGNAL_RUN_FIRST,
|
||
G_STRUCT_OFFSET (GtkContainerClass, add),
|
||
NULL, NULL,
|
||
NULL,
|
||
G_TYPE_NONE, 1,
|
||
GTK_TYPE_WIDGET);
|
||
container_signals[REMOVE] =
|
||
g_signal_new (I_("remove"),
|
||
G_OBJECT_CLASS_TYPE (gobject_class),
|
||
G_SIGNAL_RUN_FIRST,
|
||
G_STRUCT_OFFSET (GtkContainerClass, remove),
|
||
NULL, NULL,
|
||
NULL,
|
||
G_TYPE_NONE, 1,
|
||
GTK_TYPE_WIDGET);
|
||
|
||
if (GtkContainer_private_offset != 0)
|
||
g_type_class_adjust_private_offset (class, &GtkContainer_private_offset);
|
||
|
||
gtk_widget_class_set_accessible_type (widget_class, GTK_TYPE_CONTAINER_ACCESSIBLE);
|
||
}
|
||
|
||
static void
|
||
gtk_container_buildable_init (GtkBuildableIface *iface)
|
||
{
|
||
parent_buildable_iface = g_type_interface_peek_parent (iface);
|
||
iface->add_child = gtk_container_buildable_add_child;
|
||
}
|
||
|
||
static void
|
||
gtk_container_buildable_add_child (GtkBuildable *buildable,
|
||
GtkBuilder *builder,
|
||
GObject *child,
|
||
const gchar *type)
|
||
{
|
||
if (GTK_IS_WIDGET (child) &&
|
||
_gtk_widget_get_parent (GTK_WIDGET (child)) == NULL)
|
||
{
|
||
if (type)
|
||
{
|
||
GTK_BUILDER_WARN_INVALID_CHILD_TYPE (buildable, type);
|
||
}
|
||
else
|
||
{
|
||
gtk_container_add (GTK_CONTAINER (buildable), GTK_WIDGET (child));
|
||
}
|
||
}
|
||
else
|
||
{
|
||
parent_buildable_iface->add_child (buildable, builder, child, type);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_container_child_type:
|
||
* @container: a #GtkContainer
|
||
*
|
||
* Returns the type of the children supported by the container.
|
||
*
|
||
* Note that this may return %G_TYPE_NONE to indicate that no more
|
||
* children can be added, e.g. for a #GtkPaned which already has two
|
||
* children.
|
||
*
|
||
* Returns: a #GType.
|
||
**/
|
||
GType
|
||
gtk_container_child_type (GtkContainer *container)
|
||
{
|
||
GType slot;
|
||
GtkContainerClass *class;
|
||
|
||
g_return_val_if_fail (GTK_IS_CONTAINER (container), 0);
|
||
|
||
class = GTK_CONTAINER_GET_CLASS (container);
|
||
if (class->child_type)
|
||
slot = class->child_type (container);
|
||
else
|
||
slot = G_TYPE_NONE;
|
||
|
||
return slot;
|
||
}
|
||
|
||
static void
|
||
gtk_container_add_unimplemented (GtkContainer *container,
|
||
GtkWidget *widget)
|
||
{
|
||
g_warning ("GtkContainerClass::add not implemented for '%s'", g_type_name (G_TYPE_FROM_INSTANCE (container)));
|
||
}
|
||
|
||
static void
|
||
gtk_container_remove_unimplemented (GtkContainer *container,
|
||
GtkWidget *widget)
|
||
{
|
||
g_warning ("GtkContainerClass::remove not implemented for '%s'", g_type_name (G_TYPE_FROM_INSTANCE (container)));
|
||
}
|
||
|
||
static void
|
||
gtk_container_init (GtkContainer *container)
|
||
{
|
||
}
|
||
|
||
static void
|
||
gtk_container_destroy (GtkWidget *widget)
|
||
{
|
||
GtkContainer *container = GTK_CONTAINER (widget);
|
||
GtkContainerPrivate *priv = gtk_container_get_instance_private (container);
|
||
|
||
if (priv->restyle_pending)
|
||
priv->restyle_pending = FALSE;
|
||
|
||
gtk_container_foreach (container, (GtkCallback) gtk_widget_destroy, NULL);
|
||
|
||
GTK_WIDGET_CLASS (gtk_container_parent_class)->destroy (widget);
|
||
}
|
||
|
||
/**
|
||
* gtk_container_add:
|
||
* @container: a #GtkContainer
|
||
* @widget: a widget to be placed inside @container
|
||
*
|
||
* Adds @widget to @container. Typically used for simple containers
|
||
* such as #GtkWindow, #GtkFrame, or #GtkButton; for more complicated
|
||
* layout containers such #GtkGrid, this function will
|
||
* pick default packing parameters that may not be correct. So
|
||
* consider functions such as gtk_grid_attach() as an alternative
|
||
* to gtk_container_add() in those cases. A widget may be added to
|
||
* only one container at a time; you can’t place the same widget
|
||
* inside two different containers.
|
||
*
|
||
* Note that some containers, such as #GtkScrolledWindow or #GtkListBox,
|
||
* may add intermediate children between the added widget and the
|
||
* container.
|
||
*/
|
||
void
|
||
gtk_container_add (GtkContainer *container,
|
||
GtkWidget *widget)
|
||
{
|
||
GtkWidget *parent;
|
||
|
||
g_return_if_fail (GTK_IS_CONTAINER (container));
|
||
g_return_if_fail (GTK_IS_WIDGET (widget));
|
||
|
||
parent = _gtk_widget_get_parent (widget);
|
||
|
||
if (parent != NULL)
|
||
{
|
||
g_warning ("Attempting to add a widget with type %s to a container of "
|
||
"type %s, but the widget is already inside a container of type %s, "
|
||
"please remove the widget from its existing container first." ,
|
||
g_type_name (G_OBJECT_TYPE (widget)),
|
||
g_type_name (G_OBJECT_TYPE (container)),
|
||
g_type_name (G_OBJECT_TYPE (parent)));
|
||
return;
|
||
}
|
||
|
||
g_signal_emit (container, container_signals[ADD], 0, widget);
|
||
|
||
_gtk_container_accessible_add (GTK_WIDGET (container), widget);
|
||
}
|
||
|
||
/**
|
||
* gtk_container_remove:
|
||
* @container: a #GtkContainer
|
||
* @widget: a current child of @container
|
||
*
|
||
* Removes @widget from @container. @widget must be inside @container.
|
||
* Note that @container will own a reference to @widget, and that this
|
||
* may be the last reference held; so removing a widget from its
|
||
* container can destroy that widget. If you want to use @widget
|
||
* again, you need to add a reference to it before removing it from
|
||
* a container, using g_object_ref(). If you don’t want to use @widget
|
||
* again it’s usually more efficient to simply destroy it directly
|
||
* using gtk_widget_destroy() since this will remove it from the
|
||
* container and help break any circular reference count cycles.
|
||
**/
|
||
void
|
||
gtk_container_remove (GtkContainer *container,
|
||
GtkWidget *widget)
|
||
{
|
||
g_return_if_fail (GTK_IS_CONTAINER (container));
|
||
g_return_if_fail (GTK_IS_WIDGET (widget));
|
||
|
||
g_object_ref (container);
|
||
g_object_ref (widget);
|
||
|
||
g_signal_emit (container, container_signals[REMOVE], 0, widget);
|
||
|
||
_gtk_container_accessible_remove (GTK_WIDGET (container), widget);
|
||
|
||
g_object_unref (widget);
|
||
g_object_unref (container);
|
||
}
|
||
|
||
static gboolean
|
||
gtk_container_needs_idle_sizer (GtkContainer *container)
|
||
{
|
||
GtkContainerPrivate *priv = gtk_container_get_instance_private (container);
|
||
|
||
if (priv->restyle_pending)
|
||
return TRUE;
|
||
|
||
return gtk_widget_needs_allocate (GTK_WIDGET (container));
|
||
}
|
||
|
||
static void
|
||
gtk_container_idle_sizer (GdkFrameClock *clock,
|
||
GtkContainer *container)
|
||
{
|
||
GtkContainerPrivate *priv = gtk_container_get_instance_private (container);
|
||
|
||
/* We validate the style contexts in a single loop before even trying
|
||
* to handle resizes instead of doing validations inline.
|
||
* This is mostly necessary for compatibility reasons with old code,
|
||
* because both style_updated and size_allocate functions often change
|
||
* styles and so could cause infinite loops in this function.
|
||
*
|
||
* It's important to note that even an invalid style context returns
|
||
* sane values. So the result of an invalid style context will never be
|
||
* a program crash, but only a wrong layout or rendering.
|
||
*/
|
||
if (priv->restyle_pending)
|
||
{
|
||
priv->restyle_pending = FALSE;
|
||
gtk_css_node_validate (gtk_widget_get_css_node (GTK_WIDGET (container)));
|
||
}
|
||
|
||
/* we may be invoked with a container_resize_queue of NULL, because
|
||
* queue_resize could have been adding an extra idle function while
|
||
* the queue still got processed. we better just ignore such case
|
||
* than trying to explicitly work around them with some extra flags,
|
||
* since it doesn't cause any actual harm.
|
||
*/
|
||
if (gtk_widget_needs_allocate (GTK_WIDGET (container)))
|
||
{
|
||
if (GTK_IS_WINDOW (container))
|
||
gtk_window_check_resize (GTK_WINDOW (container));
|
||
else
|
||
g_warning ("gtk_container_idle_sizer() called on a non-window");
|
||
}
|
||
|
||
if (!gtk_container_needs_idle_sizer (container))
|
||
{
|
||
gtk_container_stop_idle_sizer (container);
|
||
}
|
||
else
|
||
{
|
||
gdk_frame_clock_request_phase (clock,
|
||
GDK_FRAME_CLOCK_PHASE_LAYOUT);
|
||
}
|
||
}
|
||
|
||
void
|
||
gtk_container_start_idle_sizer (GtkContainer *container)
|
||
{
|
||
GtkContainerPrivate *priv = gtk_container_get_instance_private (container);
|
||
GdkFrameClock *clock;
|
||
|
||
if (priv->resize_handler != 0)
|
||
return;
|
||
|
||
if (!gtk_container_needs_idle_sizer (container))
|
||
return;
|
||
|
||
clock = gtk_widget_get_frame_clock (GTK_WIDGET (container));
|
||
if (clock == NULL)
|
||
return;
|
||
|
||
priv->resize_handler = g_signal_connect (clock, "layout",
|
||
G_CALLBACK (gtk_container_idle_sizer), container);
|
||
gdk_frame_clock_request_phase (clock,
|
||
GDK_FRAME_CLOCK_PHASE_LAYOUT);
|
||
}
|
||
|
||
void
|
||
gtk_container_stop_idle_sizer (GtkContainer *container)
|
||
{
|
||
GtkContainerPrivate *priv = gtk_container_get_instance_private (container);
|
||
|
||
if (priv->resize_handler == 0)
|
||
return;
|
||
|
||
g_signal_handler_disconnect (gtk_widget_get_frame_clock (GTK_WIDGET (container)),
|
||
priv->resize_handler);
|
||
priv->resize_handler = 0;
|
||
}
|
||
|
||
void
|
||
_gtk_container_queue_restyle (GtkContainer *container)
|
||
{
|
||
GtkContainerPrivate *priv = gtk_container_get_instance_private (container);
|
||
|
||
g_return_if_fail (GTK_CONTAINER (container));
|
||
|
||
if (priv->restyle_pending)
|
||
return;
|
||
|
||
priv->restyle_pending = TRUE;
|
||
gtk_container_start_idle_sizer (container);
|
||
}
|
||
|
||
static GtkSizeRequestMode
|
||
gtk_container_get_request_mode (GtkWidget *widget)
|
||
{
|
||
GtkWidget *w;
|
||
int wfh = 0, hfw = 0;
|
||
|
||
for (w = gtk_widget_get_first_child (widget);
|
||
w != NULL;
|
||
w = gtk_widget_get_next_sibling (w))
|
||
{
|
||
GtkSizeRequestMode mode = gtk_widget_get_request_mode (w);
|
||
|
||
switch (mode)
|
||
{
|
||
case GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH:
|
||
hfw ++;
|
||
break;
|
||
case GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT:
|
||
wfh ++;
|
||
break;
|
||
case GTK_SIZE_REQUEST_CONSTANT_SIZE:
|
||
default:
|
||
break;
|
||
}
|
||
}
|
||
|
||
if (hfw == 0 && wfh == 0)
|
||
return GTK_SIZE_REQUEST_CONSTANT_SIZE;
|
||
else
|
||
return wfh > hfw ?
|
||
GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT :
|
||
GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH;
|
||
}
|
||
|
||
/**
|
||
* gtk_container_forall: (virtual forall)
|
||
* @container: a #GtkContainer
|
||
* @callback: (scope call) (closure callback_data): a callback
|
||
* @callback_data: callback user data
|
||
*
|
||
* Invokes @callback on each direct child of @container, including
|
||
* children that are considered “internal” (implementation details
|
||
* of the container). “Internal” children generally weren’t added
|
||
* by the user of the container, but were added by the container
|
||
* implementation itself.
|
||
*
|
||
* Most applications should use gtk_container_foreach(), rather
|
||
* than gtk_container_forall().
|
||
**/
|
||
void
|
||
gtk_container_forall (GtkContainer *container,
|
||
GtkCallback callback,
|
||
gpointer callback_data)
|
||
{
|
||
g_return_if_fail (GTK_IS_CONTAINER (container));
|
||
g_return_if_fail (callback != NULL);
|
||
|
||
gtk_widget_forall (GTK_WIDGET (container),
|
||
callback,
|
||
callback_data);
|
||
}
|
||
|
||
/**
|
||
* gtk_container_foreach:
|
||
* @container: a #GtkContainer
|
||
* @callback: (scope call): a callback
|
||
* @callback_data: callback user data
|
||
*
|
||
* Invokes @callback on each non-internal child of @container.
|
||
* See gtk_container_forall() for details on what constitutes
|
||
* an “internal” child. For all practical purposes, this function
|
||
* should iterate over precisely those child widgets that were
|
||
* added to the container by the application with explicit add()
|
||
* calls.
|
||
*
|
||
* It is permissible to remove the child from the @callback handler.
|
||
*
|
||
* Most applications should use gtk_container_foreach(),
|
||
* rather than gtk_container_forall().
|
||
**/
|
||
void
|
||
gtk_container_foreach (GtkContainer *container,
|
||
GtkCallback callback,
|
||
gpointer callback_data)
|
||
{
|
||
GtkContainerClass *class;
|
||
|
||
g_return_if_fail (GTK_IS_CONTAINER (container));
|
||
g_return_if_fail (callback != NULL);
|
||
|
||
class = GTK_CONTAINER_GET_CLASS (container);
|
||
|
||
if (class->forall)
|
||
class->forall (container, callback, callback_data);
|
||
}
|
||
|
||
/**
|
||
* gtk_container_set_focus_child:
|
||
* @container: a #GtkContainer
|
||
* @child: (allow-none): a #GtkWidget, or %NULL
|
||
*
|
||
* Sets, or unsets if @child is %NULL, the focused child of @container.
|
||
*
|
||
* This function emits the GtkContainer::set_focus_child signal of
|
||
* @container. Implementations of #GtkContainer can override the
|
||
* default behaviour by overriding the class closure of this signal.
|
||
*
|
||
* This is function is mostly meant to be used by widgets. Applications can use
|
||
* gtk_widget_grab_focus() to manually set the focus to a specific widget.
|
||
*/
|
||
void
|
||
gtk_container_set_focus_child (GtkContainer *container,
|
||
GtkWidget *child)
|
||
{
|
||
g_return_if_fail (GTK_IS_CONTAINER (container));
|
||
if (child)
|
||
g_return_if_fail (GTK_IS_WIDGET (child));
|
||
|
||
GTK_CONTAINER_GET_CLASS (container)->set_focus_child (container, child);
|
||
}
|
||
|
||
/**
|
||
* gtk_container_get_children:
|
||
* @container: a #GtkContainer
|
||
*
|
||
* Returns the container’s non-internal children. See
|
||
* gtk_container_forall() for details on what constitutes an "internal" child.
|
||
*
|
||
* Returns: (element-type GtkWidget) (transfer container): a newly-allocated list of the container’s non-internal children.
|
||
**/
|
||
GList*
|
||
gtk_container_get_children (GtkContainer *container)
|
||
{
|
||
GList *children = NULL;
|
||
|
||
gtk_container_foreach (container,
|
||
gtk_container_children_callback,
|
||
&children);
|
||
|
||
return g_list_reverse (children);
|
||
}
|
||
|
||
static void
|
||
gtk_container_compute_expand (GtkWidget *widget,
|
||
gboolean *hexpand_p,
|
||
gboolean *vexpand_p)
|
||
{
|
||
GtkWidget *w;
|
||
gboolean hexpand = FALSE;
|
||
gboolean vexpand = FALSE;
|
||
|
||
for (w = gtk_widget_get_first_child (widget);
|
||
w != NULL;
|
||
w = gtk_widget_get_next_sibling (w))
|
||
{
|
||
/* note that we don't get_expand on the child if we already know we
|
||
* have to expand, so we only recurse into children until we find
|
||
* one that expands and then we basically don't do any more
|
||
* work. This means that we can leave some children in a
|
||
* need_compute_expand state, which is fine, as long as GtkWidget
|
||
* doesn't rely on an invariant that "if a child has
|
||
* need_compute_expand, its parents also do"
|
||
*
|
||
* gtk_widget_compute_expand() always returns FALSE if the
|
||
* child is !visible so that's taken care of.
|
||
*/
|
||
hexpand = hexpand || gtk_widget_compute_expand (w, GTK_ORIENTATION_HORIZONTAL);
|
||
vexpand = vexpand || gtk_widget_compute_expand (w, GTK_ORIENTATION_VERTICAL);
|
||
}
|
||
|
||
*hexpand_p = hexpand;
|
||
*vexpand_p = vexpand;
|
||
}
|
||
|
||
static void
|
||
gtk_container_real_set_focus_child (GtkContainer *container,
|
||
GtkWidget *focus_child)
|
||
{
|
||
g_return_if_fail (GTK_IS_CONTAINER (container));
|
||
g_return_if_fail (focus_child == NULL || GTK_IS_WIDGET (focus_child));
|
||
|
||
/* Check for h/v adjustments and scroll to show the focus child if possible */
|
||
if (focus_child)
|
||
{
|
||
GtkAdjustment *hadj;
|
||
GtkAdjustment *vadj;
|
||
gint x, y;
|
||
|
||
hadj = g_object_get_qdata (G_OBJECT (container), hadjustment_key_id);
|
||
vadj = g_object_get_qdata (G_OBJECT (container), vadjustment_key_id);
|
||
if (hadj || vadj)
|
||
{
|
||
GtkWidget *child = focus_child;
|
||
graphene_rect_t child_bounds;
|
||
|
||
while (gtk_widget_get_focus_child (child))
|
||
child = gtk_widget_get_focus_child (child);
|
||
|
||
if (!gtk_widget_translate_coordinates (child, focus_child,
|
||
0, 0, &x, &y))
|
||
return;
|
||
|
||
if (!gtk_widget_compute_bounds (child, child, &child_bounds))
|
||
return;
|
||
|
||
if (vadj)
|
||
gtk_adjustment_clamp_page (vadj, y, y + child_bounds.size.height);
|
||
|
||
if (hadj)
|
||
gtk_adjustment_clamp_page (hadj, x, x + child_bounds.size.width);
|
||
}
|
||
}
|
||
}
|
||
|
||
static GtkWidgetPath *
|
||
gtk_container_real_get_path_for_child (GtkContainer *container,
|
||
GtkWidget *child)
|
||
{
|
||
GtkWidgetPath *path;
|
||
GtkWidget *widget = GTK_WIDGET (container);
|
||
|
||
path = _gtk_widget_create_path (widget);
|
||
|
||
gtk_widget_path_append_for_widget (path, child);
|
||
|
||
return path;
|
||
}
|
||
|
||
static void
|
||
gtk_container_children_callback (GtkWidget *widget,
|
||
gpointer client_data)
|
||
{
|
||
GList **children;
|
||
|
||
children = (GList**) client_data;
|
||
*children = g_list_prepend (*children, widget);
|
||
}
|
||
|
||
/**
|
||
* gtk_container_set_focus_vadjustment:
|
||
* @container: a #GtkContainer
|
||
* @adjustment: an adjustment which should be adjusted when the focus
|
||
* is moved among the descendents of @container
|
||
*
|
||
* Hooks up an adjustment to focus handling in a container, so when a
|
||
* child of the container is focused, the adjustment is scrolled to
|
||
* show that widget. This function sets the vertical alignment. See
|
||
* gtk_scrolled_window_get_vadjustment() for a typical way of obtaining
|
||
* the adjustment and gtk_container_set_focus_hadjustment() for setting
|
||
* the horizontal adjustment.
|
||
*
|
||
* The adjustments have to be in pixel units and in the same coordinate
|
||
* system as the allocation for immediate children of the container.
|
||
*/
|
||
void
|
||
gtk_container_set_focus_vadjustment (GtkContainer *container,
|
||
GtkAdjustment *adjustment)
|
||
{
|
||
g_return_if_fail (GTK_IS_CONTAINER (container));
|
||
if (adjustment)
|
||
g_return_if_fail (GTK_IS_ADJUSTMENT (adjustment));
|
||
|
||
if (adjustment)
|
||
g_object_ref (adjustment);
|
||
|
||
g_object_set_qdata_full (G_OBJECT (container),
|
||
vadjustment_key_id,
|
||
adjustment,
|
||
g_object_unref);
|
||
}
|
||
|
||
/**
|
||
* gtk_container_get_focus_vadjustment:
|
||
* @container: a #GtkContainer
|
||
*
|
||
* Retrieves the vertical focus adjustment for the container. See
|
||
* gtk_container_set_focus_vadjustment().
|
||
*
|
||
* Returns: (nullable) (transfer none): the vertical focus adjustment, or
|
||
* %NULL if none has been set.
|
||
**/
|
||
GtkAdjustment *
|
||
gtk_container_get_focus_vadjustment (GtkContainer *container)
|
||
{
|
||
GtkAdjustment *vadjustment;
|
||
|
||
g_return_val_if_fail (GTK_IS_CONTAINER (container), NULL);
|
||
|
||
vadjustment = g_object_get_qdata (G_OBJECT (container), vadjustment_key_id);
|
||
|
||
return vadjustment;
|
||
}
|
||
|
||
/**
|
||
* gtk_container_set_focus_hadjustment:
|
||
* @container: a #GtkContainer
|
||
* @adjustment: an adjustment which should be adjusted when the focus is
|
||
* moved among the descendents of @container
|
||
*
|
||
* Hooks up an adjustment to focus handling in a container, so when a child
|
||
* of the container is focused, the adjustment is scrolled to show that
|
||
* widget. This function sets the horizontal alignment.
|
||
* See gtk_scrolled_window_get_hadjustment() for a typical way of obtaining
|
||
* the adjustment and gtk_container_set_focus_vadjustment() for setting
|
||
* the vertical adjustment.
|
||
*
|
||
* The adjustments have to be in pixel units and in the same coordinate
|
||
* system as the allocation for immediate children of the container.
|
||
*/
|
||
void
|
||
gtk_container_set_focus_hadjustment (GtkContainer *container,
|
||
GtkAdjustment *adjustment)
|
||
{
|
||
g_return_if_fail (GTK_IS_CONTAINER (container));
|
||
if (adjustment)
|
||
g_return_if_fail (GTK_IS_ADJUSTMENT (adjustment));
|
||
|
||
if (adjustment)
|
||
g_object_ref (adjustment);
|
||
|
||
g_object_set_qdata_full (G_OBJECT (container),
|
||
hadjustment_key_id,
|
||
adjustment,
|
||
g_object_unref);
|
||
}
|
||
|
||
/**
|
||
* gtk_container_get_focus_hadjustment:
|
||
* @container: a #GtkContainer
|
||
*
|
||
* Retrieves the horizontal focus adjustment for the container. See
|
||
* gtk_container_set_focus_hadjustment ().
|
||
*
|
||
* Returns: (nullable) (transfer none): the horizontal focus adjustment, or %NULL if
|
||
* none has been set.
|
||
**/
|
||
GtkAdjustment *
|
||
gtk_container_get_focus_hadjustment (GtkContainer *container)
|
||
{
|
||
GtkAdjustment *hadjustment;
|
||
|
||
g_return_val_if_fail (GTK_IS_CONTAINER (container), NULL);
|
||
|
||
hadjustment = g_object_get_qdata (G_OBJECT (container), hadjustment_key_id);
|
||
|
||
return hadjustment;
|
||
}
|
||
|
||
/**
|
||
* gtk_container_get_path_for_child:
|
||
* @container: a #GtkContainer
|
||
* @child: a child of @container
|
||
*
|
||
* Returns a newly created widget path representing all the widget hierarchy
|
||
* from the toplevel down to and including @child.
|
||
*
|
||
* Returns: A newly created #GtkWidgetPath
|
||
**/
|
||
GtkWidgetPath *
|
||
gtk_container_get_path_for_child (GtkContainer *container,
|
||
GtkWidget *child)
|
||
{
|
||
GtkWidgetPath *path;
|
||
|
||
g_return_val_if_fail (GTK_IS_CONTAINER (container), NULL);
|
||
g_return_val_if_fail (GTK_IS_WIDGET (child), NULL);
|
||
g_return_val_if_fail (container == (GtkContainer *) _gtk_widget_get_parent (child), NULL);
|
||
|
||
path = GTK_CONTAINER_GET_CLASS (container)->get_path_for_child (container, child);
|
||
if (gtk_widget_path_get_object_type (path) != G_OBJECT_TYPE (child))
|
||
{
|
||
g_critical ("%s %p returned a widget path for type %s, but child is %s",
|
||
G_OBJECT_TYPE_NAME (container),
|
||
container,
|
||
g_type_name (gtk_widget_path_get_object_type (path)),
|
||
G_OBJECT_TYPE_NAME (child));
|
||
}
|
||
|
||
return path;
|
||
}
|