Class gesture-multi-press - cl-cffi-gtk3 API documentation

Package: gtk

Class gtk:gesture-multi-press

Superclasses

gtk:gesture-single, gtk:gesture, gtk:event-controller, gobject:object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

None

Direct Slots

None

Details

The gtk:gesture-multi-press object is a gtk:gesture implementation able to recognize multiple clicks on a nearby zone, which can be listened for through the pressed signal. Whenever time or distance between clicks exceed the GTK defaults, "stopped" is emitted, and the click counter is reset.

Callers may also restrict the area that is considered valid for a > 1 touch/button press through the gtk:gesture-multi-press-area function, so any click happening outside that area is considered to be a first click of its own.

Signal Details

The "pressed" signal

lambda (gesture n x y)    :run-last

gesture: The gtk:gesture-multi-press object which received the signal.
n: The integer for how many touch/button presses happened with this one.
x: The double float for the x coordinate, in widget allocation coordinates.
y: The double float for the y coordinate, in widget allocation coordinates.

The signal is emitted whenever a button or touch press happens.

The "released" signal

lambda (gesture n x y)    :run-last

gesture: The gtk:gesture-multi-press object which received the signal.
n: The integer for the number of press that is paired with this release.
x: The double float for the x coordinate, in widget allocation coordinates.
y: The double float for the y coordinate, in widget allocation coordinates.

The signal is emitted when a button or touch is released. The n argument will report the number of press that is paired to this event, note that the "stopped" signal may have been emitted between the press and its release, the n argument will only start over at the next press.