Top |
DbusmenuServerDbusmenuServer — The server signals changed and updates on a tree of DbusmenuMenuitem objecs. |
#define | DBUSMENU_SERVER_SIGNAL_ID_PROP_UPDATE |
#define | DBUSMENU_SERVER_SIGNAL_ID_UPDATE |
#define | DBUSMENU_SERVER_SIGNAL_LAYOUT_UPDATED |
#define | DBUSMENU_SERVER_SIGNAL_LAYOUT_UPDATE |
#define | DBUSMENU_SERVER_SIGNAL_ITEM_ACTIVATION |
#define | DBUSMENU_SERVER_PROP_DBUS_OBJECT |
#define | DBUSMENU_SERVER_PROP_ROOT_NODE |
#define | DBUSMENU_SERVER_PROP_STATUS |
#define | DBUSMENU_SERVER_PROP_TEXT_DIRECTION |
#define | DBUSMENU_SERVER_PROP_VERSION |
struct | DbusmenuServer |
A DbusmenuServer is the object that represents the local tree of DbusmenuMenuitem objects on DBus. It watches the various signals that those objects emit and correctly represents them across DBus to a DbusmenuClient so that the same tree can be maintained in another process.
The server needs to have the root set of DbusmenuMenuitem objects set via dbusmenu_server_set_root but it will query all of the objects in that tree automatically. After setting the root there should be no other maintence required by users of the server class.
DbusmenuServer *
dbusmenu_server_new (const gchar *object
);
Creates a new DbusmenuServer object with a specific object
path on DBus. If object
is set to NULL the default object
name of "/com/canonical/dbusmenu" will be used.
DbusmenuStatus
dbusmenu_server_get_status (DbusmenuServer *server
);
Gets the current statust hat the server is sending out over DBus.
DbusmenuTextDirection
dbusmenu_server_get_text_direction (DbusmenuServer *server
);
Returns the value of the text direction that is being exported over DBus for this server. It should relate to the direction of the labels and other text fields that are being exported by this server.
void dbusmenu_server_set_root (DbusmenuServer *self
,DbusmenuMenuitem *root
);
This function contains all of the GValue wrapping
required to set the property “root-node”
on the server self
.
self |
The DbusmenuServer object to set the root on |
|
root |
The new root DbusmenuMenuitem tree |
void dbusmenu_server_set_status (DbusmenuServer *server
,DbusmenuStatus status
);
Changes the status of the server.
void dbusmenu_server_set_text_direction (DbusmenuServer *server
,DbusmenuTextDirection dir
);
Sets the text direction that should be exported over DBus for this server. If the value is set to DBUSMENU_TEXT_DIRECTION_NONE the default detection will be used for setting the value and exported over DBus.
#define DBUSMENU_SERVER_SIGNAL_ID_PROP_UPDATE "item-property-updated"
String to attach to signal “item-property-updated”
#define DBUSMENU_SERVER_SIGNAL_ID_UPDATE "item-updated"
String to attach to signal “item-updated”
#define DBUSMENU_SERVER_SIGNAL_LAYOUT_UPDATED "layout-updated"
String to attach to signal “layout-updated”
#define DBUSMENU_SERVER_SIGNAL_LAYOUT_UPDATE DBUSMENU_SERVER_SIGNAL_LAYOUT_UPDATED
String to attach to signal “layout-updated”
#define DBUSMENU_SERVER_SIGNAL_ITEM_ACTIVATION "item-activation-requested"
String to attach to signal “item-activation-requested”
#define DBUSMENU_SERVER_PROP_DBUS_OBJECT "dbus-object"
String to access property “dbus-object”
#define DBUSMENU_SERVER_PROP_ROOT_NODE "root-node"
String to access property “root-node”
#define DBUSMENU_SERVER_PROP_STATUS "status"
String to access property “status”
#define DBUSMENU_SERVER_PROP_TEXT_DIRECTION "text-direction"
String to access property “text-direction”
#define DBUSMENU_SERVER_PROP_VERSION "version"
String to access property “version”
struct DbusmenuServer { };
A server which represents a sharing of a set of DbusmenuMenuitems across DBus to a DbusmenuClient.