1 /****************************************************************************
2 **
3 ** Copyright (C) 2017 The Qt Company Ltd.
4 ** Contact: http://www.qt.io/licensing/
5 **
6 ** This file is part of the Qt Quick Templates 2 module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL3$
9 ** Commercial License Usage
10 ** Licensees holding valid commercial Qt licenses may use this file in
11 ** accordance with the commercial license agreement provided with the
12 ** Software or, alternatively, in accordance with the terms contained in
13 ** a written agreement between you and The Qt Company. For licensing terms
14 ** and conditions see http://www.qt.io/terms-conditions. For further
15 ** information use the contact form at http://www.qt.io/contact-us.
16 **
17 ** GNU Lesser General Public License Usage
18 ** Alternatively, this file may be used under the terms of the GNU Lesser
19 ** General Public License version 3 as published by the Free Software
20 ** Foundation and appearing in the file LICENSE.LGPLv3 included in the
21 ** packaging of this file. Please review the following information to
22 ** ensure the GNU Lesser General Public License version 3 requirements
23 ** will be met: https://www.gnu.org/licenses/lgpl.html.
24 **
25 ** GNU General Public License Usage
26 ** Alternatively, this file may be used under the terms of the GNU
27 ** General Public License version 2.0 or later as published by the Free
28 ** Software Foundation and appearing in the file LICENSE.GPL included in
29 ** the packaging of this file. Please review the following information to
30 ** ensure the GNU General Public License version 2.0 requirements will be
31 ** met: http://www.gnu.org/licenses/gpl-2.0.html.
32 **
33 ** $QT_END_LICENSE$
34 **
35 ****************************************************************************/
36 
37 #ifndef QQUICKMENU_P_P_H
38 #define QQUICKMENU_P_P_H
39 
40 //
41 //  W A R N I N G
42 //  -------------
43 //
44 // This file is not part of the Qt API.  It exists purely as an
45 // implementation detail.  This header file may change from version to
46 // version without notice, or even be removed.
47 //
48 // We mean it.
49 //
50 
51 #include <QtCore/qvector.h>
52 #include <QtCore/qpointer.h>
53 
54 #include <QtQuickTemplates2/private/qquickmenu_p.h>
55 #include <QtQuickTemplates2/private/qquickpopup_p_p.h>
56 
57 QT_BEGIN_NAMESPACE
58 
59 class QQuickAction;
60 class QQmlComponent;
61 class QQmlObjectModel;
62 class QQuickMenuItem;
63 
64 class Q_QUICKTEMPLATES2_PRIVATE_EXPORT QQuickMenuPrivate : public QQuickPopupPrivate
65 {
66     Q_DECLARE_PUBLIC(QQuickMenu)
67 
68 public:
69     QQuickMenuPrivate();
70 
get(QQuickMenu * menu)71     static QQuickMenuPrivate *get(QQuickMenu *menu)
72     {
73         return menu->d_func();
74     }
75 
76     void init();
77 
78     QQuickItem *itemAt(int index) const;
79     void insertItem(int index, QQuickItem *item);
80     void moveItem(int from, int to);
81     void removeItem(int index, QQuickItem *item);
82 
83     QQuickItem *beginCreateItem();
84     void completeCreateItem();
85 
86     QQuickItem *createItem(QQuickMenu *menu);
87     QQuickItem *createItem(QQuickAction *action);
88 
89     void resizeItem(QQuickItem *item);
90     void resizeItems();
91 
92     void itemChildAdded(QQuickItem *item, QQuickItem *child) override;
93     void itemSiblingOrderChanged(QQuickItem *item) override;
94     void itemParentChanged(QQuickItem *item, QQuickItem *parent) override;
95     void itemDestroyed(QQuickItem *item) override;
96     void itemGeometryChanged(QQuickItem *, QQuickGeometryChange change, const QRectF &diff) override;
97 
98     QQuickPopupPositioner *getPositioner() override;
99     bool prepareEnterTransition() override;
100     bool prepareExitTransition() override;
101     bool blockInput(QQuickItem *item, const QPointF &point) const override;
102 
103     void onItemHovered();
104     void onItemTriggered();
105     void onItemActiveFocusChanged();
106 
107     QQuickMenu *currentSubMenu() const;
108     void setParentMenu(QQuickMenu *parent);
109     void resolveParentItem();
110 
111     void propagateKeyEvent(QKeyEvent *event);
112 
113     void startHoverTimer();
114     void stopHoverTimer();
115 
116     void setCurrentIndex(int index, Qt::FocusReason reason);
117     bool activateNextItem();
118     bool activatePreviousItem();
119 
120     QQuickMenuItem *firstEnabledMenuItem() const;
121 
122     static void contentData_append(QQmlListProperty<QObject> *prop, QObject *obj);
123     static int contentData_count(QQmlListProperty<QObject> *prop);
124     static QObject *contentData_at(QQmlListProperty<QObject> *prop, int index);
125     static void contentData_clear(QQmlListProperty<QObject> *prop);
126 
127     bool cascade = false;
128     int hoverTimer = 0;
129     int currentIndex = -1;
130     qreal overlap = 0;
131     QPointer<QQuickMenu> parentMenu;
132     QPointer<QQuickMenuItem> currentItem;
133     QQuickItem *contentItem = nullptr; // TODO: cleanup
134     QVector<QObject *> contentData;
135     QQmlObjectModel *contentModel;
136     QQmlComponent *delegate = nullptr;
137     QString title;
138 };
139 
140 QT_END_NAMESPACE
141 
142 #endif // QQUICKMENU_P_P_H
143