Signal

GtkWidget::button-press-event

Declaration 

gboolean
button_press_event (
  GtkWidget* self,
  GdkEventButton event,
  gpointer user_data
)

Description [src]

The ::button-press-event signal will be emitted when a button (typically from a mouse) is pressed.

To receive this signal, the GdkWindow associated to the widget needs to enable the #GDK_BUTTON_PRESS_MASK mask.

This signal will be sent to the grab widget if there is one.

Default handler:

The default handler is called after the handlers added via g_signal_connect().

Parameters

event

Type: GdkEventButton

The GdkEventButton which triggered this signal.

Return value

Type: gboolean

TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further.