ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / include / glib-2.0 / gio

/*
 * Copyright © 2011 Canonical Ltd.
 *
 * 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 <http://www.gnu.org/licenses/>.
 *
 * Author: Ryan Lortie <desrt@desrt.ca>
 */

#ifndef __G_MENU_MODEL_H__
#define __G_MENU_MODEL_H__

#include <glib-object.h>

#include <gio/giotypes.h>

G_BEGIN_DECLS

/**
 * G_MENU_ATTRIBUTE_ACTION:
 *
 * The menu item attribute which holds the action name of the item.  Action
 * names are namespaced with an identifier for the action group in which the
 * action resides. For example, "win." for window-specific actions and "app."
 * for application-wide actions.
 *
 * See also g_menu_model_get_item_attribute() and g_menu_item_set_attribute().
 *
 * Since: 2.32
 **/
#define G_MENU_ATTRIBUTE_ACTION "action"

/**
 * G_MENU_ATTRIBUTE_ACTION_NAMESPACE:
 *
 * The menu item attribute that holds the namespace for all action names in
 * menus that are linked from this item.
 *
 * Since: 2.36
 **/
#define G_MENU_ATTRIBUTE_ACTION_NAMESPACE "action-namespace"

/**
 * G_MENU_ATTRIBUTE_TARGET:
 *
 * The menu item attribute which holds the target with which the item's action
 * will be activated.
 *
 * See also g_menu_item_set_action_and_target()
 *
 * Since: 2.32
 **/
#define G_MENU_ATTRIBUTE_TARGET "target"

/**
 * G_MENU_ATTRIBUTE_LABEL:
 *
 * The menu item attribute which holds the label of the item.
 *
 * Since: 2.32
 **/
#define G_MENU_ATTRIBUTE_LABEL "label"

/**
 * G_MENU_ATTRIBUTE_ICON:
 *
 * The menu item attribute which holds the icon of the item.
 *
 * The icon is stored in the format returned by g_icon_serialize().
 *
 * This attribute is intended only to represent 'noun' icons such as
 * favicons for a webpage, or application icons.  It should not be used
 * for 'verbs' (ie: stock icons).
 *
 * Since: 2.38
 **/
#define G_MENU_ATTRIBUTE_ICON "icon"

/**
 * G_MENU_LINK_SUBMENU:
 *
 * The name of the link that associates a menu item with a submenu.
 *
 * See also g_menu_item_set_link().
 *
 * Since: 2.32
 **/
#define G_MENU_LINK_SUBMENU "submenu"

/**
 * G_MENU_LINK_SECTION:
 *
 * The name of the link that associates a menu item with a section.  The linked
 * menu will usually be shown in place of the menu item, using the item's label
 * as a header.
 *
 * See also g_menu_item_set_link().
 *
 * Since: 2.32
 **/
#define G_MENU_LINK_SECTION "section"

#define G_TYPE_MENU_MODEL                                   (g_menu_model_get_type ())
#define G_MENU_MODEL(inst)                                  (G_TYPE_CHECK_INSTANCE_CAST ((inst),                     \
                                                             G_TYPE_MENU_MODEL, GMenuModel))
#define G_MENU_MODEL_CLASS(class)                           (G_TYPE_CHECK_CLASS_CAST ((class),                       \
                                                             G_TYPE_MENU_MODEL, GMenuModelClass))
#define G_IS_MENU_MODEL(inst)                               (G_TYPE_CHECK_INSTANCE_TYPE ((inst),                     \
                                                             G_TYPE_MENU_MODEL))
#define G_IS_MENU_MODEL_CLASS(class)                        (G_TYPE_CHECK_CLASS_TYPE ((class),                       \
                                                             G_TYPE_MENU_MODEL))
#define G_MENU_MODEL_GET_CLASS(inst)                        (G_TYPE_INSTANCE_GET_CLASS ((inst),                      \
                                                             G_TYPE_MENU_MODEL, GMenuModelClass))

typedef struct _GMenuModelPrivate                           GMenuModelPrivate;
typedef struct _GMenuModelClass                             GMenuModelClass;

typedef struct _GMenuAttributeIterPrivate                   GMenuAttributeIterPrivate;
typedef struct _GMenuAttributeIterClass                     GMenuAttributeIterClass;
typedef struct _GMenuAttributeIter                          GMenuAttributeIter;

typedef struct _GMenuLinkIterPrivate                        GMenuLinkIterPrivate;
typedef struct _GMenuLinkIterClass                          GMenuLinkIterClass;
typedef struct _GMenuLinkIter                               GMenuLinkIter;

struct _GMenuModel
{
  GObject            parent_instance;
  GMenuModelPrivate *priv;
};

