Top | ![]() |
![]() |
![]() |
![]() |
guint | g_dbus_connection_export_menu_model () |
void | g_dbus_connection_unexport_menu_model () |
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.
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).
Exporting menus with sections containing more than
G_MENU_EXPORTER_MAX_SECTION_SIZE
items is not supported and results in
undefined behavior.
You can unexport the menu model using
g_dbus_connection_unexport_menu_model()
with the return value of
this function.
connection |
||
object_path |
a D-Bus object path |
|
menu |
||
error |
return location for an error, or |
Since: 2.32
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.
Since: 2.32
#define G_MENU_EXPORTER_MAX_SECTION_SIZE
The maximum number of entries in a menu section supported by
g_dbus_connection_export_menu_model()
.
The exact value of the limit may change in future GLib versions.
Since: 2.76