← Back to branch summary

~ubuntu-branches/ubuntu/lucid/libdbusmenu/lucid

« back to all changes in this revision

Viewing changes to libdbusmenu-glib/menuitem.h

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher, Ted Gould
  • Date: 2010-02-04 13:56:49 UTC
  • mfrom: (1.1.10 upstream)
  • Revision ID: james.westby@ubuntu.com-20100204135649-pe86ycwm3xyn0dlu
Tags: 0.2.2-0ubuntu1
* Updated for the soname changes

[ Ted Gould ]
* Upstream Release 0.2.2
  * Interoperability fixes
  * Adding timestamps to events
  * Better handling of XML
  * Adding tools for timing dbusmenu
* debian/libdbusmenu-tools.install: Adding a wildcard to get
  all of the tools in libexec

Show diffs side-by-side

added added

removed removed

Lines of Context:
libdbusmenu-glib/menuitem.h
52
52
 
53
53
#define DBUSMENU_MENUITEM_PROP_TYPE                  "type"
54
54
#define DBUSMENU_MENUITEM_PROP_VISIBLE               "visible"
55
 
#define DBUSMENU_MENUITEM_PROP_SENSITIVE             "sensitive"
 
55
#define DBUSMENU_MENUITEM_PROP_ENABLED               "enabled"
56
56
#define DBUSMENU_MENUITEM_PROP_LABEL                 "label"
57
 
#define DBUSMENU_MENUITEM_PROP_ICON                  "icon"
 
57
#define DBUSMENU_MENUITEM_PROP_ICON_NAME             "icon-name"
58
58
#define DBUSMENU_MENUITEM_PROP_ICON_DATA             "icon-data"
59
59
#define DBUSMENU_MENUITEM_PROP_TOGGLE_TYPE           "toggle-type"
60
 
#define DBUSMENU_MENUITEM_PROP_TOGGLE_CHECKED        "toggle-checked"
 
60
#define DBUSMENU_MENUITEM_PROP_TOGGLE_STATE          "toggle-state"
61
61
 
62
62
#define DBUSMENU_MENUITEM_TOGGLE_CHECK               "checkmark"
63
63
#define DBUSMENU_MENUITEM_TOGGLE_RADIO               "radio"
64
64
 
65
 
#define DBUSMENU_MENUITEM_TOGGLE_STATE_UNCHECKED     "unchecked"
66
 
#define DBUSMENU_MENUITEM_TOGGLE_STATE_CHECKED       "checked"
67
 
#define DBUSMENU_MENUITEM_TOGGLE_STATE_UNKNOWN       "indeterminate"
 
65
#define DBUSMENU_MENUITEM_TOGGLE_STATE_UNCHECKED     0
 
66
#define DBUSMENU_MENUITEM_TOGGLE_STATE_CHECKED       1
 
67
#define DBUSMENU_MENUITEM_TOGGLE_STATE_UNKNOWN       -1
68
68
 
69
69
/**
70
70
        DbusmenuMenuitem:
92
92
        @realized: Slot for #DbusmenuMenuitem::realized.
93
93
        @buildxml: Virtual function that appends the strings required
94
94
                   to represent this menu item in the menu XML file.
 
95
        @handle_event: This function is to override how events are handled
 
96
                        by subclasses.  Look at #dbusmenu_menuitem_handle_event for
 
97
                        lots of good information.
95
98
        @reserved1: Reserved for future use.
96
99
        @reserved2: Reserved for future use.
97
100
        @reserved3: Reserved for future use.
104
107
 
105
108
        /* Signals */
106
109
        void (*property_changed) (gchar * property, GValue * value);
107
 
        void (*item_activated) (void);
 
110
        void (*item_activated) (guint timestamp);
108
111
        void (*child_added) (DbusmenuMenuitem * child, guint position);
109
112
        void (*child_removed) (DbusmenuMenuitem * child);
110
113
        void (*child_moved) (DbusmenuMenuitem * child, guint newpos, guint oldpos);
112
115
 
113
116
        /* Virtual functions */
114
117
        void (*buildxml) (GPtrArray * stringarray);
 
118
        void (*handle_event) (DbusmenuMenuitem * mi, const gchar * name, const GValue * value, guint timestamp);
115
119
 
116
120
        void (*reserved1) (void);
117
121
        void (*reserved2) (void);
118
 
        void (*reserved3) (void);
 
122
        /* void (*reserved3) (void); */
119
123
        /* void (*reserved4) (void); -- realized, realloc when bumping lib version */
120
124
};
121
125
 
122
126
GType dbusmenu_menuitem_get_type (void);
123
127
 
124
128
DbusmenuMenuitem * dbusmenu_menuitem_new (void) G_GNUC_WARN_UNUSED_RESULT;
125
 
DbusmenuMenuitem * dbusmenu_menuitem_new_with_id (guint id) G_GNUC_WARN_UNUSED_RESULT;
 
129
DbusmenuMenuitem * dbusmenu_menuitem_new_with_id (gint id) G_GNUC_WARN_UNUSED_RESULT;
126
130
guint dbusmenu_menuitem_get_id (DbusmenuMenuitem * mi);
127
131
 
128
132
GList * dbusmenu_menuitem_get_children (DbusmenuMenuitem * mi);
134
138
gboolean dbusmenu_menuitem_child_delete (DbusmenuMenuitem * mi, DbusmenuMenuitem * child);
135
139
gboolean dbusmenu_menuitem_child_add_position (DbusmenuMenuitem * mi, DbusmenuMenuitem * child, guint position);
136
140
gboolean dbusmenu_menuitem_child_reorder (DbusmenuMenuitem * mi, DbusmenuMenuitem * child, guint position);
137
 
DbusmenuMenuitem * dbusmenu_menuitem_child_find (DbusmenuMenuitem * mi, guint id);
138
 
DbusmenuMenuitem * dbusmenu_menuitem_find_id (DbusmenuMenuitem * mi, guint id);
 
141
DbusmenuMenuitem * dbusmenu_menuitem_child_find (DbusmenuMenuitem * mi, gint id);
 
142
DbusmenuMenuitem * dbusmenu_menuitem_find_id (DbusmenuMenuitem * mi, gint id);
139
143
 
140
144
gboolean dbusmenu_menuitem_property_set (DbusmenuMenuitem * mi, const gchar * property, const gchar * value);
141
145
gboolean dbusmenu_menuitem_property_set_value (DbusmenuMenuitem * mi, const gchar * property, const GValue * value);
153
157
gboolean dbusmenu_menuitem_get_root (DbusmenuMenuitem * mi);
154
158
 
155
159
void dbusmenu_menuitem_foreach (DbusmenuMenuitem * mi, void (*func) (DbusmenuMenuitem * mi, gpointer data), gpointer data);
156
 
void dbusmenu_menuitem_activate (DbusmenuMenuitem * mi);
 
160
void dbusmenu_menuitem_handle_event (DbusmenuMenuitem * mi, const gchar * name, const GValue * value, guint timestamp);
157
161
 
158
162
/**
159
163
        SECTION:menuitem