AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
dd3c371c08
gtk2/gtk/gtkeventcontroller.h

89 lines
3.9 KiB
C
Raw Normal View History

Add GtkEventController This is a basic abstract type that handles GdkEvents.
2013-01-17 19:55:24 +00:00
/* GTK - The GIMP Toolkit
* Copyright (C) 2012, One Laptop Per Child.
* Copyright (C) 2014, Red Hat, Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*
* Author(s): Carlos Garnacho <carlosg@gnome.org>
*/
#ifndef __GTK_EVENT_CONTROLLER_H__
#define __GTK_EVENT_CONTROLLER_H__
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif
typedef struct _GtkEventControllerClass GtkEventControllerClass;
#include <gdk/gdk.h>
#include <gtk/gtktypes.h>
eventcontroller: Add propagation-phase property This is so we don't have to specify the capture phase for every controller. The default "bubble" value will be sane on most situations.
2014-04-08 18:25:53 +00:00
#include <gtk/gtkenums.h>
Add GtkEventController This is a basic abstract type that handles GdkEvents.
2013-01-17 19:55:24 +00:00
G_BEGIN_DECLS
#define GTK_TYPE_EVENT_CONTROLLER (gtk_event_controller_get_type ())
#define GTK_EVENT_CONTROLLER(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), GTK_TYPE_EVENT_CONTROLLER, GtkEventController))
#define GTK_EVENT_CONTROLLER_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), GTK_TYPE_EVENT_CONTROLLER, GtkEventControllerClass))
#define GTK_IS_EVENT_CONTROLLER(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), GTK_TYPE_EVENT_CONTROLLER))
#define GTK_IS_EVENT_CONTROLLER_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), GTK_TYPE_EVENT_CONTROLLER))
#define GTK_EVENT_CONTROLLER_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), GTK_TYPE_EVENT_CONTROLLER, GtkEventControllerClass))
New focus change handling Instead of relying on gdk's antiquated crossing events, create a new GtkCrossingData struct that contains the actual widgets, and a new event controller vfunc that expects this struct. This also saves us from making sense of X's crossing modes and details, and makes for a generally simpler api. The ::focus-in and ::focus-out signals of GtkEventControllerKey have been replaced by a single ::focus-change signal that takes GtkCrossingData as an argument. All callers have been updated.
2020-02-13 01:26:29 +00:00
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Add GtkEventController This is a basic abstract type that handles GdkEvents.
2013-01-17 19:55:24 +00:00
GType gtk_event_controller_get_type (void) G_GNUC_CONST;
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Add GtkEventController This is a basic abstract type that handles GdkEvents.
2013-01-17 19:55:24 +00:00
GtkWidget * gtk_event_controller_get_widget (GtkEventController *controller);
New focus change handling Instead of relying on gdk's antiquated crossing events, create a new GtkCrossingData struct that contains the actual widgets, and a new event controller vfunc that expects this struct. This also saves us from making sense of X's crossing modes and details, and makes for a generally simpler api. The ::focus-in and ::focus-out signals of GtkEventControllerKey have been replaced by a single ::focus-change signal that takes GtkCrossingData as an argument. All callers have been updated.
2020-02-13 01:26:29 +00:00
GDK_AVAILABLE_IN_ALL
Add GtkEventController This is a basic abstract type that handles GdkEvents.
2013-01-17 19:55:24 +00:00
void gtk_event_controller_reset (GtkEventController *controller);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gesture: Replace gtk_gesture_attach/detach with event controller API Event controllers now auto-attach, and the GtkCapturePhase only determines when are events dispatched, but all controllers are managed by the widget wrt grabs. All callers have been updated.
2014-05-26 12:02:30 +00:00
GtkPropagationPhase gtk_event_controller_get_propagation_phase (GtkEventController *controller);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gesture: Replace gtk_gesture_attach/detach with event controller API Event controllers now auto-attach, and the GtkCapturePhase only determines when are events dispatched, but all controllers are managed by the widget wrt grabs. All callers have been updated.
2014-05-26 12:02:30 +00:00
void gtk_event_controller_set_propagation_phase (GtkEventController *controller,
GtkPropagationPhase phase);
Introduce event controller propagation limits Limit event handlers by default to only handle events targeting the same surface as their widget.
2019-04-29 02:19:44 +00:00
GDK_AVAILABLE_IN_ALL
GtkPropagationLimit gtk_event_controller_get_propagation_limit (GtkEventController *controller);
GDK_AVAILABLE_IN_ALL
void gtk_event_controller_set_propagation_limit (GtkEventController *controller,
GtkPropagationLimit limit);
event controller: Add a name property This helps identifying controllers in the inspector.
2019-06-19 11:09:38 +00:00
GDK_AVAILABLE_IN_ALL
const char * gtk_event_controller_get_name (GtkEventController *controller);
GDK_AVAILABLE_IN_ALL
void gtk_event_controller_set_name (GtkEventController *controller,
const char *name);
eventcontroller: Allow static names These names are a debug-only feature, and we use string literals everywhere, so avoid the overhead of copying them.
2022-08-28 01:59:02 +00:00
GDK_AVAILABLE_IN_4_8
void gtk_event_controller_set_static_name (GtkEventController *controller,
const char *name);
event controller: Add a name property This helps identifying controllers in the inspector.
2019-06-19 11:09:38 +00:00
Add gtk_event_controller_get_current_event[_state] For now these are private, to replace internal uses of gtk_get_current_event[_state], but we may want to make them public.
2020-04-11 16:40:21 +00:00
GDK_AVAILABLE_IN_ALL
GdkEvent * gtk_event_controller_get_current_event (GtkEventController *controller);
GDK_AVAILABLE_IN_ALL
guint32 gtk_event_controller_get_current_event_time (GtkEventController *controller);
GDK_AVAILABLE_IN_ALL
GdkDevice * gtk_event_controller_get_current_event_device (GtkEventController *controller);
GDK_AVAILABLE_IN_ALL
GdkModifierType gtk_event_controller_get_current_event_state (GtkEventController *controller);
gtk: Dissolve gtk-autocleanup.h Move the autocleanup declarations into their respective headers.
2022-09-24 01:54:15 +00:00
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkEventController, g_object_unref)
Add GtkEventController This is a basic abstract type that handles GdkEvents.
2013-01-17 19:55:24 +00:00
G_END_DECLS
#endif /* __GTK_EVENT_CONTROLLER_H__ */
Reference in New Issue Copy Permalink