GMenuModel exporter: GIO Reference Manual

GMenuModel exporter

GMenuModel exporter — Export GMenuModels on D-Bus

Functions

guint	g_dbus_connection_export_menu_model ()
void	g_dbus_connection_unexport_menu_model ()

Includes

#include <gio/gio.h>

Description

These functions support exporting a GMenuModel on D-Bus. The D-Bus interface that is used is a private implementation detail.

To access an exported GMenuModel remotely, use g_dbus_menu_model_get() to obtain a GDBusMenuModel.

Functions

g_dbus_connection_export_menu_model ()

guint
g_dbus_connection_export_menu_model (GDBusConnection *connection,
                                     const gchar *object_path,
                                     GMenuModel *menu,
                                     GError **error);

Exports menu on connection at object_path .

The implemented D-Bus API should be considered private. It is subject to change in the future.

An object path can only have one menu model exported on it. If this constraint is violated, the export will fail and 0 will be returned (with error set accordingly).

You can unexport the menu model using g_dbus_connection_unexport_menu_model() with the return value of this function.

Parameters

connection	a GDBusConnection
object_path	a D-Bus object path
menu	a GMenuModel
error	return location for an error, or `NULL`

Returns

the ID of the export (never zero), or 0 in case of failure

Since: 2.32

g_dbus_connection_unexport_menu_model ()

void
g_dbus_connection_unexport_menu_model (GDBusConnection *connection,
                                       guint export_id);

Reverses the effect of a previous call to g_dbus_connection_export_menu_model().

It is an error to call this function with an ID that wasn't returned from g_dbus_connection_export_menu_model() or to call it with the same ID more than once.

Parameters

connection	a GDBusConnection
export_id	the ID from `g_dbus_connection_export_menu_model()`

Since: 2.32