Declaration [src]

gdk_test_simulate_button (
  GdkWindow* window,
  gint x,
  gint y,
  guint button,
  GdkModifierType modifiers,
  GdkEventType button_pressrelease

Description [src]

This function is intended to be used in GTK+ test programs. It will warp the mouse pointer to the given (x,y) coordinates within window and simulate a button press or release event. Because the mouse pointer needs to be warped to the target location, use of this function outside of test programs that run in their own virtual windowing system (e.g. Xvfb) is not recommended.

Also, gdk_test_simulate_button() is a fairly low level function, for most testing purposes, gtk_test_widget_click() is the right function to call which will generate a button press event followed by its accompanying button release event.

Available since:2.14


window GdkWindow

A GdkWindow to simulate a button event for.

 The data is owned by the caller of the function.
x gint

X coordinate within window for the button event.

y gint

Y coordinate within window for the button event.

button guint

Number of the pointer button for the event, usually 1, 2 or 3

modifiers GdkModifierType

Keyboard modifiers the event is setup with.

button_pressrelease GdkEventType


Return value

Returns: gboolean

Whether all actions necessary for a button event simulation were carried out successfully.