1/* GTK - The GIMP Toolkit
2 * Copyright (C) 2016, Red Hat, Inc.
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
16 *
17 * Author(s): Carlos Garnacho <carlosg@gnome.org>
18 */
19
20#ifndef __GTK_PAD_CONTROLLER_H__
21#define __GTK_PAD_CONTROLLER_H__
22
23#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
24#error "Only <gtk/gtk.h> can be included directly."
25#endif
26
27#include <gdk/gdk.h>
28#include <gtk/gtkeventcontroller.h>
29
30G_BEGIN_DECLS
31
32#define GTK_TYPE_PAD_CONTROLLER (gtk_pad_controller_get_type ())
33#define GTK_PAD_CONTROLLER(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), GTK_TYPE_PAD_CONTROLLER, GtkPadController))
34#define GTK_PAD_CONTROLLER_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), GTK_TYPE_PAD_CONTROLLER, GtkPadControllerClass))
35#define GTK_IS_PAD_CONTROLLER(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), GTK_TYPE_PAD_CONTROLLER))
36#define GTK_IS_PAD_CONTROLLER_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), GTK_TYPE_PAD_CONTROLLER))
37#define GTK_PAD_CONTROLLER_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), GTK_TYPE_PAD_CONTROLLER, GtkPadControllerClass))
38
39typedef struct _GtkPadController GtkPadController;
40typedef struct _GtkPadControllerClass GtkPadControllerClass;
41typedef struct _GtkPadActionEntry GtkPadActionEntry;
42
43/**
44 * GtkPadActionType:
45 * @GTK_PAD_ACTION_BUTTON: Action is triggered by a pad button
46 * @GTK_PAD_ACTION_RING: Action is triggered by a pad ring
47 * @GTK_PAD_ACTION_STRIP: Action is triggered by a pad strip
48 *
49 * The type of a pad action.
50 */
51typedef enum {
52 GTK_PAD_ACTION_BUTTON,
53 GTK_PAD_ACTION_RING,
54 GTK_PAD_ACTION_STRIP
55} GtkPadActionType;
56
57/**
58 * GtkPadActionEntry:
59 * @type: the type of pad feature that will trigger this action entry.
60 * @index: the 0-indexed button/ring/strip number that will trigger this action
61 * entry.
62 * @mode: the mode that will trigger this action entry, or -1 for all modes.
63 * @label: Human readable description of this action entry, this string should
64 * be deemed user-visible.
65 * @action_name: action name that will be activated in the #GActionGroup.
66 *
67 * Struct defining a pad action entry.
68 */
69struct _GtkPadActionEntry {
70 GtkPadActionType type;
71 gint index;
72 gint mode;
73 gchar *label;
74 gchar *action_name;
75};
76
77GDK_AVAILABLE_IN_3_22
78GType gtk_pad_controller_get_type (void) G_GNUC_CONST;
79
80GDK_AVAILABLE_IN_3_22
81GtkPadController *gtk_pad_controller_new (GtkWindow *window,
82 GActionGroup *group,
83 GdkDevice *pad);
84
85GDK_AVAILABLE_IN_3_22
86void gtk_pad_controller_set_action_entries (GtkPadController *controller,
87 const GtkPadActionEntry *entries,
88 gint n_entries);
89GDK_AVAILABLE_IN_3_22
90void gtk_pad_controller_set_action (GtkPadController *controller,
91 GtkPadActionType type,
92 gint index,
93 gint mode,
94 const gchar *label,
95 const gchar *action_name);
96
97G_END_DECLS
98
99#endif /* __GTK_PAD_CONTROLLER_H__ */
100