GtkGestureLongPress: GTK+ 3 Reference Manual

## GtkGestureLongPress GtkGestureLongPress — "Press and Hold" gesture |

## Functions

GtkGesture * | gtk_gesture_long_press_new ()

## Properties

double | delay-factor | Read / Write

## Signals

void | cancelled | Run Last
void | pressed | Run Last

## Types and Values

| GtkGestureLongPress

## Object Hierarchy

        GObject
        ╰── GtkEventController
            ╰── GtkGesture
                ╰── GtkGestureSingle
                    ╰── GtkGestureLongPress

## Includes

    #include <gtk/gtk.h>

## Description

GtkGestureLongPress is a GtkGesture implementation able to recognize long presses, triggering the “pressed” after the timeout is exceeded.

If the touchpoint is lifted before the timeout passes, or if it drifts too far of the initial press point, the “cancelled” signal will be emitted.

## Functions

### gtk_gesture_long_press_new ()

    GtkGesture *
    gtk_gesture_long_press_new (GtkWidget *widget);

Returns a newly created GtkGesture that recognizes long presses.

#### Parameters

widget | a GtkWidget |

#### Returns

a newly created GtkGestureLongPress

Since: 3.14

## Types and Values

### GtkGestureLongPress

    typedef struct _GtkGestureLongPress GtkGestureLongPress;

## Property Details

### The `“delay-factor”` property

      “delay-factor”             double

Factor by which to modify the default timeout.

Owner: GtkGestureLongPress

Flags: Read / Write

Allowed values: [0.5,2]

Default value: 1

## Signal Details

### The `“cancelled”` signal

    void
    user_function (GtkGestureLongPress *gesture,
                   gpointer             user_data)

This signal is emitted whenever a press moved too far, or was released before “pressed” happened.

#### Parameters

gesture | the object which received the signal |
user_data | user data set when the signal handler was connected. |

Flags: Run Last

Since: 3.14

### The `“pressed”` signal

    void
    user_function (GtkGestureLongPress *gesture,
                   double               x,
                   double               y,
                   gpointer             user_data)

This signal is emitted whenever a press goes unmoved/unreleased longer than what the GTK+ defaults tell.

#### Parameters

gesture | the object which received the signal |
x | the X coordinate where the press happened, relative to the widget allocation |
y | the Y coordinate where the press happened, relative to the widget allocation |
user_data | user data set when the signal handler was connected. |

Flags: Run Last

Since: 3.14