blob: f3c729d8325716178c9c976b4d4169c97f03a5f6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
#ifndef CURSORNAVIGATIONATTACHED_H
#define CURSORNAVIGATIONATTACHED_H
//#include <qqml.h>
#include <QObject>
#include <QList>
class CursorNavigation;
class QQuickItem;
class QQuickWindow;
class CursorNavigationAttached : public QObject
{
Q_OBJECT
//is included for cursor navigation
Q_PROPERTY(bool acceptsCursor READ acceptsCursor WRITE setAcceptsCursor NOTIFY acceptsCursorChanged)
//indicates if item is currently selected, indicated also by activeFocus property
Q_PROPERTY(bool hasCursor READ hasCursor NOTIFY hasCursorChanged)
//indicates if one of children is currently selected
Q_PROPERTY(bool childHasCursor READ hasCursor NOTIFY hasCursorChanged)
//traps cursor. a trapped cursor can not be traversed outside of the item that traps it until the escape input is given
Q_PROPERTY(bool trapsCursor READ trapsCursor WRITE setTrapsCursor NOTIFY trapsCursorChanged)
//item to select when
Q_PROPERTY(QQuickItem *escapeTarget READ escapeTarget WRITE setEscapeTarget NOTIFY escapeTargetChanged)
public:
CursorNavigationAttached(QQuickItem *parent);
~CursorNavigationAttached();
bool acceptsCursor() const;
bool hasCursor() const;
bool trapsCursor() const;
QQuickItem *escapeTarget() const;
/* indicates if the item is currently available for the navigation.
* item might not be availble if it is disabled, invisible, outside of its
* parent's geometry or simply not accepting cursor
*/
bool available() const;
QQuickItem *item() const;
public slots:
void setAcceptsCursor(bool acceptsCursor);
void setTrapsCursor(bool trapsCursor);
void setEscapeTarget(QQuickItem * escapeTarget);
/* just for passing movement changes forward. does not move the cursor.
* events are received by the item that currently has the cursor
*/
void setMagnitude(qreal angle, qreal magnitude);
void setMagnitude(QVector2D vector);
void move(qreal angle, qreal tolerance = 0);
void move(QVector2D vector, qreal tolerance = 0);
//find the next item with this move, without moving
QQuickItem *find(qreal angle, qreal tolerance = 0);
QQuickItem *find(QVector2D vector, qreal tolerance = 0);
void moveUp();
void moveDown();
void moveRight();
void moveLeft();
void activate();
void moveForward();
void moveBack();
void escape();
signals:
void acceptsCursorChanged(bool acceptsCursor);
void hasCursorChanged(bool hasCursor);
void trapsCursorChanged(bool trapsCursor);
void escapeTargetChanged(QQuickItem * escapeTarget);
void magnitudeChanged(qreal angle, qreal magnitude);
void moved(qreal angle, qreal tolerance);
void movedUp();
void movedDown();
void movedRight();
void movedLeft();
void activated();
void movedForward();
void movedBack();
void escaped();
private slots:
void onWindowChanged(QQuickWindow *window);
private:
void setHasCursor(bool hasCursor);
//QList<CursorNavigationAttached*> &siblings();
CursorNavigation *m_cursorNavigation;
CursorNavigationAttached *m_parentNavigable;
QList<CursorNavigationAttached*> m_children;
bool m_acceptsCursor;
bool m_hasCursor;
bool m_trapsCursor;
friend class CursorNavigation;
QQuickItem * m_escapeTarget;
};
#endif // CURSORNAVIGATIONATTACHED_H
|