nautilus/libnautilus-extension/nautilus-menu.c
Ernestas Kulik 7e2605c681 general: refactor extension library
The changes include:

  * adding a single-include header and deprecating
    nautilus-extension-types.h and direct inclusions of individual
    headers;

  * type definition simplifications - this causes some breakages in
    nautilus-file, because NautilusFile used to be typedefed to
    NautilusFileInfo, and that is no longer possible, so the interface
    implementation was moved to static functions and the public
    NautilusFile API provides thin wrappers for them to maintain
    compatibility;

  * documentation cleanups and reorganization;

  * general build rule and code cleanups: mostly g_auto* sprinkled
    around and style changes (sorry)
2018-02-09 06:32:38 +02:00

124 lines
3 KiB
C

/*
* nautilus-menu.h - Menus exported by NautilusMenuProvider objects.
*
* Copyright (C) 2005 Raffaele Sandrini
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, see <http://www.gnu.org/licenses/>.
*
* Author: Raffaele Sandrini <rasa@gmx.ch>
*
*/
#include <config.h>
#include "nautilus-menu.h"
#include <glib.h>
#include <glib/gi18n-lib.h>
/**
* SECTION:nautilus-menu
* @title: NautilusMenu
* @short_description: Menu descriptor object
*
* #NautilusMenu is an object that describes a submenu in a file manager
* menu. Extensions can provide #NautilusMenu objects by attaching them to
* #NautilusMenuItem objects, using nautilus_menu_item_set_submenu().
*/
struct _NautilusMenu
{
GObject parent_instance;
GList *item_list;
};
G_DEFINE_TYPE (NautilusMenu, nautilus_menu, G_TYPE_OBJECT);
void
nautilus_menu_append_item (NautilusMenu *self,
NautilusMenuItem *menu_item)
{
g_return_if_fail (NAUTILUS_IS_MENU (self));
g_return_if_fail (NAUTILUS_IS_MENU_ITEM (menu_item));
self->item_list = g_list_append (self->item_list, g_object_ref (menu_item));
}
/**
* nautilus_menu_get_items:
* @menu: a #NautilusMenu
*
* Returns: (element-type NautilusMenuItem) (transfer full): the provided #NautilusMenuItem list
*/
GList *
nautilus_menu_get_items (NautilusMenu *self)
{
GList *item_list;
g_return_val_if_fail (NAUTILUS_IS_MENU (self), NULL);
item_list = g_list_copy (self->item_list);
g_list_foreach (item_list, (GFunc) g_object_ref, NULL);
return item_list;
}
/**
* nautilus_menu_item_list_free:
* @item_list: (element-type NautilusMenuItem): a list of #NautilusMenuItem
*
*/
void
nautilus_menu_item_list_free (GList *item_list)
{
g_return_if_fail (item_list != NULL);
g_list_foreach (item_list, (GFunc) g_object_unref, NULL);
g_list_free (item_list);
}
/* Type initialization */
static void
nautilus_menu_finalize (GObject *object)
{
NautilusMenu *menu = NAUTILUS_MENU (object);
g_clear_pointer (&menu->item_list, g_list_free);
G_OBJECT_CLASS (nautilus_menu_parent_class)->finalize (object);
}
static void
nautilus_menu_init (NautilusMenu *self)
{
self->item_list = NULL;
}
static void
nautilus_menu_class_init (NautilusMenuClass *klass)
{
GObjectClass *object_class = G_OBJECT_CLASS (klass);
object_class->finalize = nautilus_menu_finalize;
}
/* public constructors */
NautilusMenu *
nautilus_menu_new (void)
{
return g_object_new (NAUTILUS_TYPE_MENU, NULL);
}