GtkGestureDrag

描述 [源代码]

final class Gtk.GestureDrag : Gtk.GestureSingle
{
  /* No available fields */
}

GtkGestureDragGtkGesture 的实现,用于拖动。

拖动操作本身可通过 GtkGestureDrag::drag-beginGtkGestureDrag::drag-updateGtkGestureDrag::drag-end 信号进行跟踪,可以通过 gtk_gesture_drag_get_offset()gtk_gesture_drag_get_start_point() 提取相关的坐标。

层次结构

hierarchy this GtkGestureDrag ancestor_0 GtkGestureSingle ancestor_0--this ancestor_1 GtkGesture ancestor_1--ancestor_0 ancestor_2 GtkEventController ancestor_2--ancestor_1 ancestor_3 GObject ancestor_3--ancestor_2

子类

构造函数

gtk_gesture_drag_new

返回新创建的 GtkGesture,该手势识别拖动。

实例方法

gtk_gesture_drag_get_offset

获取起始位置的偏移量。

gtk_gesture_drag_get_start_point

获取拖动开始的位置。

GtkGestureSingle(8)继承的方法
gtk_gesture_single_get_button

返回按钮编号 gesture 监听。

gtk_gesture_single_get_current_button

返回当前与 gesture 交互的按钮编号,如果当前没有按钮,返回 0。

gtk_gesture_single_get_current_sequence

返回当前与 gesture 交互的事件序列。

gtk_gesture_single_get_exclusive

获取手势是否是排他性的。

gtk_gesture_single_get_touch_only

如果手势仅由触摸事件触发,则返回 TRUE

gtk_gesture_single_set_button

设置按钮编号 gesture 监听。

gtk_gesture_single_set_exclusive

设置 gesture 是否排他性。

gtk_gesture_single_set_touch_only

设置是否仅处理触摸事件。

GtkGesture(17)继承的方法
gtk_gesture_get_bounding_box

如果当前 gesture 正在处理触摸序列,则返回 TRUE,并在 rect 中填充一个包含所有活动触摸的边界框。

gtk_gesture_get_bounding_box_center

如果当前 gesture 正在处理触摸序列,则返回 TRUE,并在 xy 中填充一个包含所有活动触摸的边界框的中心。

gtk_gesture_get_device

返回当前在 gesture 上操作的逻辑 GdkDevice

gtk_gesture_get_group

返回 gesture 所属组的所有手势。

gtk_gesture_get_last_event

返回为 sequence 处理的最后一个事件。

gtk_gesture_get_last_updated_sequence

返回在 gesture 上最后更新过的 GdkEventSequence

gtk_gesture_get_point

如果 sequence 当前正在由 gesture 解释,则返回 TRUE,并使用该事件序列存储的最后坐标来填充 xy

gtk_gesture_get_sequence_state

返回由 gesture 看到的 sequence 状态。

gtk_gesture_get_sequences

返回当前由 gesture 解释的 GdkEventSequence 列表。

gtk_gesture_group

gesture 添加到与 group_gesture 相同的组。

gtk_gesture_handles_sequence

如果 gesture 当前正在处理与 sequence 对应的事件,则返回 TRUE

gtk_gesture_is_active

如果手势当前处于活动状态,则返回 TRUE

gtk_gesture_is_grouped_with

如果两个手势都属于同一组,则返回 TRUE

gtk_gesture_is_recognized

如果手势当前被识别,则返回 TRUE

gtk_gesture_set_sequence_state

设置 gesturesequence 的状态。

已弃用: 4.10。 

gtk_gesture_set_state

设置 gesture 当前正在与之交互的所有序列的状态。

gtk_gesture_ungroup

gesture 单独分组。

Methods 继承自 GtkEventController (13)
gtk_event_controller_get_current_event

返回控制器当前正在处理的事件。

gtk_event_controller_get_current_event_device

返回控制器当前正在处理的事件的设备。

gtk_event_controller_get_current_event_state

返回控制器当前正在处理的事件的修饰符状态。

gtk_event_controller_get_current_event_time

返回控制器当前正在处理的事件的时间戳。

gtk_event_controller_get_name

获取 controller 的名称。

gtk_event_controller_get_propagation_limit

获取事件控制器的传播限制。

gtk_event_controller_get_propagation_phase

获取 controller 处理事件的传播阶段。

gtk_event_controller_get_widget

返回此控制器关联的 GtkWidget

gtk_event_controller_reset

controller 重置为干净的状态。

gtk_event_controller_set_name

在控制器上设置一个可用于调试的名称。

gtk_event_controller_set_propagation_limit

设置事件控制器上的事件传播限制。

gtk_event_controller_set_propagation_phase

设置控制器处理事件的传播阶段。

gtk_event_controller_set_static_name

在控制器上设置一个可用于调试的名称。

since: 4.8

Methods 继承自 GObject (43)

请参阅 GObject 以获取完整的方法列表。

属性

Properties 继承自 GtkGestureSingle (3)
Gtk.GestureSingle:button

要监听的鼠标按钮编号,或 0 以监听任何按钮。

Gtk.GestureSingle:exclusive

手势是否是独占的。

Gtk.GestureSingle:touch-only

手势是否只处理触控事件。

Properties 继承自 GtkGesture (1)
Gtk.Gesture:n-points

触发此手势识别的触控点数量。

Properties 继承自 GtkEventController (4)
Gtk.EventController:name

该控制器的名称,通常用于调试目的。

Gtk.EventController:propagation-limit

此控制器将处理事件的限制。

Gtk.EventController:propagation-phase

此控制器将处理事件的传播阶段。

Gtk.EventController:widget

控制器将处理的接收 `GdkEvents` 的小部件。

信号

Gtk.GestureDrag::drag-begin

每当拖动开始时都会发出。

Gtk.GestureDrag::drag-end

每当拖动结束时都会发出。

Gtk.GestureDrag::drag-update

每当拖动点移动时都会发出。

GtkGesture(5)继承的信号
GtkGesture::begin

手势识别后发出。

GtkGesture::cancel

每当取消序列时发出。

GtkGesture::end

当 `手势` 停止识别事件序列时,或者触摸序列的数量比 `GtkGesture:n-points` 高或低时发出。

GtkGesture::sequence-state-changed

每当序列状态更改时发出。

GtkGesture::update

手势被识别时每当处理一个事件时发出。

GObject (1) 继承的信号
GObject::notify

当对象的某个属性通过 g_object_set_property()、g_object_set() 等函数设置值时,就会发出通知信号。

类结构

struct GtkGestureDragClass {
  /* no available fields */
}

无可用描述。