gtksignal.h 6.96 KB
Newer Older
Elliot Lee's avatar
Elliot Lee committed
1 2 3 4 5 6 7 8 9 10
/* GTK - The GIMP Toolkit
 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
 *
 * 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
11
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
Elliot Lee's avatar
Elliot Lee committed
12 13 14
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
15 16 17
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
Elliot Lee's avatar
Elliot Lee committed
18 19 20 21 22 23 24 25
 */
#ifndef __GTK_SIGNAL_H__
#define __GTK_SIGNAL_H__


#include <gdk/gdk.h>
#include <gtk/gtkenums.h>
#include <gtk/gtkobject.h>
Elliot Lee's avatar
Elliot Lee committed
26
#include <gtk/gtkmarshal.h>
Elliot Lee's avatar
Elliot Lee committed
27 28 29 30 31

#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */

32
  
33
#define GTK_SIGNAL_OFFSET(struct, field)	(GTK_STRUCT_OFFSET (struct, field))
34
  
35
  
36
typedef void    (*GtkSignalMarshal) (GtkObject	    *object,
37 38 39 40 41
				     gpointer	     data,
				     guint	     nparams,
				     GtkArg	    *args,
				     GtkType	    *arg_types,
				     GtkType	     return_type);
42 43 44
typedef void    (*GtkSignalDestroy) (gpointer	     data);
typedef gboolean (*GtkEmissionHook) (GtkObject	    *object,
				     guint           signal_id,
45 46
				     guint	     n_params,
				     GtkArg	    *params,
47 48
				     gpointer        data);

Elliot Lee's avatar
Elliot Lee committed
49

50 51 52 53
typedef struct _GtkSignalQuery		GtkSignalQuery;

struct	_GtkSignalQuery
{
54 55
  GtkType	   object_type;
  guint		   signal_id;
56
  const gchar	  *signal_name;
57
  guint		   is_user_signal : 1;
58
  GtkSignalRunType signal_flags;
59 60 61 62
  GtkType	   return_val;
  guint		   nparams;
  const GtkType	  *params;
};
Elliot Lee's avatar
Elliot Lee committed
63

64
void   gtk_signal_init			  (void);
65
guint  gtk_signal_new			  (const gchar	       *name,
66
					   GtkSignalRunType	signal_flags,
67 68 69 70 71
					   GtkType		object_type,
					   guint		function_offset,
					   GtkSignalMarshaller	marshaller,
					   GtkType		return_val,
					   guint		nparams,
Elliot Lee's avatar
Elliot Lee committed
72
					   ...);
73
guint  gtk_signal_newv			  (const gchar	       *name,
74
					   GtkSignalRunType	signal_flags,
75 76 77 78 79
					   GtkType		object_type,
					   guint		function_offset,
					   GtkSignalMarshaller	marshaller,
					   GtkType		return_val,
					   guint		nparams,
80
					   GtkType	       *params);
81 82 83 84 85
guint  gtk_signal_lookup		  (const gchar	       *name,
					   GtkType		object_type);
gchar* gtk_signal_name			  (guint		signal_id);
void   gtk_signal_emit			  (GtkObject	       *object,
					   guint		signal_id,
Elliot Lee's avatar
Elliot Lee committed
86
					   ...);
87 88
void   gtk_signal_emit_by_name		  (GtkObject	       *object,
					   const gchar	       *name,
Elliot Lee's avatar
Elliot Lee committed
89
					   ...);
90 91 92 93 94 95
void   gtk_signal_emitv			  (GtkObject           *object,
					   guint                signal_id,
					   GtkArg              *params);
void   gtk_signal_emitv_by_name		  (GtkObject           *object,
					   const gchar	       *name,
					   GtkArg              *params);
96 97 98 99
guint  gtk_signal_n_emissions		  (GtkObject   	       *object,
					   guint                signal_id);
guint  gtk_signal_n_emissions_by_name	  (GtkObject   	       *object,
					   const gchar         *name);
100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129
void   gtk_signal_emit_stop		  (GtkObject	       *object,
					   guint		signal_id);
void   gtk_signal_emit_stop_by_name	  (GtkObject	       *object,
					   const gchar	       *name);
guint  gtk_signal_connect		  (GtkObject	       *object,
					   const gchar	       *name,
					   GtkSignalFunc	func,
					   gpointer		func_data);
