Top |
Functions
GtkGesture * | gtk_gesture_stylus_new () |
gboolean | gtk_gesture_stylus_get_axis () |
gboolean | gtk_gesture_stylus_get_axes () |
gboolean | gtk_gesture_stylus_get_backlog () |
GdkDeviceTool * | gtk_gesture_stylus_get_device_tool () |
Object Hierarchy
GObject ╰── GtkEventController ╰── GtkGesture ╰── GtkGestureSingle ╰── GtkGestureStylus
Description
GtkGestureStylus is a GtkGesture implementation specific to stylus input. The provided signals just relay the basic information of the stylus events.
Functions
gtk_gesture_stylus_new ()
GtkGesture *
gtk_gesture_stylus_new (void
);
Creates a new GtkGestureStylus.
gtk_gesture_stylus_get_axis ()
gboolean gtk_gesture_stylus_get_axis (GtkGestureStylus *gesture
,GdkAxisUse axis
,double *value
);
Returns the current value for the requested axis
.
This function must be called from the handler of one of the “down”, “motion”, “up” or “proximity” signals.
gtk_gesture_stylus_get_axes ()
gboolean gtk_gesture_stylus_get_axes (GtkGestureStylus *gesture
,GdkAxisUse axes[]
,double **values
);
Returns the current values for the requested axes
. This function
must be called from either the “down”,
“motion”, “up” or “proximity”
signals.
Parameters
gesture |
a GtkGestureStylus |
|
axes |
array of requested axes, terminated with GDK_AXIS_IGNORE. |
[array] |
values |
return location for the axis values. |
[out][array] |
gtk_gesture_stylus_get_backlog ()
gboolean gtk_gesture_stylus_get_backlog (GtkGestureStylus *gesture
,GdkTimeCoord **backlog
,guint *n_elems
);
By default, GTK will limit rate of input events. On stylus input where accuracy of strokes is paramount, this function returns the accumulated coordinate/timing state before the emission of the current “motion” signal.
This function may only be called within a “motion”
signal handler, the state given in this signal and obtainable through
gtk_gesture_stylus_get_axis()
call express the latest (most up-to-date)
state in motion history.
The backlog
is provided in chronological order.
gtk_gesture_stylus_get_device_tool ()
GdkDeviceTool *
gtk_gesture_stylus_get_device_tool (GtkGestureStylus *gesture
);
Returns the GdkDeviceTool currently driving input through this gesture. This function must be called from either the “down”, “motion”, “up” or “proximity” signal handlers.
Signal Details
The “down”
signal
void user_function (GtkGestureStylus *gesture, double x, double y, gpointer user_data)
A signal emitted when the stylus touches the device.
Parameters
gesture |
the GtkGestureStylus that emitted the signal |
|
x |
the X coordinate of the stylus event |
|
y |
the Y coordinate of the stylus event |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
The “motion”
signal
void user_function (GtkGestureStylus *gesture, double x, double y, gpointer user_data)
A signal emitted when the stylus moves while touching the device.
Parameters
gesture |
the GtkGestureStylus that emitted the signal |
|
x |
the X coordinate of the stylus event |
|
y |
the Y coordinate of the stylus event |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
The “proximity”
signal
void user_function (GtkGestureStylus *gesture, double x, double y, gpointer user_data)
A signal emitted when the stylus is in proximity of the device.
Parameters
gesture |
the GtkGestureStylus that emitted the signal |
|
x |
the X coordinate of the stylus event |
|
y |
the Y coordinate of the stylus event |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
The “up”
signal
void user_function (GtkGestureStylus *gesture, double x, double y, gpointer user_data)
A signal emitted when the stylus no longer touches the device.
Parameters
gesture |
the GtkGestureStylus that emitted the signal |
|
x |
the X coordinate of the stylus event |
|
y |
the Y coordinate of the stylus event |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last