From 67088411a5637da0626febc660a91a98bed30a57 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Mon, 10 Jan 2005 05:44:45 +0000 Subject: [PATCH] Document signals. (#163319, Murray Cumming) 2005-01-10 Matthias Clasen * gtk/gtkaccelgroup.c (gtk_accel_group_class_init): Document signals. (#163319, Murray Cumming) --- ChangeLog | 5 +++++ ChangeLog.pre-2-10 | 5 +++++ ChangeLog.pre-2-6 | 5 +++++ ChangeLog.pre-2-8 | 5 +++++ gtk/gtkaccelgroup.c | 27 +++++++++++++++++++++++++++ 5 files changed, 47 insertions(+) diff --git a/ChangeLog b/ChangeLog index d0dd95463..ba3a18068 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2005-01-10 Matthias Clasen + + * gtk/gtkaccelgroup.c (gtk_accel_group_class_init): Document + signals. (#163319, Murray Cumming) + 2005-01-09 Tor Lillqvist * gdk/win32/gdkwindow-win32.c (gdk_window_set_cursor): Set current diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index d0dd95463..ba3a18068 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,8 @@ +2005-01-10 Matthias Clasen + + * gtk/gtkaccelgroup.c (gtk_accel_group_class_init): Document + signals. (#163319, Murray Cumming) + 2005-01-09 Tor Lillqvist * gdk/win32/gdkwindow-win32.c (gdk_window_set_cursor): Set current diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index d0dd95463..ba3a18068 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,8 @@ +2005-01-10 Matthias Clasen + + * gtk/gtkaccelgroup.c (gtk_accel_group_class_init): Document + signals. (#163319, Murray Cumming) + 2005-01-09 Tor Lillqvist * gdk/win32/gdkwindow-win32.c (gdk_window_set_cursor): Set current diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index d0dd95463..ba3a18068 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,8 @@ +2005-01-10 Matthias Clasen + + * gtk/gtkaccelgroup.c (gtk_accel_group_class_init): Document + signals. (#163319, Murray Cumming) + 2005-01-09 Tor Lillqvist * gdk/win32/gdkwindow-win32.c (gdk_window_set_cursor): Set current diff --git a/gtk/gtkaccelgroup.c b/gtk/gtkaccelgroup.c index 038d73179..49c5e29c3 100644 --- a/gtk/gtkaccelgroup.c +++ b/gtk/gtkaccelgroup.c @@ -97,6 +97,19 @@ gtk_accel_group_class_init (GtkAccelGroupClass *class) object_class->finalize = gtk_accel_group_finalize; class->accel_changed = NULL; + + /** + * GtkAccelGroup::accel-activate: + * @accel_group: the #GtkAccelGroup which received the signal + * @acceleratable: the object on which the accelerator was activated + * @keyval: the accelerator keyval + * @modifier: the modifier combination of the accelerator + * + * The accel-activate signal is an implementation detail of + * #GtkAccelGroup and not meant to be used by applications. + * + * Returns: %TRUE if the accelerator was activated + */ signal_accel_activate = g_signal_new ("accel_activate", G_OBJECT_CLASS_TYPE (class), @@ -108,6 +121,20 @@ gtk_accel_group_class_init (GtkAccelGroupClass *class) G_TYPE_OBJECT, G_TYPE_UINT, GDK_TYPE_MODIFIER_TYPE); + /** + * GtkAccelGroup::accel-changed: + * @accel_group: the #GtkAccelGroup which received the signal + * @keyval: the accelerator keyval + * @modifier: the modifier combination of the accelerator + * @accel_closure: the #GClosure of the accelerator + * + * The accel-changed signal is emitted when a #GtkAccelGroupEntry + * is added to or removed from the accel group. + * + * Widgets like #GtkAccelLabel which display an associated + * accelerator should connect to this signal, and rebuild + * their visual representation if the @accel_closure is theirs. + */ signal_accel_changed = g_signal_new ("accel_changed", G_OBJECT_CLASS_TYPE (class), -- 2.43.2