/**
 * GMenuModelClass::get_item_attributes:
 * @model: the #GMenuModel to query
 * @item_index: The #GMenuItem to query
 * @attributes: (out) (element-type utf8 GLib.Variant): Attributes on the item
 *
 * Gets all the attributes associated with the item in the menu model.
 */
/**
 * GMenuModelClass::get_item_links:
 * @model: the #GMenuModel to query
 * @item_index: The #GMenuItem to query
 * @links: (out) (element-type utf8 Gio.MenuModel): Links from the item
 *
 * Gets all the links associated with the item in the menu model.
 */
struct _GMenuModelClass
{
  GObjectClass parent_class;

gboolean              (*is_mutable)                       (GMenuModel          *model);
  gint                  (*get_n_items)                      (GMenuModel          *model);
  void                  (*get_item_attributes)              (GMenuModel          *model,
                                                             gint                 item_index,
                                                             GHashTable         **attributes);
  GMenuAttributeIter *  (*iterate_item_attributes)          (GMenuModel          *model,
                                                             gint                 item_index);
  GVariant *            (*get_item_attribute_value)         (GMenuModel          *model,
                                                             gint                 item_index,
                                                             const gchar         *attribute,
                                                             const GVariantType  *expected_type);
  void                  (*get_item_links)                   (GMenuModel          *model,
                                                             gint                 item_index,
                                                             GHashTable         **links);
  GMenuLinkIter *       (*iterate_item_links)               (GMenuModel          *model,
                                                             gint                 item_index);
  GMenuModel *          (*get_item_link)                    (GMenuModel          *model,
                                                             gint                 item_index,
                                                             const gchar         *link);
};

GLIB_AVAILABLE_IN_2_32
GType                   g_menu_model_get_type                           (void) G_GNUC_CONST;

GLIB_AVAILABLE_IN_2_32
gboolean                g_menu_model_is_mutable                         (GMenuModel         *model);
GLIB_AVAILABLE_IN_2_32
gint                    g_menu_model_get_n_items                        (GMenuModel         *model);

GLIB_AVAILABLE_IN_2_32
GMenuAttributeIter *    g_menu_model_iterate_item_attributes            (GMenuModel         *model,
                                                                         gint                item_index);
GLIB_AVAILABLE_IN_2_32
GVariant *              g_menu_model_get_item_attribute_value           (GMenuModel         *model,
                                                                         gint                item_index,
                                                                         const gchar        *attribute,
                                                                         const GVariantType *expected_type);
GLIB_AVAILABLE_IN_2_32
gboolean                g_menu_model_get_item_attribute                 (GMenuModel         *model,
                                                                         gint                item_index,
                                                                         const gchar        *attribute,
                                                                         const gchar        *format_string,
                                                                         ...);
GLIB_AVAILABLE_IN_2_32
GMenuLinkIter *         g_menu_model_iterate_item_links                 (GMenuModel         *model,
                                                                         gint                item_index);
GLIB_AVAILABLE_IN_2_32
GMenuModel *            g_menu_model_get_item_link                      (GMenuModel         *model,
                                                                         gint                item_index,
                                                                         const gchar        *link);

GLIB_AVAILABLE_IN_2_32
void                    g_menu_model_items_changed                      (GMenuModel         *model,
                                                                         gint                position,
                                                                         gint                removed,
                                                                         gint                added);

#define G_TYPE_MENU_ATTRIBUTE_ITER                          (g_menu_attribute_iter_get_type ())
#define G_MENU_ATTRIBUTE_ITER(inst)                         (G_TYPE_CHECK_INSTANCE_CAST ((inst),                     \
                                                             G_TYPE_MENU_ATTRIBUTE_ITER, GMenuAttributeIter))
#define G_MENU_ATTRIBUTE_ITER_CLASS(class)                  (G_TYPE_CHECK_CLASS_CAST ((class),                       \
                                                             G_TYPE_MENU_ATTRIBUTE_ITER, GMenuAttributeIterClass))
#define G_IS_MENU_ATTRIBUTE_ITER(inst)                      (G_TYPE_CHECK_INSTANCE_TYPE ((inst),                     \
                                                             G_TYPE_MENU_ATTRIBUTE_ITER))
#define G_IS_MENU_ATTRIBUTE_ITER_CLASS(class)               (G_TYPE_CHECK_CLASS_TYPE ((class),                       \
                                                             G_TYPE_MENU_ATTRIBUTE_ITER))
#define G_MENU_ATTRIBUTE_ITER_GET_CLASS(inst)               (G_TYPE_INSTANCE_GET_CLASS ((inst),                      \
                                                             G_TYPE_MENU_ATTRIBUTE_ITER, GMenuAttributeIterClass))

struct _GMenuAttributeIter
{
  GObject parent_instance;
  GMenuAttributeIterPrivate *priv;
};

struct _GMenuAttributeIterClass
{
  GObjectClass parent_class;

gboolean      (*get_next) (GMenuAttributeIter  *iter,
                             const gchar        **out_name,
                             GVariant           **value);
};

