mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-12-28 14:31:10 +00:00
1c856a208f
We already use the "logical/virtual" and "physical" names in the documentation, there's no reason to use loaded terms just because X11 uses them.
190 lines
6.3 KiB
C
190 lines
6.3 KiB
C
/* GDK - The GIMP Drawing Kit
|
|
* Copyright (C) 2009 Carlos Garnacho <carlosg@gnome.org>
|
|
*
|
|
* 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/>.
|
|
*/
|
|
|
|
#ifndef __GDK_DEVICE_H__
|
|
#define __GDK_DEVICE_H__
|
|
|
|
#if !defined (__GDK_H_INSIDE__) && !defined (GTK_COMPILATION)
|
|
#error "Only <gdk/gdk.h> can be included directly."
|
|
#endif
|
|
|
|
#include <gdk/gdkversionmacros.h>
|
|
#include <gdk/gdktypes.h>
|
|
#include <gdk/gdkdevicetool.h>
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GDK_TYPE_DEVICE (gdk_device_get_type ())
|
|
#define GDK_DEVICE(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), GDK_TYPE_DEVICE, GdkDevice))
|
|
#define GDK_IS_DEVICE(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), GDK_TYPE_DEVICE))
|
|
|
|
typedef struct _GdkTimeCoord GdkTimeCoord;
|
|
|
|
/**
|
|
* GdkInputSource:
|
|
* @GDK_SOURCE_MOUSE: the device is a mouse. (This will be reported for the core
|
|
* pointer, even if it is something else, such as a trackball.)
|
|
* @GDK_SOURCE_PEN: the device is a stylus of a graphics tablet or similar device.
|
|
* @GDK_SOURCE_ERASER: the device is an eraser. Typically, this would be the other end
|
|
* of a stylus on a graphics tablet.
|
|
* @GDK_SOURCE_CURSOR: the device is a graphics tablet “puck” or similar device.
|
|
* @GDK_SOURCE_KEYBOARD: the device is a keyboard.
|
|
* @GDK_SOURCE_TOUCHSCREEN: the device is a direct-input touch device, such
|
|
* as a touchscreen or tablet. This device type has been added in 3.4.
|
|
* @GDK_SOURCE_TOUCHPAD: the device is an indirect touch device, such
|
|
* as a touchpad. This device type has been added in 3.4.
|
|
* @GDK_SOURCE_TRACKPOINT: the device is a trackpoint. This device type has been
|
|
* added in 3.22
|
|
* @GDK_SOURCE_TABLET_PAD: the device is a "pad", a collection of buttons,
|
|
* rings and strips found in drawing tablets. This device type has been
|
|
* added in 3.22.
|
|
*
|
|
* An enumeration describing the type of an input device in general terms.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GDK_SOURCE_MOUSE,
|
|
GDK_SOURCE_PEN,
|
|
GDK_SOURCE_ERASER,
|
|
GDK_SOURCE_CURSOR,
|
|
GDK_SOURCE_KEYBOARD,
|
|
GDK_SOURCE_TOUCHSCREEN,
|
|
GDK_SOURCE_TOUCHPAD,
|
|
GDK_SOURCE_TRACKPOINT,
|
|
GDK_SOURCE_TABLET_PAD
|
|
} GdkInputSource;
|
|
|
|
/**
|
|
* GdkDeviceType:
|
|
* @GDK_DEVICE_TYPE_LOGICAL: Device is a logical device. There will
|
|
* be an associated focus indicator on the screen.
|
|
* @GDK_DEVICE_TYPE_PHYSICAL: Device is a physical device.
|
|
* @GDK_DEVICE_TYPE_FLOATING: Device is a physical device, currently
|
|
* not attached to any seat.
|
|
*
|
|
* Indicates the device type.
|
|
*/
|
|
typedef enum {
|
|
GDK_DEVICE_TYPE_LOGICAL,
|
|
GDK_DEVICE_TYPE_PHYSICAL,
|
|
GDK_DEVICE_TYPE_FLOATING
|
|
} GdkDeviceType;
|
|
|
|
|
|
/**
|
|
* GdkTimeCoord:
|
|
* @time: The timestamp for this event.
|
|
* @flags: Flags indicating what axes are present
|
|
* @axes: axis values
|
|
*
|
|
* A #GdkTimeCoord stores a single event in a motion history.
|
|
*/
|
|
struct _GdkTimeCoord
|
|
{
|
|
guint32 time;
|
|
GdkAxisFlags flags;
|
|
double axes[GDK_AXIS_LAST];
|
|
};
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GType gdk_device_get_type (void) G_GNUC_CONST;
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
const gchar * gdk_device_get_name (GdkDevice *device);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gdk_device_get_has_cursor (GdkDevice *device);
|
|
|
|
/* Functions to configure a device */
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkInputSource gdk_device_get_source (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkAxisUse gdk_device_get_axis_use (GdkDevice *device,
|
|
guint index_);
|
|
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gdk_device_get_state (GdkDevice *device,
|
|
GdkSurface *surface,
|
|
gdouble *axes,
|
|
GdkModifierType *mask);
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkSurface * gdk_device_get_surface_at_position (GdkDevice *device,
|
|
double *win_x,
|
|
double *win_y);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
gint gdk_device_get_n_axes (GdkDevice *device);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gdk_device_get_axis (GdkDevice *device,
|
|
gdouble *axes,
|
|
GdkAxisUse use,
|
|
gdouble *value);
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkDisplay * gdk_device_get_display (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkDevice * gdk_device_get_associated_device (GdkDevice *device);
|
|
GDK_AVAILABLE_IN_ALL
|
|
GList * gdk_device_list_physical_devices (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkDeviceType gdk_device_get_device_type (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkSurface *gdk_device_get_last_event_surface (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
const gchar *gdk_device_get_vendor_id (GdkDevice *device);
|
|
GDK_AVAILABLE_IN_ALL
|
|
const gchar *gdk_device_get_product_id (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkSeat *gdk_device_get_seat (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkAxisFlags gdk_device_get_axes (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
guint gdk_device_get_num_touches (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkDeviceTool * gdk_device_get_device_tool (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gdk_device_get_caps_lock_state (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gdk_device_get_num_lock_state (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gdk_device_get_scroll_lock_state (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GdkModifierType gdk_device_get_modifier_state (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
PangoDirection gdk_device_get_direction (GdkDevice *device);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gdk_device_has_bidi_layouts (GdkDevice *device);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GDK_DEVICE_H__ */
|