/* 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)); }