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