/* gtkoverlaylayout.c: Overlay layout manager
*
* SPDX-License-Identifier: LGPL-2.1-or-later
*
* Copyright 2019 Red Hat, Inc.
*
* 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 .
*/
#include "config.h"
#include "gtkoverlaylayout.h"
#include "gtkintl.h"
#include "gtklayoutchild.h"
#include "gtkoverlay.h"
#include "gtkprivate.h"
#include "gtkwidgetprivate.h"
#include
/**
* SECTION:gtkoverlaylayout
* @Title: GtkOverlayLayout
* @Short_description: Layout manager that places widgets as overlays
*
* GtkOverlayLayout is the layout manager used by #GtkOverlay.
* It places widgets as overlays on top of the main child.
*
* This is not a reusable layout manager, since it expects its widget
* to be a #GtkOverlay. It only listed here so that its layout
* properties get documented.
*/
struct _GtkOverlayLayout
{
GtkLayoutManager parent_instance;
};
struct _GtkOverlayLayoutChild
{
GtkLayoutChild parent_instance;
guint measure : 1;
guint clip_overlay : 1;
};
enum
{
PROP_MEASURE = 1,
PROP_CLIP_OVERLAY,
N_CHILD_PROPERTIES
};
static GParamSpec *child_props[N_CHILD_PROPERTIES];
G_DEFINE_TYPE (GtkOverlayLayoutChild, gtk_overlay_layout_child, GTK_TYPE_LAYOUT_CHILD)
static void
gtk_overlay_layout_child_set_property (GObject *gobject,
guint prop_id,
const GValue *value,
GParamSpec *pspec)
{
GtkOverlayLayoutChild *self = GTK_OVERLAY_LAYOUT_CHILD (gobject);
switch (prop_id)
{
case PROP_MEASURE:
gtk_overlay_layout_child_set_measure (self, g_value_get_boolean (value));
break;
case PROP_CLIP_OVERLAY:
gtk_overlay_layout_child_set_clip_overlay (self, g_value_get_boolean (value));
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
break;
}
}
static void
gtk_overlay_layout_child_get_property (GObject *gobject,
guint prop_id,
GValue *value,
GParamSpec *pspec)
{
GtkOverlayLayoutChild *self = GTK_OVERLAY_LAYOUT_CHILD (gobject);
switch (prop_id)
{
case PROP_MEASURE:
g_value_set_boolean (value, self->measure);
break;
case PROP_CLIP_OVERLAY:
g_value_set_boolean (value, self->clip_overlay);
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
break;
}
}
static void
gtk_overlay_layout_child_class_init (GtkOverlayLayoutChildClass *klass)
{
GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
gobject_class->set_property = gtk_overlay_layout_child_set_property;
gobject_class->get_property = gtk_overlay_layout_child_get_property;
/**
* GtkOverlayLayoutChild:measure:
*
* Whether the child size should contribute to the #GtkOverlayLayout's
* measurement.
*/
child_props[PROP_MEASURE] =
g_param_spec_boolean ("measure",
P_("Measure"),
P_("Include in size measurement"),
FALSE,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkOverlayLayoutChild:clip-overlay:
*
* Whether the child should be clipped to fit the parent's size.
*/
child_props[PROP_CLIP_OVERLAY] =
g_param_spec_boolean ("clip-overlay",
P_("Clip Overlay"),
P_("Clip the overlay child widget so as to fit the parent"),
FALSE,
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
g_object_class_install_properties (gobject_class, N_CHILD_PROPERTIES, child_props);
}
static void
gtk_overlay_layout_child_init (GtkOverlayLayoutChild *self)
{
}
/**
* gtk_overlay_layout_child_set_measure:
* @child: a #GtkOverlayLayoutChild
* @measure: whether to measure this child
*
* Sets whether to measure this child.
*/
void
gtk_overlay_layout_child_set_measure (GtkOverlayLayoutChild *child,
gboolean measure)
{
GtkLayoutManager *layout;
g_return_if_fail (GTK_IS_OVERLAY_LAYOUT_CHILD (child));
if (child->measure == measure)
return;
child->measure = measure;
layout = gtk_layout_child_get_layout_manager (GTK_LAYOUT_CHILD (child));
gtk_layout_manager_layout_changed (layout);
g_object_notify_by_pspec (G_OBJECT (child), child_props[PROP_MEASURE]);
}
/**
* gtk_overlay_layout_child_get_measure:
* @child: a #GtkOverlayLayoutChild
*
* Retrieves whether the child is measured.
*
* Returns: whether the child is measured
*/
gboolean
gtk_overlay_layout_child_get_measure (GtkOverlayLayoutChild *child)
{
g_return_val_if_fail (GTK_IS_OVERLAY_LAYOUT_CHILD (child), FALSE);
return child->measure;
}
/**
* gtk_overlay_layout_child_set_clip_overlay:
* @child: a #GtkOverlayLayoutChild
* @clip_overlay: whether to clip this child
*
* Sets whether to clip this child.
*/
void
gtk_overlay_layout_child_set_clip_overlay (GtkOverlayLayoutChild *child,
gboolean clip_overlay)
{
GtkLayoutManager *layout;
g_return_if_fail (GTK_IS_OVERLAY_LAYOUT_CHILD (child));
if (child->clip_overlay == clip_overlay)
return;
child->clip_overlay = clip_overlay;
layout = gtk_layout_child_get_layout_manager (GTK_LAYOUT_CHILD (child));
gtk_layout_manager_layout_changed (layout);
g_object_notify_by_pspec (G_OBJECT (child), child_props[PROP_CLIP_OVERLAY]);
}
/**
* gtk_overlay_layout_child_get_clip_overlay:
* @child: a #GtkOverlayLayoutChild
*
* Retrieves whether the child is clipped.
*
* Returns: whether the child is clipped
*/
gboolean
gtk_overlay_layout_child_get_clip_overlay (GtkOverlayLayoutChild *child)
{
g_return_val_if_fail (GTK_IS_OVERLAY_LAYOUT_CHILD (child), FALSE);
return child->clip_overlay;
}
G_DEFINE_TYPE (GtkOverlayLayout, gtk_overlay_layout, GTK_TYPE_LAYOUT_MANAGER)
static void
gtk_overlay_layout_measure (GtkLayoutManager *layout_manager,
GtkWidget *widget,
GtkOrientation orientation,
int for_size,
int *minimum,
int *natural,
int *minimum_baseline,
int *natural_baseline)
{
GtkOverlayLayoutChild *child_info;
GtkWidget *child;
int min, nat;
GtkWidget *main_widget;
main_widget = gtk_overlay_get_child (GTK_OVERLAY (widget));
min = 0;
nat = 0;
for (child = _gtk_widget_get_first_child (widget);
child != NULL;
child = _gtk_widget_get_next_sibling (child))
{
if (!gtk_widget_should_layout (child))
continue;
child_info = GTK_OVERLAY_LAYOUT_CHILD (gtk_layout_manager_get_layout_child (layout_manager, child));
if (child == main_widget || child_info->measure)
{
int child_min, child_nat, child_min_baseline, child_nat_baseline;
gtk_widget_measure (child,
orientation,
for_size,
&child_min, &child_nat,
&child_min_baseline, &child_nat_baseline);
min = MAX (min, child_min);
nat = MAX (nat, child_nat);
}
}
if (minimum != NULL)
*minimum = min;
if (natural != NULL)
*natural = nat;
}
static void
gtk_overlay_compute_child_allocation (GtkOverlay *overlay,
GtkWidget *widget,
GtkOverlayLayoutChild *child,
GtkAllocation *widget_allocation)
{
GtkAllocation allocation;
gboolean result;
g_signal_emit_by_name (overlay, "get-child-position",
widget, &allocation, &result);
widget_allocation->x = allocation.x;
widget_allocation->y = allocation.y;
widget_allocation->width = allocation.width;
widget_allocation->height = allocation.height;
}
static GtkAlign
effective_align (GtkAlign align,
GtkTextDirection direction)
{
switch (align)
{
case GTK_ALIGN_START:
return direction == GTK_TEXT_DIR_RTL ? GTK_ALIGN_END : GTK_ALIGN_START;
case GTK_ALIGN_END:
return direction == GTK_TEXT_DIR_RTL ? GTK_ALIGN_START : GTK_ALIGN_END;
case GTK_ALIGN_FILL:
case GTK_ALIGN_CENTER:
case GTK_ALIGN_BASELINE:
default:
return align;
}
}
static void
gtk_overlay_child_update_style_classes (GtkOverlay *overlay,
GtkWidget *child,
GtkAllocation *child_allocation)
{
GtkWidget *widget = GTK_WIDGET (overlay);
int width, height;
GtkAlign valign, halign;
gboolean is_left, is_right, is_top, is_bottom;
gboolean has_left, has_right, has_top, has_bottom;
has_left = gtk_widget_has_css_class (widget, "left");
has_right = gtk_widget_has_css_class (widget, "right");
has_top = gtk_widget_has_css_class (widget, "top");
has_bottom = gtk_widget_has_css_class (widget, "bottom");
is_left = is_right = is_top = is_bottom = FALSE;
width = gtk_widget_get_width (widget);
height = gtk_widget_get_height (widget);
halign = effective_align (gtk_widget_get_halign (child),
gtk_widget_get_direction (child));
if (halign == GTK_ALIGN_START)
is_left = (child_allocation->x == 0);
else if (halign == GTK_ALIGN_END)
is_right = (child_allocation->x + child_allocation->width == width);
valign = gtk_widget_get_valign (child);
if (valign == GTK_ALIGN_START)
is_top = (child_allocation->y == 0);
else if (valign == GTK_ALIGN_END)
is_bottom = (child_allocation->y + child_allocation->height == height);
if (has_left && !is_left)
gtk_widget_remove_css_class (widget, "left");
else if (!has_left && is_left)
gtk_widget_add_css_class (widget, "left");
if (has_right && !is_right)
gtk_widget_remove_css_class (widget, "right");
else if (!has_right && is_right)
gtk_widget_add_css_class (widget, "right");
if (has_top && !is_top)
gtk_widget_remove_css_class (widget, "top");
else if (!has_top && is_top)
gtk_widget_add_css_class (widget, "top");
if (has_bottom && !is_bottom)
gtk_widget_remove_css_class (widget, "bottom");
else if (!has_bottom && is_bottom)
gtk_widget_add_css_class (widget, "bottom");
}
static void
gtk_overlay_child_allocate (GtkOverlay *overlay,
GtkWidget *widget,
GtkOverlayLayoutChild *child)
{
GtkAllocation child_allocation;
if (!gtk_widget_should_layout (widget))
return;
gtk_overlay_compute_child_allocation (overlay, widget, child, &child_allocation);
gtk_overlay_child_update_style_classes (overlay, widget, &child_allocation);
gtk_widget_size_allocate (widget, &child_allocation, -1);
}
static void
gtk_overlay_layout_allocate (GtkLayoutManager *layout_manager,
GtkWidget *widget,
int width,
int height,
int baseline)
{
GtkWidget *child;
GtkWidget *main_widget;
main_widget = gtk_overlay_get_child (GTK_OVERLAY (widget));
if (main_widget && gtk_widget_get_visible (main_widget))
gtk_widget_size_allocate (main_widget,
&(GtkAllocation) { 0, 0, width, height },
-1);
for (child = _gtk_widget_get_first_child (widget);
child != NULL;
child = _gtk_widget_get_next_sibling (child))
{
if (child != main_widget)
{
GtkOverlayLayoutChild *child_data;
child_data = GTK_OVERLAY_LAYOUT_CHILD (gtk_layout_manager_get_layout_child (layout_manager, child));
gtk_overlay_child_allocate (GTK_OVERLAY (widget), child, child_data);
}
}
}
static GtkLayoutChild *
gtk_overlay_layout_create_layout_child (GtkLayoutManager *manager,
GtkWidget *widget,
GtkWidget *for_child)
{
return g_object_new (GTK_TYPE_OVERLAY_LAYOUT_CHILD,
"layout-manager", manager,
"child-widget", for_child,
NULL);
}
static void
gtk_overlay_layout_class_init (GtkOverlayLayoutClass *klass)
{
GtkLayoutManagerClass *layout_class = GTK_LAYOUT_MANAGER_CLASS (klass);
layout_class->measure = gtk_overlay_layout_measure;
layout_class->allocate = gtk_overlay_layout_allocate;
layout_class->create_layout_child = gtk_overlay_layout_create_layout_child;
}
static void
gtk_overlay_layout_init (GtkOverlayLayout *self)
{
}
/**
* gtk_overlay_layout_new:
*
* Creates a new #GtkOverlayLayout instance.
*
* Returns: the newly created instance
*/
GtkLayoutManager *
gtk_overlay_layout_new (void)
{
return g_object_new (GTK_TYPE_OVERLAY_LAYOUT, NULL);
}