[gtk/wip/layout-manager: 134/136] WIP: GtkGridLayout
- From: Emmanuele Bassi <ebassi src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk/wip/layout-manager: 134/136] WIP: GtkGridLayout
- Date: Wed, 20 Mar 2019 15:45:00 +0000 (UTC)
commit 354fb0cdc3950d6acca8903a452b928496e5b691
Author: Emmanuele Bassi <ebassi gnome org>
Date: Tue Feb 5 14:14:14 2019 +0100
WIP: GtkGridLayout
gtk/gtkgridlayout.c | 334 +++++++++++++++++++++++++++++++++++++++++++++
gtk/gtkgridlayout.h | 66 +++++++++
gtk/gtkgridlayoutchild.c | 175 ++++++++++++++++++++++++
gtk/gtkgridlayoutprivate.h | 27 ++++
4 files changed, 602 insertions(+)
---
diff --git a/gtk/gtkgridlayout.c b/gtk/gtkgridlayout.c
new file mode 100644
index 0000000000..38641643f3
--- /dev/null
+++ b/gtk/gtkgridlayout.c
@@ -0,0 +1,334 @@
+#include "config.h"
+
+#include "gtkgridlayoutprivate.h"
+
+#include "gtkcsspositionvalueprivate.h"
+#include "gtkenums.h"
+#include "gtkintl.h"
+#include "gtkorientableprivate.h"
+#include "gtkprivate.h"
+#include "gtksizerequest.h"
+#include "gtkstylecontextprivate.h"
+#include "gtkwidgetprivate.h"
+
+#include <string.h>
+
+/**
+ * SECTION:gtkgridlayout
+ * @Short_description: Pack widgets in rows and columns
+ * @Title: GtkGridLayout
+ * @See_also: #GtkBoxLayout
+ *
+ * GtkGridLayout is a layout manager which arranges its child widgets in
+ * rows and columns, with arbitrary positions and horizontal/vertical spans.
+ *
+ * Children can span multiple rows or columns. The behaviour of GtkGridLayout
+ * when several children occupy the same grid cell is undefined.
+ *
+ * If you do not specify the attach points for each widget, GtkGridLayout
+ * behaves like a #GtkBoxLayout, and will lay out children in a single row
+ * or column, using the the #GtkOrientable:orientation property. However, if
+ * all you want is a single row or column, then #GtkBoxLayout is the preferred
+ * layout manager.
+ */
+
+typedef struct _GridRowProperties GridRowProperties;
+typedef struct _GridLineData GridLineData;
+typedef struct _GridLine GridLine;
+typedef struct _GridLines GridLines;
+
+struct _GridRowProperties
+{
+ int row;
+ GtkBaselinePosition baseline_position;
+};
+
+/* A GtkGridLineData struct contains row/column specific parts
+ * of the grid.
+ */
+struct _GridLineData
+{
+ gint16 spacing;
+ guint homogeneous : 1;
+};
+
+#define ROWS(layout) (&(layout)->linedata[GTK_ORIENTATION_HORIZONTAL])
+#define COLUMNS(layout) (&(layout)->linedata[GTK_ORIENTATION_VERTICAL])
+
+/* A GridLine struct represents a single row or column
+ * during size requests
+ */
+struct _GridLine
+{
+ int minimum;
+ int natural;
+ int minimum_above;
+ int minimum_below;
+ int natural_above;
+ int natural_below;
+
+ int position;
+ int allocation;
+ int allocated_baseline;
+
+ guint need_expand : 1;
+ guint expand : 1;
+ guint empty : 1;
+};
+
+struct _GridLines
+{
+ GridLine *lines;
+ int min, max;
+};
+
+struct _GtkGridRequest
+{
+ GtkGridLayout *grid;
+
+ GridLines lines[2];
+};
+
+struct _GtkGridLayout
+{
+ GtkLayoutManager parent_instance;
+
+ GList *row_properties;
+
+ GtkOrientation orientation;
+ int baseline_row;
+
+ GridLineData linedata[2];
+};
+
+enum
+{
+ PROP_ROW_SPACING = 1,
+ PROP_COLUMN_SPACING,
+ PROP_ROW_HOMOGENEOUS,
+ PROP_COLUMN_HOMOGENEOUS,
+ PROP_BASELINE_ROW,
+
+ N_PROPERTIES,
+
+ /* from GtkOrientable */
+ PROP_ORIENTATION
+};
+
+static const GridRowProperties grid_row_properties_default = {
+ 0,
+ GTK_BASELINE_POSITION_CENTER
+};
+
+static GParamSpec *grid_layout_props[N_PROPERTIES];
+
+G_DEFINE_TYPE_WITH_CODE (GtkGridLayout, gtk_grid_layout, GTK_TYPE_LAYOUT_MANAGER,
+ G_IMPLEMENT_INTERFACE (GTK_TYPE_ORIENTABLE, NULL))
+
+static void
+gtk_grid_layout_create_layout_child (GtkLayoutManager *manager,
+ GtkWidget *child)
+{
+ return g_object_new (GTK_TYPE_GRID_LAYOUT_CHILD,
+ "layout-manager", manager,
+ "child-widget", child,
+ NULL);
+}
+
+static void
+gtk_grid_layout_finalize (GObject *gobject)
+{
+ G_OBJECT_CLASS (gtk_grid_layout_parent_class)->finalize (gobject);
+}
+
+static void
+gtk_grid_layout_get_property (GObject *gobject,
+ guint prop_id,
+ GValue *value,
+ GParamSpec *pspec)
+{
+ GtkGridLayout *self = GTK_GRID_LAYOUT (gobject);
+
+ switch (prop_id)
+ {
+ case PROP_ORIENTATION:
+ g_value_set_enum (value, self->orientation);
+ break;
+
+ case PROP_ROW_SPACING:
+ g_value_set_int (value, COLUMNS (self)->spacing);
+ break;
+
+ case PROP_COLUMN_SPACING:
+ g_value_set_int (value, ROWS (self)->spacing);
+ break;
+
+ case PROP_ROW_HOMOGENEOUS:
+ g_value_set_boolean (value, COLUMNS (self)->homogeneous);
+ break;
+
+ case PROP_COLUMN_HOMOGENEOUS:
+ g_value_set_boolean (value, ROWS (self)->homogeneous);
+ break;
+
+ case PROP_BASELINE_ROW:
+ g_value_set_int (value, self->baseline_row);
+ break;
+
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
+ break;
+ }
+}
+
+static void
+gtk_grid_layout_set_orientation (GtkGridLayout *self,
+ GtkOrientation orientation)
+{
+ GtkLayoutManager *layout_manager = GTK_LAYOUT_MANAGER (self);
+ GtkWidget *widget;
+
+ if (self->orientation == orientation)
+ return;
+
+ self->orientation = orientation;
+
+ widget = gtk_layout_manager_get_widget (GTK_LAYOUT_MANAGER (self));
+ if (widget != NULL && GTK_IS_ORIENTABLE (widget))
+ _gtk_orientable_set_style_classes (GTK_ORIENTABLE (widget));
+
+ gtk_layout_manager_layout_changed (layout_manager);
+}
+
+static void
+gtk_grid_layout_set_property (GObject *gobject,
+ guint prop_id,
+ const GValue *value,
+ GParamSpec *pspec)
+{
+ GtkGridLayout *self = GTK_GRID_LAYOUT (gobject);
+
+ switch (prop_id)
+ {
+ case PROP_ORIENTATION:
+ gtk_grid_layout_set_orientation (self, g_value_get_enum (value));
+ break;
+
+ case PROP_ROW_SPACING:
+ gtk_grid_layout_set_row_spacing (self, g_value_get_int (value));
+ break;
+
+ case PROP_COLUMN_SPACING:
+ gtk_grid_layout_set_column_spacing (self, g_value_get_int (value));
+ break;
+
+ case PROP_ROW_HOMOGENEOUS:
+ gtk_grid_layout_set_row_homogeneous (self, g_value_get_boolean (value));
+ break;
+
+ case PROP_COLUMN_HOMOGENEOUS:
+ gtk_grid_layout_set_column_homogeneous (self, g_value_get_boolean (value));
+ break;
+
+ case PROP_BASELINE_ROW:
+ gtk_grid_layout_set_baseline_row (self, g_value_get_int (value));
+ break;
+
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
+ break;
+ }
+}
+
+static void
+gtk_grid_layout_class_init (GtkGridLayoutClass *klass)
+{
+ GtkLayoutManagerClass *manager_class = GTK_LAYOUT_MANAGER_CLASS (klass);
+ GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
+
+ manager_class->create_layout_child = gtk_grid_layout_create_layout_child;
+
+ gobject_class->set_property = gtk_grid_layout_set_property;
+ gobject_class->get_property = gtk_grid_layout_get_property;
+
+ g_object_class_install_properties (gobject_class, N_PROPERTIES, grid_layout_props);
+}
+
+static void
+gtk_grid_layout_init (GtkGridLayout *self)
+{
+}
+
+GtkLayoutManager *
+gtk_grid_layout_new (void)
+{
+ return g_object_new (GTK_TYPE_GRID_LAYOUT, NULL);
+}
+
+void
+gtk_grid_layout_set_row_homogeneous (GtkGridLayout *grid_layout,
+ gboolean homogeneous)
+{
+}
+
+gboolean
+gtk_grid_layout_get_row_homogeneous (GtkGridLayout *grid_layout)
+{
+}
+
+void
+gtk_grid_layout_set_row_spacing (GtkGridLayout *grid_layout,
+ guint spacing)
+{
+}
+
+guint
+gtk_grid_layout_get_row_spacing (GtkGridLayout *grid_layout)
+{
+}
+
+void
+gtk_grid_layout_set_column_homogeneous (GtkGridLayout *grid_layout,
+ gboolean homogeneous)
+{
+}
+
+gboolean
+gtk_grid_layout_get_column_homogeneous (GtkGridLayout *grid_layout)
+{
+}
+
+void
+gtk_grid_layout_set_column_spacing (GtkGridLayout *grid_layout,
+ guint spacing)
+{
+}
+
+guint
+gtk_grid_layout_get_column_spacing (GtkGridLayout *grid_layout)
+{
+}
+
+void
+gtk_grid_layout_set_row_baseline_position (GtkGridLayout *grid_layout,
+ int row,
+ GtkBaselinePosition pos)
+{
+}
+
+GtkBaselinePosition
+gtk_grid_layout_get_row_baseline_position (GtkGridLayout *grid_layout,
+ int row)
+{
+}
+
+void
+gtk_grid_layout_set_baseline_row (GtkGridLayout *grid_layout,
+ int row)
+{
+}
+
+int
+gtk_grid_layout_get_baseline_row (GtkGridLayout *grid_layout)
+{
+}
diff --git a/gtk/gtkgridlayout.h b/gtk/gtkgridlayout.h
new file mode 100644
index 0000000000..4fadfd928b
--- /dev/null
+++ b/gtk/gtkgridlayout.h
@@ -0,0 +1,66 @@
+#pragma once
+
+#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
+#error "Only <gtk/gtk.h> can be included directly."
+#endif
+
+#include <gtk/gtklayoutmanager.h>
+
+G_BEGIN_DECLS
+
+#define GTK_TYPE_GRID_LAYOUT (gtk_grid_layout_get_type())
+
+GDK_AVAILABLE_IN_ALL
+G_DECLARE_FINAL_TYPE (GtkGridLayout, gtk_grid_layout, GTK, GRID_LAYOUT, GtkLayoutManager)
+
+GDK_AVAILABLE_IN_ALL
+GtkLayoutManager * gtk_grid_layout_new (void);
+
+GDK_AVAILABLE_IN_ALL
+void gtk_grid_layout_set_row_homogeneous (GtkGridLayout *grid_layout,
+ gboolean homogeneous);
+GDK_AVAILABLE_IN_ALL
+gboolean gtk_grid_layout_get_row_homogeneous (GtkGridLayout *grid_layout);
+GDK_AVAILABLE_IN_ALL
+void gtk_grid_layout_set_row_spacing (GtkGridLayout *grid_layout,
+ guint spacing);
+GDK_AVAILABLE_IN_ALL
+guint gtk_grid_layout_get_row_spacing (GtkGridLayout *grid_layout);
+GDK_AVAILABLE_IN_ALL
+void gtk_grid_layout_set_column_homogeneous (GtkGridLayout *grid_layout,
+ gboolean homogeneous);
+GDK_AVAILABLE_IN_ALL
+gboolean gtk_grid_layout_get_column_homogeneous (GtkGridLayout *grid_layout);
+GDK_AVAILABLE_IN_ALL
+void gtk_grid_layout_set_column_spacing (GtkGridLayout *grid_layout,
+ guint spacing);
+GDK_AVAILABLE_IN_ALL
+guint gtk_grid_layout_get_column_spacing (GtkGridLayout *grid_layout);
+GDK_AVAILABLE_IN_ALL
+void gtk_grid_layout_set_row_baseline_position (GtkGridLayout *grid_layout,
+ int row,
+ GtkBaselinePosition pos);
+GDK_AVAILABLE_IN_ALL
+GtkBaselinePosition gtk_grid_layout_get_row_baseline_position (GtkGridLayout *grid_layout,
+ int row);
+GDK_AVAILABLE_IN_ALL
+void gtk_grid_layout_set_baseline_row (GtkGridLayout *grid_layout,
+ int row);
+GDK_AVAILABLE_IN_ALL
+int gtk_grid_layout_get_baseline_row (GtkGridLayout *grid_layout);
+
+#define GTK_TYPE_GRID_LAYOUT_CHILD (gtk_grid_layout_child_get_type())
+
+GDK_AVAILABLE_IN_ALL
+G_DECLARE_FINAL_TYPE (GtkGridLayoutChild, gtk_grid_layout_child, GTK, GRID_LAYOUT_CHILD, GtkLayoutChild)
+
+GDK_AVAILABLE_IN_ALL
+int gtk_grid_layout_child_get_left_attach (GtkGridLayoutChild *grid_child);
+GDK_AVAILABLE_IN_ALL
+int gtk_grid_layout_child_get_top_attach (GtkGridLayoutChild *grid_child);
+GDK_AVAILABLE_IN_ALL
+int gtk_grid_layout_child_get_width (GtkGridLayoutChild *grid_child);
+GDK_AVAILABLE_IN_ALL
+int gtk_grid_layout_child_get_height (GtkGridLayoutChild *grid_child);
+
+G_END_DECLS
diff --git a/gtk/gtkgridlayoutchild.c b/gtk/gtkgridlayoutchild.c
new file mode 100644
index 0000000000..60d365a3f2
--- /dev/null
+++ b/gtk/gtkgridlayoutchild.c
@@ -0,0 +1,175 @@
+/**
+ * SECTION:gtkgridlayoutchild
+ * @Title: GtkGridLayoutChild
+ * @Short_description: Layout properties for children of GtkGridLayout
+ *
+ * GtkGridLayoutChild is a #GtkLayoutChild class used to store layout
+ * properties that apply to children of a #GtkWidget using the #GtkGridLayout
+ * layout manager.
+ *
+ * You can retrieve a GtkGridLayout instance bound to a #GtkWidget by
+ * using gtk_layout_manager_get_layout_child().
+ */
+
+#include "config.h"
+
+#include "gtkgridlayoutprivate.h"
+
+G_DEFINE_TYPE (GtkGridLayoutChild, gtk_grid_layout_child, GTK_TYPE_LAYOUT_CHILD)
+
+enum {
+ PROP_LEFT_ATTACH = 1,
+ PROP_TOP_ATTACH,
+ PROP_COLUMN_SPAN,
+ PROP_ROW_SPAN,
+
+ N_PROPERTIES
+};
+
+static GParamSpec *layout_child_props[N_PROPERTIES];
+
+static void
+gtk_grid_layout_child_get_property (GObject *gobject,
+ guint property_id,
+ GValue *value,
+ GParamSpec *pspec)
+{
+ GtkGridLayoutChild *self = GTK_GRID_LAYOUT_CHILD (gobject);
+
+ switch (property_id)
+ {
+ case PROP_LEFT_ATTACH:
+ g_value_set_int (value, CHILD_LEFT (grid_child));
+ break;
+
+ case PROP_TOP_ATTACH:
+ g_value_set_int (value, CHILD_TOP (grid_child));
+ break;
+
+ case PROP_COLUMN_SPAN:
+ g_value_set_int (value, CHILD_COL_SPAN (grid_child));
+ break;
+
+ case PROP_ROW_SPAN:
+ g_value_set_int (value, CHILD_ROW_SPAN (grid_child));
+ break;
+
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, property_id, pspec);
+ break;
+ }
+}
+
+static void
+gtk_grid_layout_child_set_property (GObject *gobject,
+ guint property_id,
+ const GValue *value,
+ GParamSpec *pspec)
+{
+ GtkGridLayoutChild *self = GTK_GRID_LAYOUT_CHILD (gobject);
+
+ switch (property_id)
+ {
+ case PROP_LEFT_ATTACH:
+ CHILD_LEFT (grid_child) = g_value_get_int (value);
+ break;
+
+ case PROP_TOP_ATTACH:
+ CHILD_TOP (grid_child) = g_value_get_int (value);
+ break;
+
+ case PROP_COLUMN_SPAN:
+ CHILD_COL_SPAN (grid_child) = g_value_get_int (value);
+ break;
+
+ case PROP_ROW_SPAN:
+ CHILD_ROW_SPAN (grid_child) = g_value_get_int (value);
+ break;
+
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, property_id, pspec);
+ break;
+ }
+
+ gtk_layout_manager_layout_changed (gtk_layout_child_get_layout_manager (GTK_LAYOUT_CHILD (self)));
+}
+
+static void
+gtk_grid_layout_child_class_init (GtkGridLayoutChildClass *klass)
+{
+ GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
+
+ gobject_class->set_property = gtk_grid_layout_child_set_property;
+ gobject_class->get_property = gtk_grid_layout_child_get_property;
+
+ layout_child_props[PROP_LEFT_ATTACH] =
+ g_param_spec_int ("left-attach",
+ P_("Left attachment"),
+ P_("The column number to attach the left side of the child to"),
+ G_MININT, G_MAXINT, 0,
+ GTK_PARAM_READWRITE);
+
+ layout_child_props[PROP_TOP_ATTACH] =
+ g_param_spec_int ("top-attach",
+ P_("Top attachment"),
+ P_("The row number to attach the top side of a child widget to"),
+ G_MININT, G_MAXINT, 0,
+ GTK_PARAM_READWRITE);
+
+ layout_child_props[PROP_COLUMN_SPAN] =
+ g_param_spec_int ("column-span",
+ P_("Column Span"),
+ P_("The number of columns that a child spans"),
+ 1, G_MAXINT, 1,
+ GTK_PARAM_READWRITE);
+
+ layout_child_props[PROP_ROW_SPAN] =
+ g_param_spec_int ("row-span",
+ P_("Row Span"),
+ P_("The number of rows that a child spans"),
+ 1, G_MAXINT, 1,
+ GTK_PARAM_READWRITE);
+
+ g_object_class_install_properties (gobject_class, N_PROPERTIES, layout_child_props);
+}
+
+static void
+gtk_grid_layout_child_init (GtkGridLayoutChild *self)
+{
+ CHILD_LEFT (self) = 0;
+ CHILD_TOP (self) = 0;
+ CHILD_COLUMN_SPAN (self) = 1;
+ CHILD_ROW_SPAN (self) = 1;
+}
+
+int
+gtk_grid_layout_child_get_left_attach (GtkGridLayoutChild *grid_child)
+{
+ g_return_val_if_fail (GTK_IS_GRID_LAYOUT_CHILD (grid_child), 0);
+
+ return CHILD_LEFT (grid_child);
+}
+
+int
+gtk_grid_layout_child_get_top_attach (GtkGridLayoutChild *grid_child)
+{
+ g_return_val_if_fail (GTK_IS_GRID_LAYOUT_CHILD (grid_child), 0);
+
+ return CHILD_TOP (grid_child);
+}
+
+int
+gtk_grid_layout_child_get_width (GtkGridLayoutChild *grid_child)
+{
+ g_return_val_if_fail (GTK_IS_GRID_LAYOUT_CHILD (grid_child), 0);
+
+ return CHILD_WIDTH (grid_child);
+}
+
+int
+gtk_grid_layout_child_get_height (GtkGridLayoutChild *grid_child)
+{
+ g_return_val_if_fail (GTK_IS_GRID_LAYOUT_CHILD (grid_child), 0);
+
+ return CHILD_HEIGHT (grid_child);
+}
diff --git a/gtk/gtkgridlayoutprivate.h b/gtk/gtkgridlayoutprivate.h
new file mode 100644
index 0000000000..31510cd373
--- /dev/null
+++ b/gtk/gtkgridlayoutprivate.h
@@ -0,0 +1,27 @@
+#pragma once
+
+#include "gtkgridlayout.h"
+
+G_BEGIN_DECLS
+
+typedef struct _GtkGridLayoutChildAttach GtkGridLayoutChildAttach;
+
+struct _GtkGridLayoutChildAttach
+{
+ int pos;
+ int span;
+};
+
+struct _GtkGridLayoutChild
+{
+ GtkLayoutChild parent_instance;
+
+ GtkGridLayoutChildAttach attach[2];
+};
+
+#define CHILD_LEFT(child) ((child)->attach[GTK_ORIENTATION_HORIZONTAL].pos)
+#define CHILD_COL_SPAN(child) ((child)->attach[GTK_ORIENTATION_HORIZONTAL].span)
+#define CHILD_TOP(child) ((child)->attach[GTK_ORIENTATION_VERTICAL].pos)
+#define CHILD_ROW_SPAN(child) ((child)->attach[GTK_ORIENTATION_VERTICAL].span)
+
+G_END_DECLS
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]