GtkGestureStylus
GtkGestureStylus — Жест для ввода стилусом
Функции
| 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 () |
Типы и значения
Иерархия объектов
GObject
╰── GtkEventController
╰── GtkGesture
╰── GtkGestureSingle
╰── GtkGestureStylus
Файлы
#include <gtk/gtk.h>
Описание
GtkGestureStylus — реализация GtkGesture, предназначенная для ввода стилусом. Предоставляемые сигналы просто передают основную информацию о событиях стилуса.
Функции
gtk_gesture_stylus_new ()
GtkGesture *
gtk_gesture_stylus_new (void); Создаёт новый GtkGestureStylus.
Возвращает
новый созданный жест стилуса
gtk_gesture_stylus_get_axis ()
gboolean gtk_gesture_stylus_get_axis (GtkGestureStylus *gesture,GdkAxisUse axis,double *value);
Возвращает текущее значение для запрошенной axis .
Эта функция должна вызываться из обработчика одного из сигналов «down», «motion», «up» или «proximity».
Параметры
gesture | GtkGestureStylus | |
axis | Запрашиваемая ось устройства | |
value | Место хранения значения оси. | [out] |
Возвращает
TRUE если для оси есть текущее значение
gtk_gesture_stylus_get_axes ()
gboolean gtk_gesture_stylus_get_axes (GtkGestureStylus *gesture,GdkAxisUse axes[],double **values);
Возвращает текущие значения для запрошенных axes . Эта функция должна вызываться из сигналов «down», «motion», «up» или «proximity».
Параметры
gesture | GtkGestureStylus | |
axes | Массив запрошенных осей, завершаемый GDK_AXIS_IGNORE. | [array] |
values | Место хранения значений осей. | [out][array] |
Возвращает
TRUE если для осей есть текущее значение
gtk_gesture_stylus_get_backlog ()
gboolean gtk_gesture_stylus_get_backlog (GtkGestureStylus *gesture,GdkTimeCoord **backlog,guint *n_elems);
По умолчанию GTK ограничит скорость событий ввода. При вводе стилусом, где точность линий имеет первостепенное значение, эта функция возвращает накопленное состояние координат/времени перед вызовом текущего сигнала «motion».
Эта функция может вызываться только внутри обработчика сигнала «motion». Состояние, указанное в этом сигнале и получаемое через вызов gtk_gesture_stylus_get_axis(), выражает последнее (самое обновлённое) состояние в истории движений.
Значения backlog предоставляются в хронологическом порядке.
Параметры
gesture | GtkGestureStylus | |
backlog | Координаты и временные метки для событий в очереди. | [out][array length=n_elems] |
n_elems | Место хранения количества элементов. | [out] |
Возвращает
TRUE если в текущем состоянии есть очередь для обработки.
gtk_gesture_stylus_get_device_tool ()
GdkDeviceTool *
gtk_gesture_stylus_get_device_tool (GtkGestureStylus *gesture); Возвращает GdkDeviceTool, который в настоящее время управляет вводом через этот жест. Эта функция должна вызываться из обработчиков сигналов «down», «motion», «up» или «proximity».
Параметры
gesture | GtkGestureStylus |
Возвращает
Текущий инструмент стилуса.
[nullable][transfer none]
Типы и значения
GtkGestureStylus
typedef struct _GtkGestureStylus GtkGestureStylus;
Подробности сигналов
Сигнал “down”
void user_function (GtkGestureStylus *gesture, double x, double y, gpointer user_data)
Сигнал, генерируемый при касании стилусом устройства.
Параметры
gesture | объект GtkGestureStylus, отправивший сигнал | |
x | координата X события стилуса | |
y | координата Y события стилуса | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Выполнить последним
Сигнал “motion”
void user_function (GtkGestureStylus *gesture, double x, double y, gpointer user_data)
Сигнал, генерируемый при перемещении стилуса, когда он касается устройства.
Параметры
gesture | объект GtkGestureStylus, отправивший сигнал | |
x | координата X события стилуса | |
y | координата Y события стилуса | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Выполнить последним
Сигнал “proximity”
void user_function (GtkGestureStylus *gesture, double x, double y, gpointer user_data)
Сигнал, генерируемый, когда стилус находится вблизи устройства.
Параметры
gesture | объект GtkGestureStylus, отправивший сигнал | |
x | координата X события стилуса | |
y | координата Y события стилуса | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Выполнить последним
Сигнал “up”
void user_function (GtkGestureStylus *gesture, double x, double y, gpointer user_data)
Сигнал, генерируемый, когда стилус больше не касается устройства.
Параметры
gesture | объект GtkGestureStylus, отправивший сигнал | |
x | координата X события стилуса | |
y | координата Y события стилуса | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Выполнить последним
См. также
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkGestureStylus.html
