1
<!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN" "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
2
<node xmlns:dox="http://www.ayatana.org/dbus/dox.dtd">
6
An interface to register menus that are associated with a window in an application. The
7
main interface is documented here: @ref com::ubuntu::MenuRegistrar.
9
The actual menus are transported using the gmenumodel protocol
11
<interface name="com.ubuntu.MenuRegistrar" xmlns:dox="http://www.ayatana.org/dbus/dox.dtd">
13
An interface to register a menu from an application to be displayed in another
14
window. This manages that association between processes and/or Mir surface IDs and the dbus
15
address and object that provides the menus using the org.gtk.Menus interface.
17
<method name="RegisterAppMenu">
19
Associates a gmenumodel with an application
21
/note this method assumes that the connection from the caller is the DBus connection
22
to use for the object. Applications that use multiple DBus connections will need to
23
ensure this method is called with the same connection that implements the object.
25
<arg name="pid" type="u" direction="in">
26
<dox:d>The process ID of the application for which the menu is associated</dox:d>
28
<arg name="menuObjectPath" type="o" direction="in">
29
<dox:d>The dbus path where the gmenumodel interface for the application menu has been exported</dox:d>
31
<arg name="actionObjectPath" type="o" direction="in">
32
<dox:d>The dbus path where the gactionmenu interface for the application menu actions has been exported</dox:d>
34
<arg name="service" type="s" direction="in">
35
<dox:d>The dbus conection name of the client application to be registered (e.g. :1.23 or org.example.service)</dox:d>
38
<method name="UnregisterAppMenu">
40
A method to allow removing an application menu from the database.
42
<arg name="pid" type="u" direction="in">
43
<dox:d>The process id of the application</dox:d>
45
<arg name="menuObjectPath" type="o" direction="in">
46
<dox:d>The dbus path for the registered application menu to be unregistered</dox:d>
50
<method name="RegisterSurfaceMenu">
52
Associates a gmenumodel with a surface
54
/note this method assumes that the connection from the caller is the DBus connection
55
to use for the object. Applications that use multiple DBus connections will need to
56
ensure this method is called with the same connection that implements the object.
58
<arg name="surface" type="s" direction="in">
59
<dox:d>The surface ID of the surface</dox:d>
61
<arg name="menuObjectPath" type="o" direction="in">
62
<dox:d>The dbus path where the gmenumodel interface for the surface menu has been exported</dox:d>
64
<arg name="actionObjectPath" type="o" direction="in">
65
<dox:d>The dbus path where the gactionmenu interface for the surface menu actions has been exported</dox:d>
67
<arg name="service" type="s" direction="in">
68
<dox:d>The dbus conection name of the client application to be registered (e.g. :1.23 or org.example.service)</dox:d>
71
<method name="UnregisterSurfaceMenu">
73
A method to allow removing a surface menu from the database.
75
<arg name="surfaceId" type="s" direction="in">
76
<dox:d>The surface id of the surface</dox:d>
78
<arg name="menuObjectPath" type="o" direction="in">
79
<dox:d>The dbus path for the registered surface menu to be unregistered</dox:d>
added
removed
src/ubuntuappmenu/com.ubuntu.MenuRegistrar.xml