guint  gtk_signal_connect_after		  (GtkObject	       *object,
					   const gchar	       *name,
					   GtkSignalFunc	func,
					   gpointer		func_data);
guint  gtk_signal_connect_object	  (GtkObject	       *object,
					   const gchar	       *name,
					   GtkSignalFunc	func,
					   GtkObject	       *slot_object);
guint  gtk_signal_connect_object_after	  (GtkObject	       *object,
					   const gchar	       *name,
					   GtkSignalFunc	func,
					   GtkObject	       *slot_object);
guint  gtk_signal_connect_full		  (GtkObject	       *object,
					   const gchar	       *name,
					   GtkSignalFunc	func,
					   GtkCallbackMarshal	marshal,
					   gpointer		data,
					   GtkDestroyNotify	destroy_func,
					   gint			object_signal,
					   gint			after);

void   gtk_signal_connect_object_while_alive (GtkObject	       *object,
130
					      const gchar      *signal,
131 132 133
					      GtkSignalFunc	func,
					      GtkObject	       *alive_object);
void   gtk_signal_connect_while_alive	     (GtkObject	       *object,
134
					      const gchar      *signal,
135 136 137 138 139 140
					      GtkSignalFunc	func,
					      gpointer		func_data,
					      GtkObject	       *alive_object);

void   gtk_signal_disconnect		  (GtkObject	       *object,
					   guint		handler_id);
141 142 143
void   gtk_signal_disconnect_by_func	  (GtkObject	       *object,
					   GtkSignalFunc	func,
					   gpointer		data);
144 145 146 147
void   gtk_signal_disconnect_by_data	  (GtkObject	       *object,
					   gpointer		data);
void   gtk_signal_handler_block		  (GtkObject	       *object,
					   guint		handler_id);
148 149 150
void   gtk_signal_handler_block_by_func	  (GtkObject	       *object,
					   GtkSignalFunc	func,
					   gpointer		data);
151 152 153 154
void   gtk_signal_handler_block_by_data	  (GtkObject	       *object,
					   gpointer		data);
void   gtk_signal_handler_unblock	  (GtkObject	       *object,
					   guint		handler_id);
155 156 157
void   gtk_signal_handler_unblock_by_func (GtkObject	       *object,
					   GtkSignalFunc	func,
					   gpointer		data);
158 159
void   gtk_signal_handler_unblock_by_data (GtkObject	       *object,
					   gpointer		data);
160
guint  gtk_signal_handler_pending	  (GtkObject	       *object,
161
					   guint		signal_id,
162
					   gboolean		may_be_blocked);
163 164 165 166 167
guint  gtk_signal_handler_pending_by_func (GtkObject	       *object,
					   guint		signal_id,
					   gboolean		may_be_blocked,
					   GtkSignalFunc	func,
					   gpointer		data);
168
void   gtk_signal_handlers_destroy	  (GtkObject	       *object);
169 170 171 172 173 174 175 176 177 178
guint  gtk_signal_add_emission_hook	  (guint		signal_id,
					   GtkEmissionHook	hook_func,
					   gpointer       	data);
guint  gtk_signal_add_emission_hook_full  (guint		signal_id,
					   GtkEmissionHook	hook_func,
					   gpointer       	data,
					   GDestroyNotify	destroy);
void   gtk_signal_remove_emission_hook	  (guint		signal_id,
					   guint		hook_id);

179 180
void   gtk_signal_set_funcs		  (GtkSignalMarshal	marshal_func,
					   GtkSignalDestroy	destroy_func);
Elliot Lee's avatar
Elliot Lee committed
181

182
/* Report internal information about a signal. The caller has the
183 184
 * responsibility to invoke a subsequent g_free (returned_data); but
 * must not modify data pointed to by the members of GtkSignalQuery 
185
 */
186
GtkSignalQuery* gtk_signal_query	  (guint		signal_id);
187

188 189 190 191 192 193 194
/* deprecated */
guint  gtk_signal_connect_interp	  (GtkObject	       *object,
					   const gchar	       *name,
					   GtkCallbackMarshal	func,
					   gpointer		data,
					   GtkDestroyNotify	destroy_func,
					   gint			after);
Elliot Lee's avatar
Elliot Lee committed
195 196 197 198 199 200 201

#ifdef __cplusplus
}
#endif /* __cplusplus */


#endif /* __GTK_SIGNAL_H__ */