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