GtkGesturePan

描述 [src]

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

GtkGesturePan 是一个用于平移手势的 GtkGesture

它们是锁定在某个轴上发生的拖动手势。GtkGesturePan 处理的轴在构造时进行定义,并可以通过 gtk_gesture_pan_set_orientation() 更改。

当手势开始被识别时,GtkGesturePan 会尝试尽早判断序列是否沿预期方向移动,如果并未朝预期方向移动,则会拒绝该序列。

一旦识别出沿预期轴的平移手势,GtkGesturePan::pan 信号便会在收到输入事件时发出,其中包含指定轴中的偏移。

层次结构

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

构造函数

gtk_gesture_pan_new

返回一个新创建的 GtkGesture,用于识别平移手势。

实例方法

gtk_gesture_pan_get_orientation

返回此 gesture 预期的平移手势的方向。

gtk_gesture_pan_set_orientation

设置平移手势需要遵循的方向。

GtkGestureDrag 继承的方法 (2)
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

返回上一次在 手势 中被更新的 GdkEventSequence

gtk_gesture_get_point

如果 手势 当前正在由 sequence 解释,返回 TRUE 并在 xy 中填充存储给该事件序列的最后坐标。

gtk_gesture_get_sequence_state

返回 sequence手势 看到的 状态。

gtk_gesture_get_sequences

返回当前由 手势 解释的 GdkEventSequences 列表。

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

设置手势sequence 的状态。

不推荐使用:4.10。 

gtk_gesture_set_state

设置与 手势 当前正在交互的所有 sequence 的状态。

gtk_gesture_ungroup

gesture 分离成一个孤立的组。

继承自 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

为用于 调试的控制器设置一个名称。

自 4.8 起

继承自 GObject(43)的方法

请参阅 GObject 了解完整的方法 列表。

属性

Gtk.GesturePan:orientation

平移手势的预期 方向。

继承自 GtkGestureSingle(3)的属性
Gtk.GestureSingle:button

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

Gtk.GestureSingle:exclusive

手势是否是 排他性的。

Gtk.GestureSingle:touch-only

手势是否仅处理触摸 事件。

继承自 GtkGesture(1)的属性
Gtk.Gesture:n-points

触发手势的触点数量的检测。

GtkEventController 继承的属性 (4)
Gtk.EventController:name

用于调试目的的此控制器的名称。

Gtk.EventController:propagation-limit

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

Gtk.EventController:propagation-phase

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

Gtk.EventController:widget

接受控制器将处理的 GdkEvents 的窗口小部件。

信号

Gtk.GesturePan::pan

检测到沿着预期轴的平移手势后会发出一次信号。

GtkGestureDrag 继承的信号 (3)
GtkGestureDrag::drag-begin

每当开始拖动时发出。

GtkGestureDrag::drag-end

每当拖动完成后发出。

GtkGestureDrag::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 GtkGesturePanClass {
  /* no available fields */
}

无可用描述。