Widget to generate a button click on.
Number of the pointer button for the event, usually 1, 2 or 3.
Keyboard modifiers the event is setup with.
Return: whether all actions neccessary for the button click simulation were carried out successfully.
2.14
This function will generate a @button click (button press and button release event) in the middle of the first GdkWindow found that belongs to @widget. For %GTK_NO_WINDOW widgets like GtkButton, this will often be an input-only event window. For other widgets, this is usually widget->window. Certain caveats should be considered when using this function, in particular because the mouse pointer is warped to the button click location, see gdk_test_simulate_button() for details.