diff options
| author | Matthias Clasen <mclasen@redhat.com> | 2004-12-13 13:50:34 +0000 |
|---|---|---|
| committer | Matthias Clasen <matthiasc@src.gnome.org> | 2004-12-13 13:50:34 +0000 |
| commit | f94628ad42f67acb5ad7d5005b366fb2849c310a (patch) | |
| tree | 9ee947236edf3b39100f622c15b0b99ad61aafa1 /gtk | |
| parent | 50cbd51d269b36bf9e273a7743772e8cae23387a (diff) | |
| download | gtk+-f94628ad42f67acb5ad7d5005b366fb2849c310a.tar.gz | |
Add some docs for GtkWidget::delete-event and GtkWidget::destroy-event.
2004-12-13 Matthias Clasen <mclasen@redhat.com>
* gtk/gtkwidget.c (gtk_widget_class_init): Add some docs for
GtkWidget::delete-event and GtkWidget::destroy-event. (#161142,
Paolo Borelli)
Diffstat (limited to 'gtk')
| -rw-r--r-- | gtk/gtkwidget.c | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index 6de6e489e5..809c5ba2b6 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -755,6 +755,21 @@ gtk_widget_class_init (GtkWidgetClass *klass) _gtk_marshal_BOOLEAN__BOXED, G_TYPE_BOOLEAN, 1, GDK_TYPE_EVENT | G_SIGNAL_TYPE_STATIC_SCOPE); + +/** + * GtkWidget::delete-event: + * @widget: the object which received the signal. + * @event: the event which triggered this signal + * + * The ::delete-event signal is emitted if a user requests that + * a toplevel window is closed. The default handler for this signal + * destroys the window. Connecting gtk_widget_hide_on_delete() to + * this signal will cause the window to be hidden instead, so that + * it can later be shown again without reconstructing it. + * + * Returns: %TRUE to stop other handlers from being invoked for the event. + * %FALSE to propagate the event further. + */ widget_signals[DELETE_EVENT] = g_signal_new ("delete_event", G_TYPE_FROM_CLASS (gobject_class), @@ -764,6 +779,20 @@ gtk_widget_class_init (GtkWidgetClass *klass) _gtk_marshal_BOOLEAN__BOXED, G_TYPE_BOOLEAN, 1, GDK_TYPE_EVENT | G_SIGNAL_TYPE_STATIC_SCOPE); + +/** + * GtkWidget::destroy-event: + * @widget: the object which received the signal. + * @event: the event which triggered this signal + * + * The ::destroy-event signal is emitted when a #GdkWindow is destroyed. + * You rarely get this signal, because most widgets disconnect themselves + * from their window before they destroy it, so no widget owns the + * window at destroy time. + * + * Returns: %TRUE to stop other handlers from being invoked for the event. + * %FALSE to propagate the event further. + */ widget_signals[DESTROY_EVENT] = g_signal_new ("destroy_event", G_TYPE_FROM_CLASS (gobject_class), |