GLIB_AVAILABLE_IN_2_32
GType                   g_menu_attribute_iter_get_type                  (void) G_GNUC_CONST;

GLIB_AVAILABLE_IN_2_32
gboolean                g_menu_attribute_iter_get_next                  (GMenuAttributeIter  *iter,
                                                                         const gchar        **out_name,
                                                                         GVariant           **value);
GLIB_AVAILABLE_IN_2_32
gboolean                g_menu_attribute_iter_next                      (GMenuAttributeIter  *iter);
GLIB_AVAILABLE_IN_2_32
const gchar *           g_menu_attribute_iter_get_name                  (GMenuAttributeIter  *iter);
GLIB_AVAILABLE_IN_2_32
GVariant *              g_menu_attribute_iter_get_value                 (GMenuAttributeIter  *iter);

#define G_TYPE_MENU_LINK_ITER                               (g_menu_link_iter_get_type ())
#define G_MENU_LINK_ITER(inst)                              (G_TYPE_CHECK_INSTANCE_CAST ((inst),                     \
                                                             G_TYPE_MENU_LINK_ITER, GMenuLinkIter))
#define G_MENU_LINK_ITER_CLASS(class)                       (G_TYPE_CHECK_CLASS_CAST ((class),                       \
                                                             G_TYPE_MENU_LINK_ITER, GMenuLinkIterClass))
#define G_IS_MENU_LINK_ITER(inst)                           (G_TYPE_CHECK_INSTANCE_TYPE ((inst),                     \
                                                             G_TYPE_MENU_LINK_ITER))
#define G_IS_MENU_LINK_ITER_CLASS(class)                    (G_TYPE_CHECK_CLASS_TYPE ((class),                       \
                                                             G_TYPE_MENU_LINK_ITER))
#define G_MENU_LINK_ITER_GET_CLASS(inst)                    (G_TYPE_INSTANCE_GET_CLASS ((inst),                      \
                                                             G_TYPE_MENU_LINK_ITER, GMenuLinkIterClass))

struct _GMenuLinkIter
{
  GObject parent_instance;
  GMenuLinkIterPrivate *priv;
};

struct _GMenuLinkIterClass
{
  GObjectClass parent_class;

gboolean      (*get_next) (GMenuLinkIter  *iter,
                             const gchar   **out_link,
                             GMenuModel    **value);
};

GLIB_AVAILABLE_IN_2_32
GType                   g_menu_link_iter_get_type                       (void) G_GNUC_CONST;

GLIB_AVAILABLE_IN_2_32
gboolean                g_menu_link_iter_get_next                       (GMenuLinkIter  *iter,
                                                                         const gchar   **out_link,
                                                                         GMenuModel    **value);
GLIB_AVAILABLE_IN_2_32
gboolean                g_menu_link_iter_next                           (GMenuLinkIter  *iter);
GLIB_AVAILABLE_IN_2_32
const gchar *           g_menu_link_iter_get_name                       (GMenuLinkIter  *iter);
GLIB_AVAILABLE_IN_2_32
GMenuModel *            g_menu_link_iter_get_value                      (GMenuLinkIter  *iter);

G_END_DECLS

#endif /* __G_MENU_MODEL_H__ */

