GtkGestureDrag
GtkGestureDrag — Жест перетаскивания
Функции
Сигналы
| void | drag-begin | Run Last |
| void | drag-end | Run Last |
| void | drag-update | Run Last |
Типы и значения
Иерархия объектов
GObject ╰── GtkEventController ╰── GtkGesture ╰── GtkGestureSingle ╰── GtkGestureDrag ╰── GtkGesturePan
Файлы заголовков
#include <gtk/gtk.h>
Описание
GtkGestureDrag — это реализация GtkGesture, распознающая операции перетаскивания. Саму операцию перетаскивания можно отслеживать с помощью сигналов «drag-begin», «drag-update» и «drag-end», или соответствующие координаты можно извлечь с помощью gtk_gesture_drag_get_offset() и gtk_gesture_drag_get_start_point().
Функции
gtk_gesture_drag_new ()
GtkGesture *
gtk_gesture_drag_new (GtkWidget *widget); Возвращает новый созданный GtkGesture, распознающий операции перетаскивания.
Параметры
widget |
Возвращаемое значение
новый созданный GtkGestureDrag
С: 3.14
gtk_gesture_drag_get_start_point ()
gboolean gtk_gesture_drag_get_start_point (GtkGestureDrag *gesture,gdouble *x,gdouble *y);
Если gesture активен, эта функция возвращает TRUE и заполняет x и y координатами начала перетаскивания, в координатах относительно окна.
Параметры
gesture | ||
x | Координата X для точки начала перетаскивания. | [out][nullable] |
y | Координата Y для точки начала перетаскивания. | [out][nullable] |
Возвращаемое значение
TRUE, если жест активен
С: 3.14
gtk_gesture_drag_get_offset ()
gboolean gtk_gesture_drag_get_offset (GtkGestureDrag *gesture,gdouble *x,gdouble *y);
Если gesture активен, эта функция возвращает TRUE и заполняет x и y координатами текущей точки, как смещение от точки начала перетаскивания.
Параметры
gesture | ||
x | Смещение по оси X для текущей точки. | [out][nullable] |
y | Смещение по оси Y для текущей точки. | [out][nullable] |
Возвращаемое значение
TRUE, если жест активен
С: 3.14
Типы и значения
GtkGestureDrag
typedef struct _GtkGestureDrag GtkGestureDrag;
Подробности сигналов
Сигнал “drag-begin”
void user_function (GtkGestureDrag *gesture, gdouble start_x, gdouble start_y, gpointer user_data)
Этот сигнал генерируется при начале перетаскивания.
Параметры
gesture | объект, получивший сигнал | |
start_x | координата X, относительная к области виджета | |
start_y | координата Y, относительная к области виджета | |
user_data | данные пользователя, заданные при подключении обработчика сигналов. |
Флаги: Run Last
С версии: 3.14
Сигнал “drag-end”
void user_function (GtkGestureDrag *gesture, gdouble offset_x, gdouble offset_y, gpointer user_data)
Этот сигнал генерируется при завершении перетаскивания.
Параметры
gesture | объект, получивший сигнал | |
offset_x | смещение по оси X, относительно начальной точки | |
offset_y | смещение по оси Y, относительно начальной точки | |
user_data | данные пользователя, заданные при подключении обработчика сигналов. |
Флаги: Run Last
С версии: 3.14
Сигнал “drag-update”
void user_function (GtkGestureDrag *gesture, gdouble offset_x, gdouble offset_y, gpointer user_data)
Этот сигнал генерируется при перемещении точки перетаскивания.
Параметры
gesture | объект, получивший сигнал | |
offset_x | смещение по оси X, относительно начальной точки | |
offset_y | смещение по оси Y, относительно начальной точки | |
user_data | данные пользователя, заданные при подключении обработчика сигналов. |
Флаги: Run Last
С версии: 3.14
См. также
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.22/GtkGestureDrag.html
