类
GtkEventControllerScroll
说明 [src]
final class Gtk.EventControllerScroll : Gtk.EventController
{
/* No available fields */
}
GtkEventControllerScroll
是处理滚动事件的事件控制器。
它能够处理来自鼠标或触摸板的离散和连续的滚动事件,并使用 GtkEventControllerScroll::scroll
信号对它们进行抽象化。离散情况下,增量是 1 的倍数。
在连续滚动事件的情况下,GtkEventControllerScroll
将两个 GtkEventControllerScroll::scroll-begin
和 GtkEventControllerScroll::scroll-end
信号之间的所有 GtkEventControllerScroll::scroll
发射事件封装在一起。
事件控制器的行为可以通过创建时给出的标志进行修改,或稍后通过 gtk_event_controller_scroll_set_flags()
进行修改(例如,因为窗口小部件的滚动条件发生了更改)。
可以通过 GTK_EVENT_CONTROLLER_SCROLL_VERTICAL
、GTK_EVENT_CONTROLLER_SCROLL_HORIZONTAL
和 GTK_EVENT_CONTROLLER_SCROLL_BOTH_AXES
为垂直和水平滚动事件设置控制器,以便为其发射动作。如果禁用任何轴,则相应的 GtkEventControllerScroll::scroll
增量将为 0。对于无法进行水平滚动的设备,垂直滚动事件将转换为水平动作。
还可以通过 GTK_EVENT_CONTROLLER_SCROLL_DISCRETE
强制事件控制器在所有设备上发射离散事件。这可用于实现通过滚动事件触发离散动作(例如在组合框选项之间切换)。
GTK_EVENT_CONTROLLER_SCROLL_KINETIC
标志切换 GtkEventControllerScroll::decelerate
信号的发射,该信号在滚动结束时发射,带有两个与接收到的动作一致的 X/Y 速度参数。
实例方法
从 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
属性
从 GtkEventController (4) 中继承的属性
Gtk.EventController:name
此控制器的名称,通常用于调试目的。
Gtk.EventController:propagation-limit
此控制器将处理哪些事件的限制。
Gtk.EventController:propagation-phase
此控制器将处理事件的传播阶段。
Gtk.EventController:widget
接收控制器将处理的 `GdkEvents` 的小部件。
信号
从 GObject (1) 中继承的信号
GObject::notify
当通过 g_object_set_property()、g_object_set() 等方法为对象的某个属性设置其值时,此对象将发出通知信号。