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

134 lines
4.8 KiB
C
Raw Normal View History

Prevent subclassing of gestures For now, at least. We do this by hiding the instance and class structures in private headers.
2014-05-06 02:40:18 +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_PRIVATE_H__
#define __GTK_EVENT_CONTROLLER_PRIVATE_H__
#include "gtkeventcontroller.h"
Define GTK_CROSSING_ACTIVE Document the different crossing event kinds that we use, and add GTK_CROSSING_ACTIVE. We are going to use it in the future when the active window changes.
2020-07-30 17:21:28 +00:00
/* GdkCrossingType:
* @GTK_CROSSING_FOCUS: Focus moved from one widget to another
* @GTK_CROSSING_ACTIVE: The active window changed (the crossing
* events in this case leave from the old active window's focus
* location to the new active window's one.
* @GTK_CROSSING_POINTER: The pointer moved from one widget to another
gtkeventcontroller: Fix internal enum documentation Copy and paste typo.
2022-08-05 14:38:56 +00:00
* @GTK_CROSSING_DROP: An active drag moved from one widget to another
Define GTK_CROSSING_ACTIVE Document the different crossing event kinds that we use, and add GTK_CROSSING_ACTIVE. We are going to use it in the future when the active window changes.
2020-07-30 17:21:28 +00:00
*
* We emit various kinds of crossing events when the target widget
* for keyboard or pointer events changes.
*/
Keep more event controller api private We don't want to expose the GtkCrossingData struct, and manually feeding events to event controllers is not something we want to encourage, going forward.
2020-02-20 22:22:03 +00:00
typedef enum {
GTK_CROSSING_FOCUS,
Define GTK_CROSSING_ACTIVE Document the different crossing event kinds that we use, and add GTK_CROSSING_ACTIVE. We are going to use it in the future when the active window changes.
2020-07-30 17:21:28 +00:00
GTK_CROSSING_ACTIVE,
gtk: Bubble drag events like motion events Emit crossing events - with a new GTK_CROSSING_DROP type - like we do for motion events. There is no more special casing for them. Note that the gesture has not been updated yet, so some obscure behavior may occur.
2020-02-19 03:44:41 +00:00
GTK_CROSSING_POINTER,
GTK_CROSSING_DROP
Keep more event controller api private We don't want to expose the GtkCrossingData struct, and manually feeding events to event controllers is not something we want to encourage, going forward.
2020-02-20 22:22:03 +00:00
} GtkCrossingType;
Define GTK_CROSSING_ACTIVE Document the different crossing event kinds that we use, and add GTK_CROSSING_ACTIVE. We are going to use it in the future when the active window changes.
2020-07-30 17:21:28 +00:00
/*
* GdkCrossingirection:
* @GTK_CROSSING_IN: the event is on the downward slope, towards the new target
* @GTK_CROSSING_OUT: the event is on the upward slope, away from the old target
*/
Keep more event controller api private We don't want to expose the GtkCrossingData struct, and manually feeding events to event controllers is not something we want to encourage, going forward.
2020-02-20 22:22:03 +00:00
typedef enum {
GTK_CROSSING_IN,
GTK_CROSSING_OUT
} GtkCrossingDirection;
typedef struct _GtkCrossingData GtkCrossingData;
/**
* GtkCrossingData:
* @type: the type of crossing event
* @direction: whether this is a focus-in or focus-out event
* @mode: the crossing mode
* @old_target: the old target
* @old_descendent: the direct child of the receiving widget that
Documentation fixes Mostly fixing up indentation of continuation lines, and other small cleanups.
2021-05-18 21:05:26 +00:00
* is an ancestor of @old_target, or %NULL if @old_target is not
* a descendent of the receiving widget
Keep more event controller api private We don't want to expose the GtkCrossingData struct, and manually feeding events to event controllers is not something we want to encourage, going forward.
2020-02-20 22:22:03 +00:00
* @new_target: the new target
* @new_descendent: the direct child of the receiving widget that
Documentation fixes Mostly fixing up indentation of continuation lines, and other small cleanups.
2021-05-18 21:05:26 +00:00
* is an ancestor of @new_target, or %NULL if @new_target is not
* a descendent of the receiving widget
gtk: Clean up docs syntax Replace leftover gtk-doc syntax (#Type) with backquotes.
2021-05-20 13:17:04 +00:00
* @drop: the `GdkDrop` if this is info for a drop operation
Keep more event controller api private We don't want to expose the GtkCrossingData struct, and manually feeding events to event controllers is not something we want to encourage, going forward.
2020-02-20 22:22:03 +00:00
*
* The struct that is passed to gtk_event_controller_handle_crossing().
*
* The @old_target and @new_target fields are set to the old or new
gtk: Bubble drag events like motion events Emit crossing events - with a new GTK_CROSSING_DROP type - like we do for motion events. There is no more special casing for them. Note that the gesture has not been updated yet, so some obscure behavior may occur.
2020-02-19 03:44:41 +00:00
* focus, drop or hover location.
Keep more event controller api private We don't want to expose the GtkCrossingData struct, and manually feeding events to event controllers is not something we want to encourage, going forward.
2020-02-20 22:22:03 +00:00
*/
struct _GtkCrossingData {
GtkCrossingType type;
GtkCrossingDirection direction;
GdkCrossingMode mode;
GtkWidget *old_target;
GtkWidget *old_descendent;
GtkWidget *new_target;
GtkWidget *new_descendent;
gtk: Bubble drag events like motion events Emit crossing events - with a new GTK_CROSSING_DROP type - like we do for motion events. There is no more special casing for them. Note that the gesture has not been updated yet, so some obscure behavior may occur.
2020-02-19 03:44:41 +00:00
GdkDrop *drop;
Keep more event controller api private We don't want to expose the GtkCrossingData struct, and manually feeding events to event controllers is not something we want to encourage, going forward.
2020-02-20 22:22:03 +00:00
};
Prevent subclassing of gestures For now, at least. We do this by hiding the instance and class structures in private headers.
2014-05-06 02:40:18 +00:00
struct _GtkEventController
{
GObject parent_instance;
};
struct _GtkEventControllerClass
{
GObjectClass parent_class;
eventcontroller: Add vfuncs to (un)set widget This is the first step towards refactoring how widgets deal with event controllers. In the future, the widget will treat controllers the same way it treats child widgets: 1. The controllers will be created without a widget. 2. There will be gtk_widget_add/remove_controller() functions to add or remove controllers. 3. The widget will hold a reference to all its controllers. This way we will ultimately be able to automate controllers with ui files.
2018-03-08 02:30:44 +00:00
void (* set_widget) (GtkEventController *controller,
GtkWidget *widget);
void (* unset_widget) (GtkEventController *controller);
Prevent subclassing of gestures For now, at least. We do this by hiding the instance and class structures in private headers.
2014-05-06 02:40:18 +00:00
gboolean (* handle_event) (GtkEventController *controller,
Strip const from GdkEvent Events are refcounted structs, and we generally don't pass these as const.
2020-02-16 16:09:02 +00:00
GdkEvent *event,
Pass translated coordinates outside the event We want to make events readonly, so stop translating their coordinates and instead pass the translated coordinates separately, when propagating events.
2020-02-13 05:08:49 +00:00
double x,
double y);
Prevent subclassing of gestures For now, at least. We do this by hiding the instance and class structures in private headers.
2014-05-06 02:40:18 +00:00
void (* reset) (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
void (* handle_crossing) (GtkEventController *controller,
const GtkCrossingData *crossing,
double x,
double y);
Prevent subclassing of gestures For now, at least. We do this by hiding the instance and class structures in private headers.
2014-05-06 02:40:18 +00:00
/*<private>*/
eventcontroller: Add private ::filter method This will be used right before handle_event() in order to filter out events, useful to make the previous "no touchpad events" behavior the default, and have gesture subclasses include manually the touchpad events they handle.
2015-07-09 16:55:32 +00:00
GtkEventController: Add some comment describing the filter_event private vfunc It might not be entirely clear what the boolean return value means. https://bugzilla.gnome.org/show_bug.cgi?id=770026
2016-08-23 18:31:29 +00:00
/* Tells whether the event is filtered out, %TRUE makes
* the event unseen by the handle_event vfunc.
*/
eventcontroller: Add private ::filter method This will be used right before handle_event() in order to filter out events, useful to make the previous "no touchpad events" behavior the default, and have gesture subclasses include manually the touchpad events they handle.
2015-07-09 16:55:32 +00:00
gboolean (* filter_event) (GtkEventController *controller,
Strip const from GdkEvent Events are refcounted structs, and we generally don't pass these as const.
2020-02-16 16:09:02 +00:00
GdkEvent *event);
Reinstate filtering for crossing events The event propagation limit should apply to crossing events as well.
2020-02-16 06:48:50 +00:00
Prevent subclassing of gestures For now, at least. We do this by hiding the instance and class structures in private headers.
2014-05-06 02:40:18 +00:00
gpointer padding[10];
};
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
GtkWidget * gtk_event_controller_get_target (GtkEventController *controller);
eventcontroller: Make the target widget available Make it possible for event controllers to obtain the target widget during handle_event.
2020-02-16 07:46:05 +00:00
Keep more event controller api private We don't want to expose the GtkCrossingData struct, and manually feeding events to event controllers is not something we want to encourage, going forward.
2020-02-20 22:22:03 +00:00
gboolean gtk_event_controller_handle_event (GtkEventController *controller,
GdkEvent *event,
GtkWidget *target,
double x,
double y);
void gtk_event_controller_handle_crossing (GtkEventController *controller,
const GtkCrossingData *crossing,
double x,
double y);
Prevent subclassing of gestures For now, at least. We do this by hiding the instance and class structures in private headers.
2014-05-06 02:40:18 +00:00
#endif /* __GTK_EVENT_CONTROLLER_PRIVATE_H__ */
Reference in New Issue Copy Permalink