gtkaction.h 5.52 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27
/*
 * GTK - The GIMP Toolkit
 * Copyright (C) 1998, 1999 Red Hat, Inc.
 * All rights reserved.
 *
 * This Library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public License as
 * published by the Free Software Foundation; either version 2 of the
 * License, 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
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with the Gnome Library; see the file COPYING.LIB.  If not,
 * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

/*
 * Author: James Henstridge <james@daa.com.au>
 *
 * Modified by the GTK+ Team and others 2003.  See the AUTHORS
 * file for a list of people on the GTK+ Team.  See the ChangeLog
 * files for a list of changes.  These files are distributed with
28
 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
29
 */
30 31 32 33 34

#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif

35 36 37 38 39
#ifndef __GTK_ACTION_H__
#define __GTK_ACTION_H__

#include <gtk/gtkwidget.h>

40 41
G_BEGIN_DECLS

42 43 44 45
#define GTK_TYPE_ACTION            (gtk_action_get_type ())
#define GTK_ACTION(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_ACTION, GtkAction))
#define GTK_ACTION_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_ACTION, GtkActionClass))
#define GTK_IS_ACTION(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_ACTION))
46
#define GTK_IS_ACTION_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_ACTION))
47 48 49 50 51 52 53 54 55 56 57 58
#define GTK_ACTION_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS((obj), GTK_TYPE_ACTION, GtkActionClass))

typedef struct _GtkAction      GtkAction;
typedef struct _GtkActionClass GtkActionClass;
typedef struct _GtkActionPrivate GtkActionPrivate;

struct _GtkAction
{
  GObject object;

  /*< private >*/

Tim Janik's avatar
Tim Janik committed
59
  GtkActionPrivate *GSEAL (private_data);
60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79
};

struct _GtkActionClass
{
  GObjectClass parent_class;

  /* activation signal */
  void       (* activate)           (GtkAction    *action);

  GType      menu_item_type;
  GType      toolbar_item_type;

  /* widget creation routines (not signals) */
  GtkWidget *(* create_menu_item)   (GtkAction *action);
  GtkWidget *(* create_tool_item)   (GtkAction *action);
  void       (* connect_proxy)      (GtkAction *action,
				     GtkWidget *proxy);
  void       (* disconnect_proxy)   (GtkAction *action,
				     GtkWidget *proxy);

80
  GtkWidget *(* create_menu)        (GtkAction *action);
81

82 83 84 85 86 87
  /* Padding for future expansion */
  void (*_gtk_reserved2) (void);
  void (*_gtk_reserved3) (void);
  void (*_gtk_reserved4) (void);
};

Matthias Clasen's avatar
Matthias Clasen committed
88
GType        gtk_action_get_type               (void) G_GNUC_CONST;
89 90 91 92
GtkAction   *gtk_action_new                    (const gchar *name,
						const gchar *label,
						const gchar *tooltip,
						const gchar *stock_id);
93
G_CONST_RETURN gchar* gtk_action_get_name      (GtkAction     *action);
94 95
gboolean     gtk_action_is_sensitive           (GtkAction     *action);
gboolean     gtk_action_get_sensitive          (GtkAction     *action);
96 97
void         gtk_action_set_sensitive          (GtkAction     *action,
						gboolean       sensitive);
98 99
gboolean     gtk_action_is_visible             (GtkAction     *action);
gboolean     gtk_action_get_visible            (GtkAction     *action);
100 101
void         gtk_action_set_visible            (GtkAction     *action,
						gboolean       visible);
102
void         gtk_action_activate               (GtkAction     *action);
103
GtkWidget *  gtk_action_create_icon            (GtkAction     *action,
104
						GtkIconSize    icon_size);
105 106 107
GtkWidget *  gtk_action_create_menu_item       (GtkAction     *action);
GtkWidget *  gtk_action_create_tool_item       (GtkAction     *action);
GtkWidget *  gtk_action_create_menu            (GtkAction     *action);
108 109 110 111
void         gtk_action_connect_proxy          (GtkAction     *action,
						GtkWidget     *proxy);
void         gtk_action_disconnect_proxy       (GtkAction     *action,
						GtkWidget     *proxy);
112 113
GSList *     gtk_action_get_proxies            (GtkAction     *action);
GtkAction *  gtk_widget_get_action             (GtkWidget     *widget);
114 115
void         gtk_action_connect_accelerator    (GtkAction     *action);
void         gtk_action_disconnect_accelerator (GtkAction     *action);
116
G_CONST_RETURN gchar *gtk_action_get_accel_path (GtkAction     *action);
117
GClosure    *gtk_action_get_accel_closure      (GtkAction     *action);
118 119

/* protected ... for use by child actions */
120 121 122 123
void         gtk_action_block_activate_from    (GtkAction     *action,
						GtkWidget     *proxy);
void         gtk_action_unblock_activate_from  (GtkAction     *action,
						GtkWidget     *proxy);
124
void         _gtk_action_emit_activate         (GtkAction     *action);
125 126

/* protected ... for use by action groups */
127 128 129 130
void         gtk_action_set_accel_path         (GtkAction     *action,
						const gchar   *accel_path);
void         gtk_action_set_accel_group        (GtkAction     *action,
						GtkAccelGroup *accel_group);
131 132 133 134 135
void         _gtk_action_sync_sensitive        (GtkAction     *action);
void         _gtk_action_sync_visible          (GtkAction     *action);
void         _gtk_action_sync_menu_visible     (GtkAction     *action,
						GtkWidget     *proxy,
						gboolean       empty);
136

137
G_END_DECLS
138 139

#endif  /* __GTK_ACTION_H__ */