## DbusmenuGtkClient

DbusmenuGtkClient

## Synopsis

    #define             DBUSMENU_GTKCLIENT_TYPE
    #define             DBUSMENU_GTKCLIENT_SIGNAL_ROOT_CHANGED
                        DbusmenuGtkClientClass;
    DbusmenuGtkClient * dbusmenu_gtkclient_new              (gchar *dbus_name,
                                                             gchar *dbus_object);
    GtkMenuItem *       dbusmenu_gtkclient_menuitem_get     (DbusmenuGtkClient *client,
                                                             DbusmenuMenuitem *item);
    GtkMenu *           dbusmenu_gtkclient_menuitem_get_submenu
                                                            (DbusmenuGtkClient *client,
                                                             DbusmenuMenuitem *item);
    void                dbusmenu_gtkclient_newitem_base     (DbusmenuGtkClient *client,
                                                             DbusmenuMenuitem *item,
                                                             GtkMenuItem *gmi,
                                                             DbusmenuMenuitem *parent);

## Description

## Details

### DBUSMENU_GTKCLIENT_TYPE

    #define DBUSMENU_GTKCLIENT_TYPE            (dbusmenu_gtkclient_get_type ())

### DBUSMENU_GTKCLIENT_SIGNAL_ROOT_CHANGED

    #define DBUSMENU_GTKCLIENT_SIGNAL_ROOT_CHANGED  DBUSMENU_CLIENT_SIGNAL_ROOT_CHANGED

### DbusmenuGtkClientClass

    typedef struct {
    	DbusmenuClientClass parent_class;

    	/* Signals */
    	void (*root_changed) (DbusmenuMenuitem * newroot);

    	/* Reserved */
    	void (*reserved1) (void);
    	void (*reserved2) (void);
    	void (*reserved3) (void);
    	void (*reserved4) (void);
    } DbusmenuGtkClientClass;

DbusmenuClientClass `parent_class`; | GtkMenuClass
`root_changed` () |
`reserved1` () | Reserved for future use.
`reserved2` () | Reserved for future use.
`reserved3` () | Reserved for future use.
`reserved4` () | Reserved for future use.

### dbusmenu_gtkclient_new ()

    DbusmenuGtkClient * dbusmenu_gtkclient_new              (gchar *dbus_name,
                                                             gchar *dbus_object);

Creates a new DbusmenuGtkClient object and creates a DbusmenuClient that connects across DBus to a DbusmenuServer.

`dbus_name` : | Name of the DbusmenuServer on DBus
`dbus_object` : |
Returns : | A new DbusmenuGtkClient sync'd with a server

### dbusmenu_gtkclient_menuitem_get ()

    GtkMenuItem *       dbusmenu_gtkclient_menuitem_get     (DbusmenuGtkClient *client,
                                                             DbusmenuMenuitem *item);

This grabs the GtkMenuItem that is associated with the DbusmenuMenuitem.

`client` : | A DbusmenuGtkClient with the item in it.
`item` : | DbusmenuMenuitem to get associated GtkMenuItem on.
Returns : | The GtkMenuItem that can be played with.

### dbusmenu_gtkclient_menuitem_get_submenu ()

    GtkMenu *           dbusmenu_gtkclient_menuitem_get_submenu
                                                            (DbusmenuGtkClient *client,
                                                             DbusmenuMenuitem *item);

This grabs the submenu associated with the menuitem.

`client` : | A DbusmenuGtkClient with the item in it.
`item` : | DbusmenuMenuitem to get associated GtkMenu on.
Returns : | The GtkMenu if there is one.

### dbusmenu_gtkclient_newitem_base ()

    void                dbusmenu_gtkclient_newitem_base     (DbusmenuGtkClient *client,
                                                             DbusmenuMenuitem *item,
                                                             GtkMenuItem *gmi,
                                                             DbusmenuMenuitem *parent);

This function provides some of the basic connectivity for being in the GTK world. Things like visibility and sensitivity of the item are handled here so that the subclasses don't have to. If you're building your on GTK menu item you can use this function to apply those basic attributes so that you don't have to deal with them either.

This also handles passing the "activate" signal back to the DbusmenuMenuitem side of thing.

`client` : | The client handling everything on this connection
`item` : | The DbusmenuMenuitem to attach the GTK-isms to
`gmi` : | A GtkMenuItem representing the GTK world's view of this menuitem
`parent` : | The parent DbusmenuMenuitem