Be able to obtain list of possible key combinations in platform integration
[profile/ivi/qtbase.git] / src / gui / kernel / qplatformintegration.h
1 /****************************************************************************
2 **
3 ** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
4 ** Contact: http://www.qt-project.org/legal
5 **
6 ** This file is part of the QtGui module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL$
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 Digia.  For licensing terms and
14 ** conditions see http://qt.digia.com/licensing.  For further information
15 ** use the contact form at http://qt.digia.com/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 2.1 as published by the Free Software
20 ** Foundation and appearing in the file LICENSE.LGPL included in the
21 ** packaging of this file.  Please review the following information to
22 ** ensure the GNU Lesser General Public License version 2.1 requirements
23 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24 **
25 ** In addition, as a special exception, Digia gives you certain additional
26 ** rights.  These rights are described in the Digia Qt LGPL Exception
27 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28 **
29 ** GNU General Public License Usage
30 ** Alternatively, this file may be used under the terms of the GNU
31 ** General Public License version 3.0 as published by the Free Software
32 ** Foundation and appearing in the file LICENSE.GPL included in the
33 ** packaging of this file.  Please review the following information to
34 ** ensure the GNU General Public License version 3.0 requirements will be
35 ** met: http://www.gnu.org/copyleft/gpl.html.
36 **
37 **
38 ** $QT_END_LICENSE$
39 **
40 ****************************************************************************/
41
42 #ifndef QPLATFORMINTEGRATION_H
43 #define QPLATFORMINTEGRATION_H
44
45 //
46 //  W A R N I N G
47 //  -------------
48 //
49 // This file is part of the QPA API and is not meant to be used
50 // in applications. Usage of this API may make your code
51 // source and binary incompatible with future versions of Qt.
52 //
53
54 #include <QtGui/qwindowdefs.h>
55 #include <qpa/qplatformscreen.h>
56 #include <QtGui/qsurfaceformat.h>
57
58 QT_BEGIN_HEADER
59
60 QT_BEGIN_NAMESPACE
61
62
63 class QPlatformWindow;
64 class QWindow;
65 class QPlatformBackingStore;
66 class QPlatformFontDatabase;
67 class QPlatformClipboard;
68 class QPlatformNativeInterface;
69 class QPlatformDrag;
70 class QPlatformOpenGLContext;
71 class QGuiGLFormat;
72 class QAbstractEventDispatcher;
73 class QPlatformInputContext;
74 class QPlatformAccessibility;
75 class QPlatformTheme;
76 class QPlatformDialogHelper;
77 class QPlatformSharedGraphicsCache;
78 class QPlatformServices;
79 class QKeyEvent;
80
81 class Q_GUI_EXPORT QPlatformIntegration
82 {
83 public:
84     enum Capability {
85         ThreadedPixmaps = 1,
86         OpenGL = 2,
87         ThreadedOpenGL = 3,
88         SharedGraphicsCache = 4,
89         BufferQueueingOpenGL = 5,
90         WindowMasks = 6
91     };
92
93     virtual ~QPlatformIntegration() { }
94
95     virtual bool hasCapability(Capability cap) const;
96
97     virtual QPlatformPixmap *createPlatformPixmap(QPlatformPixmap::PixelType type) const;
98     virtual QPlatformWindow *createPlatformWindow(QWindow *window) const = 0;
99     virtual QPlatformBackingStore *createPlatformBackingStore(QWindow *window) const = 0;
100 #ifndef QT_NO_OPENGL
101     virtual QPlatformOpenGLContext *createPlatformOpenGLContext(QOpenGLContext *context) const;
102 #endif
103     virtual QPlatformSharedGraphicsCache *createPlatformSharedGraphicsCache(const char *cacheId) const;
104     virtual QPaintEngine *createImagePaintEngine(QPaintDevice *paintDevice) const;
105
106 // Event dispatcher:
107     virtual QAbstractEventDispatcher *guiThreadEventDispatcher() const = 0;
108
109 //Deeper window system integrations
110     virtual QPlatformFontDatabase *fontDatabase() const;
111 #ifndef QT_NO_CLIPBOARD
112     virtual QPlatformClipboard *clipboard() const;
113 #endif
114 #ifndef QT_NO_DRAGANDDROP
115     virtual QPlatformDrag *drag() const;
116 #endif
117     virtual QPlatformInputContext *inputContext() const;
118 #ifndef QT_NO_ACCESSIBILITY
119     virtual QPlatformAccessibility *accessibility() const;
120 #endif
121
122     // Access native handles. The window handle is already available from Wid;
123     virtual QPlatformNativeInterface *nativeInterface() const;
124
125     virtual QPlatformServices *services() const;
126
127     enum StyleHint {
128         CursorFlashTime,
129         KeyboardInputInterval,
130         MouseDoubleClickInterval,
131         StartDragDistance,
132         StartDragTime,
133         KeyboardAutoRepeatRate,
134         ShowIsFullScreen,
135         PasswordMaskDelay,
136         FontSmoothingGamma,
137         StartDragVelocity,
138         UseRtlExtensions,
139         SynthesizeMouseFromTouchEvents
140     };
141
142     virtual QVariant styleHint(StyleHint hint) const;
143
144     virtual Qt::KeyboardModifiers queryKeyboardModifiers() const;
145     virtual QList<int> possibleKeys(const QKeyEvent *) const;
146
147     virtual QStringList themeNames() const;
148     virtual QPlatformTheme *createPlatformTheme(const QString &name) const;
149
150 protected:
151     void screenAdded(QPlatformScreen *screen);
152 };
153
154 QT_END_NAMESPACE
155
156 QT_END_HEADER
157
158 #endif // QPLATFORMINTEGRATION_H