// SPDX-License-Identifier: GPL-2.0+ /* * Copyright (C) 2013 Red Hat, Inc. */ /** * SECTION:nmt-editor-page: * @short_description: An #NmtEditor "page" * * #NmtEditorPage is the abstract base class for #NmtEditor "pages". * A "page" is a set of related #NmtEditorSections. */ #include "nm-default.h" #include "nmt-editor-page.h" G_DEFINE_ABSTRACT_TYPE (NmtEditorPage, nmt_editor_page, G_TYPE_OBJECT) #define NMT_EDITOR_PAGE_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), NMT_TYPE_EDITOR_PAGE, NmtEditorPagePrivate)) typedef struct { NMConnection *connection; GSList *sections; } NmtEditorPagePrivate; enum { PROP_0, PROP_CONNECTION, LAST_PROP }; static void nmt_editor_page_init (NmtEditorPage *page) { } static void nmt_editor_page_finalize (GObject *object) { NmtEditorPagePrivate *priv = NMT_EDITOR_PAGE_GET_PRIVATE (object); g_clear_object (&priv->connection); g_slist_free_full (priv->sections, g_object_unref); G_OBJECT_CLASS (nmt_editor_page_parent_class)->finalize (object); } /** * nmt_editor_page_get_connection: * @page: the #NmtEditorPage * * Gets the page's #NMConnection. * * Returns: (transfer none): the page's #NMConnection. */ NMConnection * nmt_editor_page_get_connection (NmtEditorPage *page) { NmtEditorPagePrivate *priv = NMT_EDITOR_PAGE_GET_PRIVATE (page); return priv->connection; } /** * nmt_editor_page_get_sections: * @page: the #NmtEditorPage * * Gets the page's list of sections to display. * * Returns: (transfer none): the list of sections; this is the internal list * used by the page and must not be modified or freed. */ GSList * nmt_editor_page_get_sections (NmtEditorPage *page) { NmtEditorPagePrivate *priv = NMT_EDITOR_PAGE_GET_PRIVATE (page); return priv->sections; } /** * nmt_editor_page_add_section: * @page: the #NmtEditorPage * @section: the #NmtEditorSection * * Adds a section to the page. This should only be called by #NmtEditorPage * subclasses. */ void nmt_editor_page_add_section (NmtEditorPage *page, NmtEditorSection *section) { NmtEditorPagePrivate *priv = NMT_EDITOR_PAGE_GET_PRIVATE (page); priv->sections = g_slist_append (priv->sections, g_object_ref_sink (section)); } /** * nmt_editor_page_saved: * @page: the #NmtEditorPage * * This method is called when the user saves the connection. It gives * the page a chance to do save its data outside the connections (such as * recommit the slave connections). */ void nmt_editor_page_saved (NmtEditorPage *page) { NmtEditorPageClass *editor_page_class = NMT_EDITOR_PAGE_GET_CLASS (page); if (editor_page_class->saved) editor_page_class->saved (page); } static void nmt_editor_page_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { NmtEditorPagePrivate *priv = NMT_EDITOR_PAGE_GET_PRIVATE (object); switch (prop_id) { case PROP_CONNECTION: priv->connection = g_value_dup_object (value); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void nmt_editor_page_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { NmtEditorPagePrivate *priv = NMT_EDITOR_PAGE_GET_PRIVATE (object); switch (prop_id) { case PROP_CONNECTION: g_value_set_object (value, priv->connection); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void nmt_editor_page_class_init (NmtEditorPageClass *page_class) { GObjectClass *object_class = G_OBJECT_CLASS (page_class); g_type_class_add_private (page_class, sizeof (NmtEditorPagePrivate)); /* virtual methods */ object_class->set_property = nmt_editor_page_set_property; object_class->get_property = nmt_editor_page_get_property; object_class->finalize = nmt_editor_page_finalize; /* properties */ /** * NmtEditorPage:connection: * * The page's #NMConnection. */ g_object_class_install_property (object_class, PROP_CONNECTION, g_param_spec_object ("connection", "", "", NM_TYPE_CONNECTION, G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY | G_PARAM_STATIC_STRINGS)); }