summaryrefslogtreecommitdiff
path: root/gtk/gtkwidget.c
diff options
context:
space:
mode:
authorFederico Mena Quintero <federico@ximian.com>2004-01-22 21:34:16 +0000
committerFederico Mena Quintero <federico@src.gnome.org>2004-01-22 21:34:16 +0000
commit2361bd9f39f896fab14970d54a2f2b956f870677 (patch)
tree685ab7d937518923be0182917822bd95cf3acbe6 /gtk/gtkwidget.c
parentd49500e4b766db74417443c7c79f4875e0ed01ec (diff)
downloadgtk+-2361bd9f39f896fab14970d54a2f2b956f870677.tar.gz
Added documentation for GtkWidget::popup_menu.
2004-01-22 Federico Mena Quintero <federico@ximian.com> * gtk/gtkwidget.c (gtk_widget_class_init): Added documentation for GtkWidget::popup_menu.
Diffstat (limited to 'gtk/gtkwidget.c')
-rw-r--r--gtk/gtkwidget.c12
1 files changed, 12 insertions, 0 deletions
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index a892d32832..6e55c67998 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -1279,6 +1279,18 @@ gtk_widget_class_init (GtkWidgetClass *klass)
_gtk_marshal_BOOLEAN__BOXED,
G_TYPE_BOOLEAN, 1,
GDK_TYPE_EVENT | G_SIGNAL_TYPE_STATIC_SCOPE);
+/**
+ * GtkWidget::popup-menu
+ * @widget: the object which received the signal
+ * @returns: TRUE if a menu was activated
+ *
+ * This signal gets emitted whenever a widget should pop up a context-sensitive
+ * menu. This usually happens through the standard key binding mechanism; by
+ * pressing a certain key while a widget is focused, the user can cause the
+ * widget to pop up a menu. For example, the #GtkEntry widget creates a menu
+ * with clipboard commands. See <xref linkend="checklist-popup-menu"/> for an
+ * example of how to use this signal.
+ */
widget_signals[POPUP_MENU] =
g_signal_new ("popup_menu",
G_TYPE_FROM_CLASS (gobject_class),