[gtk/wip/baedert/widget-add-style-class] widget: Add style class API
- From: Timm Bäder <baedert src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk/wip/baedert/widget-add-style-class] widget: Add style class API
- Date: Wed, 29 Jan 2020 08:40:14 +0000 (UTC)
commit a7b34df6af064578c35847e116a980b6267ad383
Author: Timm Bäder <mail baedert org>
Date: Wed Jan 29 08:33:41 2020 +0100
widget: Add style class API
Add GtkWidget API for adding and removing style classes, as well as
checking whether a widget has a style class applied.
Everyone has to go through GtkStyleContext for this these days but with
GtkStyleContext eventually going away, it makse sense for GtkWidget to
have API for this.
docs/reference/gtk/gtk4-sections.txt | 3 ++
gtk/gtkwidget.c | 81 ++++++++++++++++++++++++++++++++++++
gtk/gtkwidget.h | 11 +++++
3 files changed, 95 insertions(+)
---
diff --git a/docs/reference/gtk/gtk4-sections.txt b/docs/reference/gtk/gtk4-sections.txt
index b4a737d2f0..21b08c4037 100644
--- a/docs/reference/gtk/gtk4-sections.txt
+++ b/docs/reference/gtk/gtk4-sections.txt
@@ -4409,6 +4409,9 @@ gtk_widget_insert_after
gtk_widget_set_layout_manager
gtk_widget_get_layout_manager
gtk_widget_should_layout
+gtk_widget_add_style_class
+gtk_widget_remove_style_class
+gtk_widget_has_style_class
<SUBSECTION>
gtk_widget_get_style_context
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index ba4f4b461c..684ed5e141 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -13175,3 +13175,84 @@ gtk_widget_class_query_action (GtkWidgetClass *widget_class,
return FALSE;
}
+
+/**
+ * gtk_widget_add_style_class:
+ * @widget: a #GtkWidget
+ * @style_class: The style class to add to @widget, without
+ * the leading '.' used for notation of style classes
+ *
+ * Adds @style_class to @widget. After calling this function, @widget's
+ * style will match for @style_class, after the CSS matching rules.
+ */
+void
+gtk_widget_add_style_class (GtkWidget *widget,
+ const char *style_class)
+{
+ GtkWidgetPrivate *priv = gtk_widget_get_instance_private (widget);
+
+ g_return_if_fail (GTK_IS_WIDGET (widget));
+ g_return_if_fail (style_class != NULL);
+ g_return_if_fail (style_class[0] != '\0');
+ g_return_if_fail (style_class[0] != '.');
+
+ gtk_css_node_add_class (priv->cssnode, g_quark_from_string (style_class));
+}
+
+/**
+ * gtk_widget_remove_style_class:
+ * @widget: a #GtkWidget
+ * @style_class: The style class to remove from @widget, without
+ * the leading '.' used for notation of style classes
+ *
+ * Removes @style_class from @widget. After this, the style of @widget
+ * will stop matching for @style_class.
+ */
+void
+gtk_widget_remove_style_class (GtkWidget *widget,
+ const char *style_class)
+{
+ GtkWidgetPrivate *priv = gtk_widget_get_instance_private (widget);
+ GQuark class_quark;
+
+ g_return_if_fail (GTK_IS_WIDGET (widget));
+ g_return_if_fail (style_class != NULL);
+ g_return_if_fail (style_class[0] != '\0');
+ g_return_if_fail (style_class[0] != '.');
+
+ class_quark = g_quark_from_string (style_class);
+ if (!class_quark)
+ return;
+
+ gtk_css_node_remove_class (priv->cssnode, class_quark);
+}
+
+/**
+ * gtk_widget_has_style_class:
+ * @widget: a #GtkWidget
+ * @style_class: A CSS style class, without the leading '.'
+ * used for notation of style classes
+ *
+ * Returns whether @style_class is currently applied to @widget.
+ *
+ * Returns: %TRUE if @style_class is currently applied to @widget,
+ * %FALSE otherwise.
+ */
+gboolean
+gtk_widget_has_style_class (GtkWidget *widget,
+ const char *style_class)
+{
+ GtkWidgetPrivate *priv = gtk_widget_get_instance_private (widget);
+ GQuark class_quark;
+
+ g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
+ g_return_val_if_fail (style_class != NULL, FALSE);
+ g_return_val_if_fail (style_class[0] != '\0', FALSE);
+ g_return_val_if_fail (style_class[0] != '.', FALSE);
+
+ class_quark = g_quark_from_string (style_class);
+ if (!class_quark)
+ return FALSE;
+
+ return gtk_css_node_has_class (priv->cssnode, class_quark);
+}
diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index 1719f59487..bcde90db00 100644
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -967,6 +967,17 @@ void gtk_widget_snapshot_child (GtkWidget *widget,
GtkSnapshot *snapshot);
GDK_AVAILABLE_IN_ALL
gboolean gtk_widget_should_layout (GtkWidget *widget);
+GDK_AVAILABLE_IN_ALL
+void gtk_widget_add_style_class (GtkWidget *widget,
+ const char *style_class);
+GDK_AVAILABLE_IN_ALL
+void gtk_widget_remove_style_class (GtkWidget *widget,
+ const char *style_class);
+GDK_AVAILABLE_IN_ALL
+gboolean gtk_widget_has_style_class (GtkWidget *widget,
+ const char *style_class);
+
+
/**
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]