[-] gicon.h [edit]
[-] gmenumodel.h [edit]
[-] gdbusobjectproxy.h [edit]
[-] gnetworking.h [edit]
[-] gresolver.h [edit]
[-] gremoteactiongroup.h [edit]
[-] gsimpleproxyresolver.h [edit]
[-] gdbusobjectmanagerserver.h [edit]
[-] gsubprocesslauncher.h [edit]
[-] giostream.h [edit]
[-] gdbusproxy.h [edit]
[-] gvfs.h [edit]
[-] gfilterinputstream.h [edit]
[-] gdbusintrospection.h [edit]
[-] gsocketconnection.h [edit]
[-] gfilteroutputstream.h [edit]
[-] gemblem.h [edit]
[-] gtlsconnection.h [edit]
[-] gdbusnamewatching.h [edit]
[-] giomodule.h [edit]
[-] gtcpwrapperconnection.h [edit]
[-] gasyncresult.h [edit]
[-] gcontenttype.h [edit]
[-] gfileicon.h [edit]
[-] gresource.h [edit]
[-] gioenumtypes.h [edit]
[-] gasyncinitable.h [edit]
[-] gioenums.h [edit]
[-] gio.h [edit]
[-] gseekable.h [edit]
[-] gproxyaddressenumerator.h [edit]
[-] ginetaddressmask.h [edit]
[-] gemblemedicon.h [edit]
[-] gmemoryoutputstream.h [edit]
[-] gdtlsconnection.h [edit]
[-] gdatagrambased.h [edit]
[-] gbufferedinputstream.h [edit]
[-] gtlscertificate.h [edit]
[-] gvolume.h [edit]
[-] gdbusutils.h [edit]
[-] gappinfo.h [edit]
[-] gaction.h [edit]
[-] gtlspassword.h [edit]
[+] ..
[-] gbytesicon.h [edit]
[-] gsettingsbackend.h [edit]
[-] gconverterinputstream.h [edit]
[-] gtlsclientconnection.h [edit]
[-] gmenu.h [edit]
[-] gfilemonitor.h [edit]
[-] gdbuserror.h [edit]
[-] gzlibdecompressor.h [edit]
[-] gsocketcontrolmessage.h [edit]
[-] gsimpleaction.h [edit]
[-] gsimpleasyncresult.h [edit]
[-] gnetworkservice.h [edit]
[-] ginetaddress.h [edit]
[-] gapplicationcommandline.h [edit]
[-] gthreadedsocketservice.h [edit]
[-] gdtlsserverconnection.h [edit]
[-] gfileoutputstream.h [edit]
[-] gvolumemonitor.h [edit]
[-] goutputstream.h [edit]
[-] gtlsbackend.h [edit]
[-] gproxy.h [edit]
[-] gio-autocleanups.h [edit]
[-] gdbusmenumodel.h [edit]
[-] gactiongroup.h [edit]
[-] gdbusinterfaceskeleton.h [edit]
[-] gdbusmessage.h [edit]
[-] gpropertyaction.h [edit]
[-] gsocketservice.h [edit]
[-] gtlsinteraction.h [edit]
[-] gdbusactiongroup.h [edit]
[-] gnotification.h [edit]
[-] gmount.h [edit]
[-] gdbusaddress.h [edit]
[-] gdbusconnection.h [edit]
[-] gactiongroupexporter.h [edit]
[-] gsocketclient.h [edit]
[-] gdatainputstream.h [edit]
[-] gdbusmethodinvocation.h [edit]
[-] gnetworkmonitor.h [edit]
[-] gdbusserver.h [edit]
[-] gtask.h [edit]
[-] gnetworkaddress.h [edit]
[-] gactionmap.h [edit]
[-] gfileinputstream.h [edit]
[-] gsimplepermission.h [edit]
[-] gtestdbus.h [edit]
[-] gfile.h [edit]
[-] gmemoryinputstream.h [edit]
[-] gtcpconnection.h [edit]
[-] gsettings.h [edit]
[-] gapplication.h [edit]
[-] gproxyresolver.h [edit]
[-] gtlsserverconnection.h [edit]
[-] gmenuexporter.h [edit]
[-] ginetsocketaddress.h [edit]
[-] gfileinfo.h [edit]
[-] gzlibcompressor.h [edit]
[-] gproxyaddress.h [edit]
[-] gdrive.h [edit]
[-] gdataoutputstream.h [edit]
[-] gdbusauthobserver.h [edit]
[-] gdbusobjectmanagerclient.h [edit]
[-] gpollableutils.h [edit]
[-] gnativevolumemonitor.h [edit]
[-] gdtlsclientconnection.h [edit]
[-] gpollableoutputstream.h [edit]
[-] gsettingsschema.h [edit]
[-] gliststore.h [edit]
[-] gsocketaddressenumerator.h [edit]
[-] gsocketlistener.h [edit]
[-] gdbusobjectmanager.h [edit]
[-] gsubprocess.h [edit]
[-] gsrvtarget.h [edit]
[-] gfileattribute.h [edit]
[-] gbufferedoutputstream.h [edit]
[-] ginitable.h [edit]
[-] gcredentials.h [edit]
[-] gtlsdatabase.h [edit]
[-] gfileenumerator.h [edit]
[-] gsocketaddress.h [edit]
[-] gloadableicon.h [edit]
[-] gfilenamecompleter.h [edit]
[-] gthemedicon.h [edit]
[-] gdbusobject.h [edit]
[-] gpollableinputstream.h [edit]
[-] gconverter.h [edit]
[-] gdbusnameowning.h [edit]
[-] gpermission.h [edit]
[-] gtlsfiledatabase.h [edit]
[-] giotypes.h [edit]
[-] gconverteroutputstream.h [edit]
[-] glistmodel.h [edit]
[-] gcancellable.h [edit]
[-] gsocket.h [edit]
[-] gmountoperation.h [edit]
[-] gdbusobjectskeleton.h [edit]
[-] gsocketconnectable.h [edit]
[-] gfileiostream.h [edit]
[-] gcharsetconverter.h [edit]
[-] gioscheduler.h [edit]
[-] gsimpleactiongroup.h [edit]
[-] gdbusinterface.h [edit]
[-] gioerror.h [edit]
[-] gsimpleiostream.h [edit]
[-] ginputstream.h [edit]