test_simulate_button


Description:


[ Version ( since = "2.14" ) ]
public bool test_simulate_button (Window window, int x, int y, uint button, ModifierType modifiers, EventType button_pressrelease)

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, 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.

Parameters:

window

a Window to simulate a button event for

x

x coordinate within window for the button event

y

y coordinate within window for the button event

button

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

modifiers

Keyboard modifiers the event is setup with

button_pressrelease

either gdk_button_press or gdk_button_release

Returns:

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


Namespace: Gdk
Package: gdk-3.0