forked from AuroraMiddleware/gtk
bb72b647f6
Rework the way actions and proxies interact, to make the
interaction less ad hoc, more extensible, and better suited
for support in GUI builders like glade.
To be used as a proxy, a widget must now implement the
GtkActivatable interface, and GtkActivatable implementations
are responsible for syncing their appearance with the action
and for activating the action.
All the widgets that are commonly used as proxies implement
GtkActivatable now.
Patch by Tristan van Berkom.
* gtk/gtkactivatable.[hc]: The GtkActivatable interface.
* gtk/gtkbutton.c:
* gtk/gtktogglebutton.c:
* gtk/gtktoolitem.c:
* gtk/gtktoolbutton.c:
* gtk/gtktoggletoolbutton.c:
* gtk/gtkmenuitem.c:
* gtk/gtkcheckmenuitem.c:
* gtk/gtkimagemenuitem.c:
* gtk/gtkradiomenuitem.c:
* gtk/gtkrecentchooserprivate.h:
* gtk/gtkrecentchooser.c:
* gtk/gtkrecentchooserdefault.c:
* gtk/gtkrecentchoosermenu.c: Implement GtkActivatable.
* gtk/gtkaction.[hc]: Move appearance synchronization to
GtkActivatable implementations.
* gtk/gtkradioaction.c:
* gtk/gtkrecentaction.c:
* gtk/gtktoggleaction.c:
* gtk/gtkactiongroup.c: Adapt.
* gtk/gtk.h: Include gtkactivatable.h
* gtk/gtk.symbols: Add new functions
svn path=/trunk/; revision=22195
178 lines
7.9 KiB
C
178 lines
7.9 KiB
C
/*
|
|
* 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
|
|
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
|
|
*/
|
|
|
|
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
|
|
#error "Only <gtk/gtk.h> can be included directly."
|
|
#endif
|
|
|
|
#ifndef __GTK_ACTION_H__
|
|
#define __GTK_ACTION_H__
|
|
|
|
#include <gtk/gtkwidget.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#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))
|
|
#define GTK_IS_ACTION_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_ACTION))
|
|
#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 >*/
|
|
|
|
GtkActionPrivate *GSEAL (private_data);
|
|
};
|
|
|
|
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);
|
|
|
|
GtkWidget *(* create_menu) (GtkAction *action);
|
|
|
|
/* Padding for future expansion */
|
|
void (*_gtk_reserved2) (void);
|
|
void (*_gtk_reserved3) (void);
|
|
void (*_gtk_reserved4) (void);
|
|
};
|
|
|
|
GType gtk_action_get_type (void) G_GNUC_CONST;
|
|
GtkAction *gtk_action_new (const gchar *name,
|
|
const gchar *label,
|
|
const gchar *tooltip,
|
|
const gchar *stock_id);
|
|
G_CONST_RETURN gchar* gtk_action_get_name (GtkAction *action);
|
|
gboolean gtk_action_is_sensitive (GtkAction *action);
|
|
gboolean gtk_action_get_sensitive (GtkAction *action);
|
|
void gtk_action_set_sensitive (GtkAction *action,
|
|
gboolean sensitive);
|
|
gboolean gtk_action_is_visible (GtkAction *action);
|
|
gboolean gtk_action_get_visible (GtkAction *action);
|
|
void gtk_action_set_visible (GtkAction *action,
|
|
gboolean visible);
|
|
void gtk_action_activate (GtkAction *action);
|
|
GtkWidget * gtk_action_create_icon (GtkAction *action,
|
|
GtkIconSize icon_size);
|
|
GtkWidget * gtk_action_create_menu_item (GtkAction *action);
|
|
GtkWidget * gtk_action_create_tool_item (GtkAction *action);
|
|
GtkWidget * gtk_action_create_menu (GtkAction *action);
|
|
GSList * gtk_action_get_proxies (GtkAction *action);
|
|
void gtk_action_connect_accelerator (GtkAction *action);
|
|
void gtk_action_disconnect_accelerator (GtkAction *action);
|
|
G_CONST_RETURN gchar *gtk_action_get_accel_path (GtkAction *action);
|
|
GClosure *gtk_action_get_accel_closure (GtkAction *action);
|
|
|
|
#ifndef GTK_DISABLE_DEPRECATED
|
|
GtkAction *gtk_widget_get_action (GtkWidget *widget);
|
|
void gtk_action_connect_proxy (GtkAction *action,
|
|
GtkWidget *proxy);
|
|
void gtk_action_disconnect_proxy (GtkAction *action,
|
|
GtkWidget *proxy);
|
|
void gtk_action_block_activate_from (GtkAction *action,
|
|
GtkWidget *proxy);
|
|
void gtk_action_unblock_activate_from (GtkAction *action,
|
|
GtkWidget *proxy);
|
|
#endif /* GTK_DISABLE_DEPRECATED */
|
|
void gtk_action_block_activate (GtkAction *action);
|
|
void gtk_action_unblock_activate (GtkAction *action);
|
|
|
|
|
|
void _gtk_action_add_to_proxy_list (GtkAction *action,
|
|
GtkWidget *proxy);
|
|
void _gtk_action_remove_from_proxy_list(GtkAction *action,
|
|
GtkWidget *proxy);
|
|
|
|
/* protected ... for use by child actions */
|
|
void _gtk_action_emit_activate (GtkAction *action);
|
|
|
|
/* protected ... for use by action groups */
|
|
void gtk_action_set_accel_path (GtkAction *action,
|
|
const gchar *accel_path);
|
|
void gtk_action_set_accel_group (GtkAction *action,
|
|
GtkAccelGroup *accel_group);
|
|
void _gtk_action_sync_menu_visible (GtkAction *action,
|
|
GtkWidget *proxy,
|
|
gboolean empty);
|
|
|
|
void gtk_action_set_label (GtkAction *action,
|
|
const gchar *label);
|
|
G_CONST_RETURN gchar *gtk_action_get_label (GtkAction *action);
|
|
void gtk_action_set_short_label (GtkAction *action,
|
|
const gchar *short_label);
|
|
G_CONST_RETURN gchar *gtk_action_get_short_label (GtkAction *action);
|
|
void gtk_action_set_tooltip (GtkAction *action,
|
|
const gchar *tooltip);
|
|
G_CONST_RETURN gchar *gtk_action_get_tooltip (GtkAction *action);
|
|
void gtk_action_set_stock_id (GtkAction *action,
|
|
const gchar *stock_id);
|
|
G_CONST_RETURN gchar *gtk_action_get_stock_id (GtkAction *action);
|
|
void gtk_action_set_gicon (GtkAction *action,
|
|
GIcon *icon);
|
|
GIcon *gtk_action_get_gicon (GtkAction *action);
|
|
void gtk_action_set_icon_name (GtkAction *action,
|
|
const gchar *icon_name);
|
|
G_CONST_RETURN gchar *gtk_action_get_icon_name (GtkAction *action);
|
|
void gtk_action_set_visible_horizontal (GtkAction *action,
|
|
gboolean visible_horizontal);
|
|
gboolean gtk_action_get_visible_horizontal (GtkAction *action);
|
|
void gtk_action_set_visible_vertical (GtkAction *action,
|
|
gboolean visible_vertical);
|
|
gboolean gtk_action_get_visible_vertical (GtkAction *action);
|
|
void gtk_action_set_is_important (GtkAction *action,
|
|
gboolean is_important);
|
|
gboolean gtk_action_get_is_important (GtkAction *action);
|
|
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GTK_ACTION_H__ */
|