gtk2/gtk/gtkactionhelper.h
Ryan Lortie 652f16dd98 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.
2012-08-20 13:11:01 -04:00

72 lines
3.1 KiB
C

/*
* 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__ */