diff options
author | Ted Gould <ted@canonical.com> | 2009-05-11 16:32:15 -0500 |
---|---|---|
committer | Ted Gould <ted@canonical.com> | 2009-05-11 16:32:15 -0500 |
commit | 4a07417b44809c7444fdde2ed611161e2b8e5c05 (patch) | |
tree | 8b4a6336c0ad44dd64015e6a6c2cf9e5c94b1224 | |
parent | afa84740cda0f8d24288a783c57283b75bb32bcf (diff) | |
download | libdbusmenu-4a07417b44809c7444fdde2ed611161e2b8e5c05.tar.gz libdbusmenu-4a07417b44809c7444fdde2ed611161e2b8e5c05.tar.bz2 libdbusmenu-4a07417b44809c7444fdde2ed611161e2b8e5c05.zip |
Object documentation. No gtk-doc yet, but getting ready.
-rw-r--r-- | libdbusmenu-glib/menuitem.h | 44 |
1 files changed, 42 insertions, 2 deletions
diff --git a/libdbusmenu-glib/menuitem.h b/libdbusmenu-glib/menuitem.h index b7d767c..732a7a6 100644 --- a/libdbusmenu-glib/menuitem.h +++ b/libdbusmenu-glib/menuitem.h @@ -13,12 +13,22 @@ G_BEGIN_DECLS #define DBUSMENU_IS_MENUITEM_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), DBUSMENU_TYPE_MENUITEM)) #define DBUSMENU_MENUITEM_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), DBUSMENU_TYPE_MENUITEM, DbusmenuMenuitemClass)) -typedef struct _DbusmenuMenuitem DbusmenuMenuitem; -typedef struct _DbusmenuMenuitemClass DbusmenuMenuitemClass; #define DBUSMENU_MENUITEM_SIGNAL_PROPERTY_CHANGED "property-changed" #define DBUSMENU_MENUITEM_SIGNAL_ITEM_ACTIVATED "item-activated" +/** + DbusmenuMenuitemClass: + @property_changed: Slot for #DbusmenuMenuitem::property-changed. + @item_activated: Slot for #DbusmenuMenuitem::item-activated. + @buildxml: Virtual function that appends the strings required + to represent this menu item in the menu XML file. + @reserved1: Reserved for future use. + @reserved2: Reserved for future use. + @reserved3: Reserved for future use. + @reserved4: Reserved for future use. +*/ +typedef struct _DbusmenuMenuitemClass DbusmenuMenuitemClass; struct _DbusmenuMenuitemClass { GObjectClass parent_class; @@ -36,6 +46,17 @@ struct _DbusmenuMenuitemClass void (*reserved4) (void); }; +/** + DbusmenuMenuitem: + + This is the #GObject based object that represents a menu + item. It gets created the same on both the client and + the server side and libdbusmenu-glib does the work of making + this object model appear on both sides of DBus. Simple + really, though through updates and people coming on and off + the bus it can lead to lots of fun complex scenarios. +*/ +typedef struct _DbusmenuMenuitem DbusmenuMenuitem; struct _DbusmenuMenuitem { GObject parent; @@ -62,6 +83,25 @@ gboolean dbusmenu_menuitem_property_exist (DbusmenuMenuitem * mi, const gchar * void dbusmenu_menuitem_buildxml (DbusmenuMenuitem * mi, GPtrArray * array); +/** + SECTION:menuitem + @short_description: A lowlevel represenation of a menuitem + @stability: Unstable + @include: libdbusmenu-glib/menuitem.h + + A #DbusmenuMenuitem is the lowest level of represenation of a + single item in a menu. It gets created on the server side + and copied over to the client side where it gets rendered. As + the server starts to change it, and grow it, and do all kinds + of fun stuff that information is transfered over DBus and the + client updates it's understanding of the object model. + + Most people using either the client or the server should be + able to deal mostly with #DbusmenuMenuitem objects. These + are simple, but then they can be attached to more complex + objects and handled appropriately. +*/ + G_END_DECLS #endif |