/* * Copyright © 2019 Benjamin Otte * * 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.1 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 . * * Authors: Benjamin Otte */ #include "config.h" #include "gtkbuilderlistitemfactory.h" #include "gtkbuilder.h" #include "gtkintl.h" #include "gtklistitemfactoryprivate.h" #include "gtklistitemprivate.h" /** * SECTION:gtkbuilderlistitemfactory * @Tiitle: GtkBuilderListItemFactory * @Short_description: A listitem factory using ui files * * #GtkBuilderListItemFactory is a #GtkListItemFactory that creates * widgets by instantiating #GtkBuilder UI templates. The templates * must be extending #GtkListItem, and typically use #GtkExpressions * to obtain data from the items in the model. * * Example: * |[ * * * * ]| */ struct _GtkBuilderListItemFactory { GtkListItemFactory parent_instance; GtkBuilderScope *scope; GBytes *bytes; char *resource; }; struct _GtkBuilderListItemFactoryClass { GtkListItemFactoryClass parent_class; }; enum { PROP_0, PROP_BYTES, PROP_RESOURCE, PROP_SCOPE, N_PROPS }; G_DEFINE_TYPE (GtkBuilderListItemFactory, gtk_builder_list_item_factory, GTK_TYPE_LIST_ITEM_FACTORY) static GParamSpec *properties[N_PROPS] = { NULL, }; static void gtk_builder_list_item_factory_setup (GtkListItemFactory *factory, GtkListItem *list_item) { GtkBuilderListItemFactory *self = GTK_BUILDER_LIST_ITEM_FACTORY (factory); GtkBuilder *builder; GError *error = NULL; GTK_LIST_ITEM_FACTORY_CLASS (gtk_builder_list_item_factory_parent_class)->setup (factory, list_item); builder = gtk_builder_new (); gtk_builder_set_current_object (builder, G_OBJECT (list_item)); if (self->scope) gtk_builder_set_scope (builder, self->scope); if (!gtk_builder_extend_with_template (builder, GTK_WIDGET (list_item), G_OBJECT_TYPE (list_item), (const gchar *)g_bytes_get_data (self->bytes, NULL), g_bytes_get_size (self->bytes), &error)) { g_critical ("Error building template for list item: %s", error->message); g_error_free (error); /* This should never happen, if the template XML cannot be built * then it is a critical programming error. */ g_object_unref (builder); return; } g_object_unref (builder); } static void gtk_builder_list_item_factory_get_property (GObject *object, guint property_id, GValue *value, GParamSpec *pspec) { GtkBuilderListItemFactory *self = GTK_BUILDER_LIST_ITEM_FACTORY (object); switch (property_id) { case PROP_BYTES: g_value_set_boxed (value, self->bytes); break; case PROP_RESOURCE: g_value_set_string (value, self->resource); break; case PROP_SCOPE: g_value_set_object (value, self->scope); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec); break; } } static gboolean gtk_builder_list_item_factory_set_bytes (GtkBuilderListItemFactory *self, GBytes *bytes) { if (bytes == NULL) return FALSE; if (self->bytes) { g_critical ("Data for GtkBuilderListItemFactory has already been set."); return FALSE; } self->bytes = g_bytes_ref (bytes); return TRUE; } static void gtk_builder_list_item_factory_set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec) { GtkBuilderListItemFactory *self = GTK_BUILDER_LIST_ITEM_FACTORY (object); switch (property_id) { case PROP_BYTES: gtk_builder_list_item_factory_set_bytes (self, g_value_get_boxed (value)); break; case PROP_RESOURCE: { GError *error = NULL; GBytes *bytes; const char *resource; resource = g_value_get_string (value); if (resource == NULL) break; bytes = g_resources_lookup_data (resource, 0, &error); if (bytes) { if (gtk_builder_list_item_factory_set_bytes (self, bytes)) self->resource = g_strdup (resource); g_bytes_unref (bytes); } else { g_critical ("Unable to load resource for list item template: %s", error->message); g_error_free (error); } } break; case PROP_SCOPE: self->scope = g_value_dup_object (value); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec); break; } } static void gtk_builder_list_item_factory_finalize (GObject *object) { GtkBuilderListItemFactory *self = GTK_BUILDER_LIST_ITEM_FACTORY (object); g_clear_object (&self->scope); g_bytes_unref (self->bytes); g_free (self->resource); G_OBJECT_CLASS (gtk_builder_list_item_factory_parent_class)->finalize (object); } static void gtk_builder_list_item_factory_class_init (GtkBuilderListItemFactoryClass *klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); GtkListItemFactoryClass *factory_class = GTK_LIST_ITEM_FACTORY_CLASS (klass); gobject_class->finalize = gtk_builder_list_item_factory_finalize; gobject_class->get_property = gtk_builder_list_item_factory_get_property; gobject_class->set_property = gtk_builder_list_item_factory_set_property; factory_class->setup = gtk_builder_list_item_factory_setup; /** * GtkBuilderListItemFactory:bytes: * * bytes containing the UI definition */ properties[PROP_BYTES] = g_param_spec_boxed ("bytes", P_("Bytes"), P_("bytes containing the UI definition"), G_TYPE_BYTES, G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY | G_PARAM_STATIC_STRINGS); /** * GtkBuilderListItemFactory:resource: * * resource containing the UI definition */ properties[PROP_RESOURCE] = g_param_spec_string ("resource", P_("Resource"), P_("resource containing the UI definition"), NULL, G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY | G_PARAM_STATIC_STRINGS); /** * GtkBuilderListItemFactory:scope: * * scope to use when instantiating listitems */ properties[PROP_SCOPE] = g_param_spec_object ("scope", P_("Scope"), P_("scope to use when instantiating listitems"), GTK_TYPE_BUILDER_SCOPE, G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY | G_PARAM_STATIC_STRINGS); g_object_class_install_properties (gobject_class, N_PROPS, properties); } static void gtk_builder_list_item_factory_init (GtkBuilderListItemFactory *self) { } /** * gtk_builder_list_item_factory_new_from_bytes: * @scope: (nullable) (transfer none): A scope to use when instantiating * @bytes: the bytes containing the ui file to instantiate * * Creates s new #GtkBuilderListItemFactory that instantiates widgets * using @bytes as the data to pass to #GtkBuilder. * * Returns: a new #GtkBuilderListItemFactory **/ GtkListItemFactory * gtk_builder_list_item_factory_new_from_bytes (GtkBuilderScope *scope, GBytes *bytes) { g_return_val_if_fail (bytes != NULL, NULL); return g_object_new (GTK_TYPE_BUILDER_LIST_ITEM_FACTORY, "bytes", bytes, "scope", scope, NULL); } /** * gtk_builder_list_item_factory_new_from_resource: * @scope: (nullable) (transfer none): A scope to use when instantiating * @resource_path: valid path to a resource that contains the data * * Creates s new #GtkBuilderListItemFactory that instantiates widgets * using data read from the given @resource_path to pass to #GtkBuilder. * * Returns: a new #GtkBuilderListItemFactory **/ GtkListItemFactory * gtk_builder_list_item_factory_new_from_resource (GtkBuilderScope *scope, const char *resource_path) { g_return_val_if_fail (scope == NULL || GTK_IS_BUILDER_SCOPE (scope), NULL); g_return_val_if_fail (resource_path != NULL, NULL); return g_object_new (GTK_TYPE_BUILDER_LIST_ITEM_FACTORY, "resource", resource_path, "scope", scope, NULL); } /** * gtk_builder_list_item_factory_get_bytes: * @self: a #GtkBuilderListItemFactory * * Gets the data used as the #GtkBuilder UI template for constructing * listitems. * * Returns: (transfer none): The GtkBuilder data * **/ GBytes * gtk_builder_list_item_factory_get_bytes (GtkBuilderListItemFactory *self) { g_return_val_if_fail (GTK_IS_BUILDER_LIST_ITEM_FACTORY (self), NULL); return self->bytes; } /** * gtk_builder_list_item_factory_get_resource: * @self: a #GtkBuilderListItemFactory * * If the data references a resource, gets the path of that resource. * * Returns: (transfer none) (nullable): The path to the resource or %NULL * if none **/ const char * gtk_builder_list_item_factory_get_resource (GtkBuilderListItemFactory *self) { g_return_val_if_fail (GTK_IS_BUILDER_LIST_ITEM_FACTORY (self), NULL); return self->resource; } /** * gtk_builder_list_item_factory_get_scope: * @self: a #GtkBuilderListItemFactory * * Gets the scope used when constructing listitems. * * Returns: (transfer none) (nullable): The scope used when constructing listitems **/ GtkBuilderScope * gtk_builder_list_item_factory_get_scope (GtkBuilderListItemFactory *self) { g_return_val_if_fail (GTK_IS_BUILDER_LIST_ITEM_FACTORY (self), NULL); return self->scope; }