introduce private GtkActionHelper

The current process of implementing GActionObserver is annoying and the
GSimpleActionObserver interface leaves a lot to be desired.  Introduce a
new class, GtkActionHelper that gives you pretty much everything you'd
want to do as an implementor of GtkActionable.

The GtkActionHelper also features an "application" mode that is not
associated with a particular GtkWidget but rather with whatever widget
happens to be the active window of the given GtkApplication at a
particular point in time.  This will be useful for the Mac OS menubar.

1 files changed, 71 insertions, 0 deletions

diff --git a/gtk/gtkactionhelper.h b/gtk/gtkactionhelper.h
new file mode 100644
index 0000000000..bc54357dd9
--- /dev/null
+++ b/gtk/gtkactionhelper.h
@@ -0,0 +1,71 @@
+/*
+ * Copyright © 2012 Canonical Limited
+ *
+ * This library is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2 of the
+ * licence or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Authors: Ryan Lortie <desrt@desrt.ca>
+ */
+
+#ifndef __GTK_ACTION_HELPER_H__
+#define __GTK_ACTION_HELPER_H__
+
+#include <gtk/gtkapplication.h>
+#include <gtk/gtkactionable.h>
+
+#define GTK_TYPE_ACTION_HELPER                              (gtk_action_helper_get_type ())
+#define GTK_ACTION_HELPER(inst)                             (G_TYPE_CHECK_INSTANCE_CAST ((inst),                      \
+                                                             GTK_TYPE_ACTION_HELPER, GtkActionHelper))
+#define GTK_IS_ACTION_HELPER(inst)                          (G_TYPE_CHECK_INSTANCE_TYPE ((inst),                      \
+                                                             GTK_TYPE_ACTION_HELPER))
+
+typedef struct _GtkActionHelper                             GtkActionHelper;
+
+typedef enum
+{
+  GTK_ACTION_HELPER_ROLE_NORMAL,
+  GTK_ACTION_HELPER_ROLE_TOGGLE,
+  GTK_ACTION_HELPER_ROLE_RADIO
+} GtkActionHelperRole;
+
+G_GNUC_INTERNAL
+GType                   gtk_action_helper_get_type                      (void);
+
+G_GNUC_INTERNAL
+GtkActionHelper *       gtk_action_helper_new                           (GtkActionable   *widget);
+
+G_GNUC_INTERNAL
+GtkActionHelper *       gtk_action_helper_new_with_application          (GtkApplication  *application);
+
+G_GNUC_INTERNAL
+void                    gtk_action_helper_set_action_name               (GtkActionHelper *helper,
+                                                                         const gchar     *action_name);
+G_GNUC_INTERNAL
+void                    gtk_action_helper_set_action_target_value       (GtkActionHelper *helper,
+                                                                         GVariant        *action_target);
+G_GNUC_INTERNAL
+const gchar *           gtk_action_helper_get_action_name               (GtkActionHelper *helper);
+G_GNUC_INTERNAL
+GVariant *              gtk_action_helper_get_action_target_value       (GtkActionHelper *helper);
+
+G_GNUC_INTERNAL
+GtkActionHelperRole     gtk_action_helper_get_role                      (GtkActionHelper *helper);
+G_GNUC_INTERNAL
+gboolean                gtk_action_helper_get_enabled                   (GtkActionHelper *helper);
+G_GNUC_INTERNAL
+gboolean                gtk_action_helper_get_active                    (GtkActionHelper *helper);
+
+G_GNUC_INTERNAL
+void                    gtk_action_helper_activate                      (GtkActionHelper *helper);
+
+#endif /* __GTK_ACTION_HELPER_H__ */