GMenuModel exporter

GMenuModel exporter — Export GMenuModels on D-Bus

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