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,
  87         ThreadedOpenGL,
  88         SharedGraphicsCache,
  89         BufferQueueingOpenGL,
  90         WindowMasks,
  91         MultipleWindows
  92     };
  93
  94     virtual ~QPlatformIntegration() { }
  95
  96     virtual bool hasCapability(Capability cap) const;
  97
  98     virtual QPlatformPixmap *createPlatformPixmap(QPlatformPixmap::PixelType type) const;
  99     virtual QPlatformWindow *createPlatformWindow(QWindow *window) const = 0;
 100     virtual QPlatformBackingStore *createPlatformBackingStore(QWindow *window) const = 0;
 101 #ifndef QT_NO_OPENGL
 102     virtual QPlatformOpenGLContext *createPlatformOpenGLContext(QOpenGLContext *context) const;
 103 #endif
 104     virtual QPlatformSharedGraphicsCache *createPlatformSharedGraphicsCache(const char *cacheId) const;
 105     virtual QPaintEngine *createImagePaintEngine(QPaintDevice *paintDevice) const;
 106
 107 // Event dispatcher:
 108     virtual QAbstractEventDispatcher *guiThreadEventDispatcher() const = 0;
 109
 110 //Deeper window system integrations
 111     virtual QPlatformFontDatabase *fontDatabase() const;
 112 #ifndef QT_NO_CLIPBOARD
 113     virtual QPlatformClipboard *clipboard() const;
 114 #endif
 115 #ifndef QT_NO_DRAGANDDROP
 116     virtual QPlatformDrag *drag() const;
 117 #endif
 118     virtual QPlatformInputContext *inputContext() const;
 119 #ifndef QT_NO_ACCESSIBILITY
 120     virtual QPlatformAccessibility *accessibility() const;
 121 #endif
 122
 123     // Access native handles. The window handle is already available from Wid;
 124     virtual QPlatformNativeInterface *nativeInterface() const;
 125
 126     virtual QPlatformServices *services() const;
 127
 128     enum StyleHint {
 129         CursorFlashTime,
 130         KeyboardInputInterval,
 131         MouseDoubleClickInterval,
 132         StartDragDistance,
 133         StartDragTime,
 134         KeyboardAutoRepeatRate,
 135         ShowIsFullScreen,
 136         PasswordMaskDelay,
 137         FontSmoothingGamma,
 138         StartDragVelocity,
 139         UseRtlExtensions,
 140         SynthesizeMouseFromTouchEvents
 141     };
 142
 143     virtual QVariant styleHint(StyleHint hint) const;
 144
 145     virtual Qt::KeyboardModifiers queryKeyboardModifiers() const;
 146     virtual QList<int> possibleKeys(const QKeyEvent *) const;
 147
 148     virtual QStringList themeNames() const;
 149     virtual QPlatformTheme *createPlatformTheme(const QString &name) const;
 150
 151 protected:
 152     void screenAdded(QPlatformScreen *screen);
 153 };
 154
 155 QT_END_NAMESPACE
 156
 157 QT_END_HEADER
 158
 159 #endif // QPLATFORMINTEGRATION_H