GtkDropControllerMotion
GtkDropControllerMotion — Контроллер событий для событий перемещения во время переноса
Функции
Свойства
| gboolean | contains-pointer | Чтение |
| GdkDrop * | drop | Чтение |
| gboolean | is-pointer | Чтение |
Типы и значения
Иерархия объектов
GObject
╰── GtkEventController
╰── GtkDropControllerMotion
Файлы
#include <gtk/gtk.h>
Описание
GtkDropControllerMotion — контроллер событий, предназначенный для отслеживания указателя, наведённого на виджет во время операции переноса.
Он основан на GtkEventControllerMotion, поэтому, если вы использовали его, эта конструкция вам будет знакома.
Контроллер переноса не может принимать переносы, используйте GtkDropTarget для этой цели.
Функции
gtk_drop_controller_motion_new ()
GtkEventController *
gtk_drop_controller_motion_new (void); Создаёт новый контроллер событий, который будет обрабатывать события перемещения указателя во время переноса.
Возвращаемое значение
новый GtkDropControllerMotion
gtk_drop_controller_motion_contains_pointer ()
gboolean
gtk_drop_controller_motion_contains_pointer
(GtkDropControllerMotion *self); Возвращает значение свойства GtkDropControllerMotion:contains-pointer.
Параметры
self |
Возвращаемое значение
TRUE если указатель перетаскивания находится внутри self или одного из его дочерних элементов.
gtk_drop_controller_motion_is_pointer ()
gboolean
gtk_drop_controller_motion_is_pointer (GtkDropControllerMotion *self); Возвращает значение свойства GtkDropControllerMotion:is-pointer.
Параметры
self |
Возвращаемое значение
TRUE если указатель перетаскивания находится внутри self, но не внутри одного из его дочерних элементов.
gtk_drop_controller_motion_get_drop ()
GdkDrop *
gtk_drop_controller_motion_get_drop (GtkDropControllerMotion *self); Возвращает значение свойства GtkDropControllerMotion:drop.
Параметры
self |
Возвращаемое значение
Текущая операция переноса GdkDrop внутри self или NULL если нет.
[transfer none][nullable]
Типы и значения
GtkDropControllerMotion
typedef struct _GtkDropControllerMotion GtkDropControllerMotion;
Подробности свойств
Свойство “contains-pointer”
“contains-pointer” gboolean
Показывает, находится ли указатель операции переноса внутри виджета контроллера или его потомка. См. также «is-pointer».
При обработке событий пересечения это свойство обновляется перед сигналом «enter», но после сигнала «leave».
Владелец: GtkDropControllerMotion
Флаги: Чтение
Значение по умолчанию: FALSE
Свойство “drop”
“drop” GdkDrop *
Текущая операция переноса над виджетом контроллера или его потомком. Если нет активной операции переноса, это свойство возвращает NULL.
Контроллер событий не должен изменять drop, но он может запросить его свойства.
При обработке событий пересечения это свойство обновляется перед сигналом «enter», но после сигнала «leave».
Владелец: GtkDropControllerMotion
Флаги: Чтение
Свойство “is-pointer”
“is-pointer” gboolean
Показывает, находится ли указатель непосредственно в самом виджете контроллера, а не в одном из его потомков. См. также «contains-pointer».
При обработке событий пересечения это свойство обновляется перед сигналом «enter», но после сигнала «leave».
Владелец: GtkDropControllerMotion
Флаги: Чтение
Значение по умолчанию: FALSE
Подробности сигналов
Сигнал “enter”
void user_function (GtkDropControllerMotion *self, double x, double y, gpointer user_data)
Сигнализирует о том, что указатель вошёл в виджет.
Параметры
self | объект, получивший сигнал | |
x | координаты местоположения указателя | |
y | координаты местоположения указателя | |
user_data | пользовательские данные, установленные при подключении обработчика сигнала. |
Флаги: Run Last
Сигнал “leave”
void user_function (GtkDropControllerMotion *self, gpointer user_data)
Сигнализирует о том, что указатель покинул виджет.
Параметры
self | объект, получивший сигнал | |
user_data | пользовательские данные, установленные при подключении обработчика сигнала. |
Флаги: Run Last
Сигнал “motion”
void user_function (GtkDropControllerMotion *self, double x, double y, gpointer user_data)
Издаётся, когда указатель перемещается внутри виджета.
Параметры
self | Объект, получивший сигнал | |
x | координата x | |
y | координата y | |
user_data | пользовательские данные, установленные при подключении обработчика сигнала. |
Флаги: Run First
См. также
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkDropControllerMotion.html
