/* cc-multitasking-row.c * * Copyright 2018 Purism SPC * 2021 Georges Basile Stavracas Neto * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program 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 General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . * * SPDX-License-Identifier: GPL-3.0-or-later */ #include "cc-multitasking-row.h" struct _CcMultitaskingRow { AdwPreferencesRow parent; GtkBox *artwork_box; GtkBox *header; GtkImage *image; GtkBox *prefixes; GtkLabel *subtitle; GtkBox *suffixes; GtkLabel *title; GtkBox *title_box; GtkWidget *previous_parent; gboolean use_underline; gint title_lines; gint subtitle_lines; GtkWidget *activatable_widget; }; static GtkBuildableIface *parent_buildable_iface; static void cc_multitasking_row_buildable_init (GtkBuildableIface *iface); G_DEFINE_TYPE_WITH_CODE (CcMultitaskingRow, cc_multitasking_row, ADW_TYPE_PREFERENCES_ROW, G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE, cc_multitasking_row_buildable_init)) enum { PROP_0, PROP_ICON_NAME, PROP_ACTIVATABLE_WIDGET, PROP_SUBTITLE, PROP_USE_UNDERLINE, PROP_TITLE_LINES, PROP_SUBTITLE_LINES, N_PROPS, }; enum { SIGNAL_ACTIVATED, SIGNAL_LAST_SIGNAL, }; static GParamSpec *props[N_PROPS] = { NULL, }; static guint signals[SIGNAL_LAST_SIGNAL] = { 0, }; static void row_activated_cb (CcMultitaskingRow *self, GtkListBoxRow *row) { /* No need to use GTK_LIST_BOX_ROW() for a pointer comparison. */ if ((GtkListBoxRow *) self == row) cc_multitasking_row_activate (self); } static void parent_cb (CcMultitaskingRow *self) { GtkWidget *parent = gtk_widget_get_parent (GTK_WIDGET (self)); if (self->previous_parent != NULL) { g_signal_handlers_disconnect_by_func (self->previous_parent, G_CALLBACK (row_activated_cb), self); self->previous_parent = NULL; } if (parent == NULL || !GTK_IS_LIST_BOX (parent)) return; self->previous_parent = parent; g_signal_connect_swapped (parent, "row-activated", G_CALLBACK (row_activated_cb), self); } static void update_subtitle_visibility (CcMultitaskingRow *self) { gtk_widget_set_visible (GTK_WIDGET (self->subtitle), gtk_label_get_text (self->subtitle) != NULL && g_strcmp0 (gtk_label_get_text (self->subtitle), "") != 0); } static void cc_multitasking_row_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { CcMultitaskingRow *self = CC_MULTITASKING_ROW (object); switch (prop_id) { case PROP_ICON_NAME: g_value_set_string (value, cc_multitasking_row_get_icon_name (self)); break; case PROP_ACTIVATABLE_WIDGET: g_value_set_object (value, (GObject *) cc_multitasking_row_get_activatable_widget (self)); break; case PROP_SUBTITLE: g_value_set_string (value, cc_multitasking_row_get_subtitle (self)); break; case PROP_SUBTITLE_LINES: g_value_set_int (value, cc_multitasking_row_get_subtitle_lines (self)); break; case PROP_TITLE_LINES: g_value_set_int (value, cc_multitasking_row_get_title_lines (self)); break; case PROP_USE_UNDERLINE: g_value_set_boolean (value, cc_multitasking_row_get_use_underline (self)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); } } static void cc_multitasking_row_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { CcMultitaskingRow *self = CC_MULTITASKING_ROW (object); switch (prop_id) { case PROP_ICON_NAME: cc_multitasking_row_set_icon_name (self, g_value_get_string (value)); break; case PROP_ACTIVATABLE_WIDGET: cc_multitasking_row_set_activatable_widget (self, (GtkWidget*) g_value_get_object (value)); break; case PROP_SUBTITLE: cc_multitasking_row_set_subtitle (self, g_value_get_string (value)); break; case PROP_SUBTITLE_LINES: cc_multitasking_row_set_subtitle_lines (self, g_value_get_int (value)); break; case PROP_TITLE_LINES: cc_multitasking_row_set_title_lines (self, g_value_get_int (value)); break; case PROP_USE_UNDERLINE: cc_multitasking_row_set_use_underline (self, g_value_get_boolean (value)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); } } static void cc_multitasking_row_dispose (GObject *object) { CcMultitaskingRow *self = CC_MULTITASKING_ROW (object); if (self->previous_parent != NULL) { g_signal_handlers_disconnect_by_func (self->previous_parent, G_CALLBACK (row_activated_cb), self); self->previous_parent = NULL; } cc_multitasking_row_set_activatable_widget (self, NULL); g_clear_pointer ((GtkWidget**)&self->header, gtk_widget_unparent); G_OBJECT_CLASS (cc_multitasking_row_parent_class)->dispose (object); } static void cc_multitasking_row_class_init (CcMultitaskingRowClass *klass) { GObjectClass *object_class = G_OBJECT_CLASS (klass); GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass); object_class->get_property = cc_multitasking_row_get_property; object_class->set_property = cc_multitasking_row_set_property; object_class->dispose = cc_multitasking_row_dispose; props[PROP_ICON_NAME] = g_param_spec_string ("icon-name", "Icon name", "Icon name", "", G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_EXPLICIT_NOTIFY); props[PROP_ACTIVATABLE_WIDGET] = g_param_spec_object ("activatable-widget", "Activatable widget", "The widget to be activated when the row is activated", GTK_TYPE_WIDGET, G_PARAM_READWRITE); props[PROP_SUBTITLE] = g_param_spec_string ("subtitle", "Subtitle", "Subtitle", "", G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_EXPLICIT_NOTIFY); props[PROP_USE_UNDERLINE] = g_param_spec_boolean ("use-underline", "Use underline", "If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key", FALSE, G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY); props[PROP_TITLE_LINES] = g_param_spec_int ("title-lines", "Number of title lines", "The desired number of title lines", 0, G_MAXINT, 1, G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY); props[PROP_SUBTITLE_LINES] = g_param_spec_int ("subtitle-lines", "Number of subtitle lines", "The desired number of subtitle lines", 0, G_MAXINT, 1, G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY); g_object_class_install_properties (object_class, N_PROPS, props); signals[SIGNAL_ACTIVATED] = g_signal_new ("activated", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST, 0, NULL, NULL, NULL, G_TYPE_NONE, 0); gtk_widget_class_set_template_from_resource (widget_class, "/org/gnome/control-center/multitasking/cc-multitasking-row.ui"); gtk_widget_class_bind_template_child (widget_class, CcMultitaskingRow, artwork_box); gtk_widget_class_bind_template_child (widget_class, CcMultitaskingRow, header); gtk_widget_class_bind_template_child (widget_class, CcMultitaskingRow, image); gtk_widget_class_bind_template_child (widget_class, CcMultitaskingRow, prefixes); gtk_widget_class_bind_template_child (widget_class, CcMultitaskingRow, subtitle); gtk_widget_class_bind_template_child (widget_class, CcMultitaskingRow, suffixes); gtk_widget_class_bind_template_child (widget_class, CcMultitaskingRow, title); gtk_widget_class_bind_template_child (widget_class, CcMultitaskingRow, title_box); } static gboolean string_is_not_empty (GBinding *binding, const GValue *from_value, GValue *to_value, gpointer user_data) { const gchar *string = g_value_get_string (from_value); g_value_set_boolean (to_value, string != NULL && g_strcmp0 (string, "") != 0); return TRUE; } static void cc_multitasking_row_init (CcMultitaskingRow *self) { self->title_lines = 1; self->subtitle_lines = 1; gtk_widget_init_template (GTK_WIDGET (self)); g_object_bind_property_full (self, "title", self->title, "visible", G_BINDING_SYNC_CREATE, string_is_not_empty, NULL, NULL, NULL); update_subtitle_visibility (self); g_signal_connect (self, "notify::parent", G_CALLBACK (parent_cb), NULL); } static void cc_multitasking_row_buildable_add_child (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const gchar *type) { CcMultitaskingRow *self = CC_MULTITASKING_ROW (buildable); if (!self->header) parent_buildable_iface->add_child (buildable, builder, child, type); else if (type && strcmp (type, "prefix") == 0) cc_multitasking_row_add_prefix (self, GTK_WIDGET (child)); else if (type && strcmp (type, "artwork") == 0) cc_multitasking_row_add_artwork (self, GTK_WIDGET (child)); else if (!type && GTK_IS_WIDGET (child)) { gtk_box_append (self->suffixes, GTK_WIDGET (child)); gtk_widget_show (GTK_WIDGET (self->suffixes)); } else parent_buildable_iface->add_child (buildable, builder, child, type); } static void cc_multitasking_row_buildable_init (GtkBuildableIface *iface) { parent_buildable_iface = g_type_interface_peek_parent (iface); iface->add_child = cc_multitasking_row_buildable_add_child; } const gchar * cc_multitasking_row_get_subtitle (CcMultitaskingRow *self) { g_return_val_if_fail (CC_IS_MULTITASKING_ROW (self), NULL); return gtk_label_get_text (self->subtitle); } void cc_multitasking_row_set_subtitle (CcMultitaskingRow *self, const gchar *subtitle) { g_return_if_fail (CC_IS_MULTITASKING_ROW (self)); if (g_strcmp0 (gtk_label_get_text (self->subtitle), subtitle) == 0) return; gtk_label_set_text (self->subtitle, subtitle); gtk_widget_set_visible (GTK_WIDGET (self->subtitle), subtitle != NULL && g_strcmp0 (subtitle, "") != 0); g_object_notify_by_pspec (G_OBJECT (self), props[PROP_SUBTITLE]); } const gchar * cc_multitasking_row_get_icon_name (CcMultitaskingRow *self) { g_return_val_if_fail (CC_IS_MULTITASKING_ROW (self), NULL); return gtk_image_get_icon_name (self->image); } void cc_multitasking_row_set_icon_name (CcMultitaskingRow *self, const gchar *icon_name) { const gchar *old_icon_name; g_return_if_fail (CC_IS_MULTITASKING_ROW (self)); old_icon_name = gtk_image_get_icon_name (self->image); if (g_strcmp0 (old_icon_name, icon_name) == 0) return; gtk_image_set_from_icon_name (self->image, icon_name); gtk_widget_set_visible (GTK_WIDGET (self->image), icon_name != NULL && g_strcmp0 (icon_name, "") != 0); g_object_notify_by_pspec (G_OBJECT (self), props[PROP_ICON_NAME]); } GtkWidget * cc_multitasking_row_get_activatable_widget (CcMultitaskingRow *self) { g_return_val_if_fail (CC_IS_MULTITASKING_ROW (self), NULL); return self->activatable_widget; } static void activatable_widget_weak_notify (gpointer data, GObject *where_the_object_was) { CcMultitaskingRow *self = CC_MULTITASKING_ROW (data); self->activatable_widget = NULL; g_object_notify_by_pspec (G_OBJECT (self), props[PROP_ACTIVATABLE_WIDGET]); } void cc_multitasking_row_set_activatable_widget (CcMultitaskingRow *self, GtkWidget *widget) { g_return_if_fail (CC_IS_MULTITASKING_ROW (self)); g_return_if_fail (widget == NULL || GTK_IS_WIDGET (widget)); if (self->activatable_widget == widget) return; if (self->activatable_widget) g_object_weak_unref (G_OBJECT (self->activatable_widget), activatable_widget_weak_notify, self); self->activatable_widget = widget; if (self->activatable_widget != NULL) { g_object_weak_ref (G_OBJECT (self->activatable_widget), activatable_widget_weak_notify, self); gtk_list_box_row_set_activatable (GTK_LIST_BOX_ROW (self), TRUE); gtk_accessible_update_relation (GTK_ACCESSIBLE (self->activatable_widget), GTK_ACCESSIBLE_RELATION_LABELLED_BY, self->title, NULL, GTK_ACCESSIBLE_RELATION_DESCRIBED_BY, self->subtitle, NULL, -1); } g_object_notify_by_pspec (G_OBJECT (self), props[PROP_ACTIVATABLE_WIDGET]); } gboolean cc_multitasking_row_get_use_underline (CcMultitaskingRow *self) { g_return_val_if_fail (CC_IS_MULTITASKING_ROW (self), FALSE); return self->use_underline; } void cc_multitasking_row_set_use_underline (CcMultitaskingRow *self, gboolean use_underline) { g_return_if_fail (CC_IS_MULTITASKING_ROW (self)); use_underline = !!use_underline; if (self->use_underline == use_underline) return; self->use_underline = use_underline; adw_preferences_row_set_use_underline (ADW_PREFERENCES_ROW (self), self->use_underline); gtk_label_set_use_underline (self->title, self->use_underline); gtk_label_set_use_underline (self->subtitle, self->use_underline); gtk_label_set_mnemonic_widget (self->title, GTK_WIDGET (self)); gtk_label_set_mnemonic_widget (self->subtitle, GTK_WIDGET (self)); g_object_notify_by_pspec (G_OBJECT (self), props[PROP_USE_UNDERLINE]); } gint cc_multitasking_row_get_title_lines (CcMultitaskingRow *self) { g_return_val_if_fail (CC_IS_MULTITASKING_ROW (self), 0); return self->title_lines; } void cc_multitasking_row_set_title_lines (CcMultitaskingRow *self, gint title_lines) { g_return_if_fail (CC_IS_MULTITASKING_ROW (self)); g_return_if_fail (title_lines >= 0); if (self->title_lines == title_lines) return; self->title_lines = title_lines; gtk_label_set_lines (self->title, title_lines); gtk_label_set_ellipsize (self->title, title_lines == 0 ? PANGO_ELLIPSIZE_NONE : PANGO_ELLIPSIZE_END); g_object_notify_by_pspec (G_OBJECT (self), props[PROP_TITLE_LINES]); } gint cc_multitasking_row_get_subtitle_lines (CcMultitaskingRow *self) { g_return_val_if_fail (CC_IS_MULTITASKING_ROW (self), 0); return self->subtitle_lines; } void cc_multitasking_row_set_subtitle_lines (CcMultitaskingRow *self, gint subtitle_lines) { g_return_if_fail (CC_IS_MULTITASKING_ROW (self)); g_return_if_fail (subtitle_lines >= 0); if (self->subtitle_lines == subtitle_lines) return; self->subtitle_lines = subtitle_lines; gtk_label_set_lines (self->subtitle, subtitle_lines); gtk_label_set_ellipsize (self->subtitle, subtitle_lines == 0 ? PANGO_ELLIPSIZE_NONE : PANGO_ELLIPSIZE_END); g_object_notify_by_pspec (G_OBJECT (self), props[PROP_SUBTITLE_LINES]); } void cc_multitasking_row_add_prefix (CcMultitaskingRow *self, GtkWidget *widget) { g_return_if_fail (CC_IS_MULTITASKING_ROW (self)); g_return_if_fail (GTK_IS_WIDGET (self)); gtk_box_append (self->prefixes, widget); gtk_widget_show (GTK_WIDGET (self->prefixes)); } void cc_multitasking_row_add_artwork (CcMultitaskingRow *self, GtkWidget *widget) { g_return_if_fail (CC_IS_MULTITASKING_ROW (self)); g_return_if_fail (GTK_IS_WIDGET (self)); /* HACK: the artwork box pushes the title too much to the top, so we * need to compensate this here. */ gtk_widget_set_margin_top (GTK_WIDGET (self->header), 12); gtk_box_append (self->artwork_box, widget); gtk_widget_show (GTK_WIDGET (self->artwork_box)); } void cc_multitasking_row_activate (CcMultitaskingRow *self) { g_return_if_fail (CC_IS_MULTITASKING_ROW (self)); if (self->activatable_widget) gtk_widget_mnemonic_activate (self->activatable_widget, FALSE); g_signal_emit (self, signals[SIGNAL_ACTIVATED], 0); } void cc_multitasking_row_remove (CcMultitaskingRow *self, GtkWidget *child) { GtkWidget *parent; g_return_if_fail (CC_IS_MULTITASKING_ROW (self)); g_return_if_fail (GTK_IS_WIDGET (child)); parent = gtk_widget_get_parent (child); if (parent == GTK_WIDGET (self->prefixes)) gtk_box_remove (self->prefixes, child); else if (parent == GTK_WIDGET (self->suffixes)) gtk_box_remove (self->suffixes, child); else if (parent == GTK_WIDGET (self->artwork_box)) gtk_box_remove (self->artwork_box, child); else g_warning ("%p is not a child of %p", child, self); }