类
GtkPadController
[−]
说明 [源代码]
final class Gtk.PadController : Gtk.EventController
{
/* No available fields */
}GtkPadController 是绘图板中所用平板电脑事件控制器。
平板电脑通常在触控笔敏感区域周围设置按钮和触感传感器。
这些按钮和传感器没有隐含含义，通常不执行任何操作。GtkPadController 用于将这些按钮和传感器映射到 GAction 对象，从而让应用程序赋予它们更语义化的含义。
按钮和传感器不限于触发单个操作，一些 GDK_SOURCE_TABLET_PAD 设备具备多种“模式”。所有这些输入元素都有一种当前模式，它可能决定最终触发的操作。
平板设备通常将按钮和传感器划分为组。一组中的所有元素共享同一当前模式，但不同组可能具有不同模式。请参阅 gdk_device_pad_get_n_groups() 和 gdk_device_pad_get_group_n_modes()。
给定按钮/带/环在给定模式下执行的每个操作均由 GtkPadActionEntry 定义。它包含一个操作名称，将在给定的 GActionGroup 中查找该名称，并在指定的输入元素和模式被触发时激活该名称。
GtkPadController 用法的简单示例：将所有模式和平板设备中的按钮 1 分配给“反选”操作
GtkPadActionEntry *pad_actions[] = {
{ GTK_PAD_ACTION_BUTTON, 1, -1, "Invert selection", "pad-actions.invert-selection" },
…
};
…
action_group = g_simple_action_group_new ();
action = g_simple_action_new ("pad-actions.invert-selection", NULL);
g_signal_connect (action, "activate", on_invert_selection_activated, NULL);
g_action_map_add_action (G_ACTION_MAP (action_group), action);
…
pad_controller = gtk_pad_controller_new (action_group, NULL);
属于套环/带条的操作将通过参数激活，类型为 G_VARIANT_TYPE_DOUBLE，其中包含给定轴的值，必须使其具有状态且接受此 GVariantType。
[+]