From: Matthias Clasen <mclasen@redhat.com>
Date: Fri, 28 Apr 2023 19:18:13 +0000 (-0400)
Subject: Add gtk_widget_get_baseline
X-Git-Tag: archive/raspbian/4.12.3+ds-1+rpi1~1^2^2^2~22^2~1^2~347^2~2
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=3ea289751db4b2b6afc160151cf91431dd38d620;p=gtk4.git

Add gtk_widget_get_baseline

This is just a renaming of gtk_widget_get_allocated_baseline
that fits better with gtk_widget_get_width/height.
---

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 20bb2eba25..dc9cb14cf3 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -241,7 +241,7 @@
  *
  * If a widget ends up baseline aligned it will be allocated all the space in
  * the parent as if it was %GTK_ALIGN_FILL, but the selected baseline can be
- * found via [id@gtk_widget_get_allocated_baseline]. If the baseline has a
+ * found via [id@gtk_widget_get_baseline]. If the baseline has a
  * value other than -1 you need to align the widget such that the baseline
  * appears at the position.
  *
@@ -10479,6 +10479,26 @@ gtk_widget_get_allocated_height (GtkWidget *widget)
  */
 int
 gtk_widget_get_allocated_baseline (GtkWidget *widget)
+{
+  return gtk_widget_get_baseline (widget);
+}
+
+/**
+ * gtk_widget_get_baseline:
+ * @widget: the widget to query
+ *
+ * Returns the baseline that has currently been allocated to @widget.
+ *
+ * This function is intended to be used when implementing handlers
+ * for the `GtkWidget`Class.snapshot() function, and when allocating
+ * child widgets in `GtkWidget`Class.size_allocate().
+ *
+ * Returns: the baseline of the @widget, or -1 if none
+ *
+ * Since: 4.12
+ */
+int
+gtk_widget_get_baseline (GtkWidget *widget)
 {
   GtkWidgetPrivate *priv = gtk_widget_get_instance_private (widget);
   GtkCssStyle *style;
diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index 7b39d83901..70ddb1b91a 100644
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -497,6 +497,8 @@ GDK_AVAILABLE_IN_ALL
 int                   gtk_widget_get_width              (GtkWidget     *widget);
 GDK_AVAILABLE_IN_ALL
 int                   gtk_widget_get_height             (GtkWidget     *widget);
+GDK_AVAILABLE_IN_4_12
+int                   gtk_widget_get_baseline           (GtkWidget     *widget);
 GDK_AVAILABLE_IN_ALL
 int                   gtk_widget_get_size               (GtkWidget     *widget,
                                                          GtkOrientation orientation);