src/gui/painting/qplatformbackingstore_qpa.cpp

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
   4 ** Contact: http://www.qt-project.org/
   5 **
   6 ** This file is part of the QtGui module of the Qt Toolkit.
   7 **
   8 ** $QT_BEGIN_LICENSE:LGPL$
   9 ** GNU Lesser General Public License Usage
  10 ** This file may be used under the terms of the GNU Lesser General Public
  11 ** License version 2.1 as published by the Free Software Foundation and
  12 ** appearing in the file LICENSE.LGPL included in the packaging of this
  13 ** file. Please review the following information to ensure the GNU Lesser
  14 ** General Public License version 2.1 requirements will be met:
  15 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
  16 **
  17 ** In addition, as a special exception, Nokia gives you certain additional
  18 ** rights. These rights are described in the Nokia Qt LGPL Exception
  19 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
  20 **
  21 ** GNU General Public License Usage
  22 ** Alternatively, this file may be used under the terms of the GNU General
  23 ** Public License version 3.0 as published by the Free Software Foundation
  24 ** and appearing in the file LICENSE.GPL included in the packaging of this
  25 ** file. Please review the following information to ensure the GNU General
  26 ** Public License version 3.0 requirements will be met:
  27 ** http://www.gnu.org/copyleft/gpl.html.
  28 **
  29 ** Other Usage
  30 ** Alternatively, this file may be used in accordance with the terms and
  31 ** conditions contained in a signed written agreement between you and Nokia.
  32 **
  33 **
  34 **
  35 **
  36 **
  37 **
  38 ** $QT_END_LICENSE$
  39 **
  40 ****************************************************************************/
  41
  42 #include "qplatformbackingstore.h"
  43 #include <qwindow.h>
  44 #include <qpixmap.h>
  45 #include <private/qwindow_p.h>
  46
  47 QT_BEGIN_NAMESPACE
  48
  49 class QPlatformBackingStorePrivate
  50 {
  51 public:
  52     QPlatformBackingStorePrivate(QWindow *w)
  53         : window(w)
  54     {
  55     }
  56
  57     QWindow *window;
  58     QSize size;
  59 };
  60
  61 /*!
  62     \class QPlatformBackingStore
  63     \since 5.0
  64     \internal
  65     \preliminary
  66     \ingroup qpa
  67
  68     \brief The QPlatformBackingStore class provides the drawing area for top-level
  69     windows.
  70 */
  71
  72 /*!
  73     \fn void QPlatformBackingStore::flush(QWindow *window, const QRegion &region,
  74                                   const QPoint &offset)
  75
  76     Flushes the given \a region from the specified \a window onto the
  77     screen.
  78
  79     Note that the \a offset parameter is currently unused.
  80 */
  81
  82 /*!
  83     \fn QPaintDevice* QPlatformBackingStore::paintDevice()
  84
  85     Implement this function to return the appropriate paint device.
  86 */
  87
  88 /*!
  89     Constructs an empty surface for the given top-level \a window.
  90 */
  91 QPlatformBackingStore::QPlatformBackingStore(QWindow *window)
  92     : d_ptr(new QPlatformBackingStorePrivate(window))
  93 {
  94 }
  95
  96 /*!
  97     Destroys this surface.
  98 */
  99 QPlatformBackingStore::~QPlatformBackingStore()
 100 {
 101     delete d_ptr;
 102 }
 103
 104 /*!
 105     Returns a pointer to the top-level window associated with this
 106     surface.
 107 */
 108 QWindow* QPlatformBackingStore::window() const
 109 {
 110     return d_ptr->window;
 111 }
 112
 113 /*!
 114     This function is called before painting onto the surface begins,
 115     with the \a region in which the painting will occur.
 116
 117     \sa endPaint(), paintDevice()
 118 */
 119
 120 void QPlatformBackingStore::beginPaint(const QRegion &)
 121 {
 122 }
 123
 124 /*!
 125     This function is called after painting onto the surface has ended.
 126
 127     \sa beginPaint(), paintDevice()
 128 */
 129
 130 void QPlatformBackingStore::endPaint()
 131 {
 132 }
 133
 134 /*!
 135     Scrolls the given \a area \a dx pixels to the right and \a dy
 136     downward; both \a dx and \a dy may be negative.
 137
 138     Returns true if the area was scrolled successfully; false otherwise.
 139 */
 140 bool QPlatformBackingStore::scroll(const QRegion &area, int dx, int dy)
 141 {
 142     Q_UNUSED(area);
 143     Q_UNUSED(dx);
 144     Q_UNUSED(dy);
 145
 146     return false;
 147 }
 148
 149 QT_END_NAMESPACE