1/****************************************************************************
2**
3** Copyright (C) 2014 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 QABSTRACTSCROLLAREA_H
43#define QABSTRACTSCROLLAREA_H
44
45#include <QtGui/qframe.h>
46
47QT_BEGIN_HEADER
48
49QT_BEGIN_NAMESPACE
50
51QT_MODULE(Gui)
52
53#ifndef QT_NO_SCROLLAREA
54
55class QMargins;
56class QScrollBar;
57class QAbstractScrollAreaPrivate;
58
59class Q_GUI_EXPORT QAbstractScrollArea : public QFrame
60{
61 Q_OBJECT
62 Q_PROPERTY(Qt::ScrollBarPolicy verticalScrollBarPolicy READ verticalScrollBarPolicy WRITE setVerticalScrollBarPolicy)
63 Q_PROPERTY(Qt::ScrollBarPolicy horizontalScrollBarPolicy READ horizontalScrollBarPolicy WRITE setHorizontalScrollBarPolicy)
64
65public:
66 explicit QAbstractScrollArea(QWidget* parent=0);
67 ~QAbstractScrollArea();
68
69 Qt::ScrollBarPolicy verticalScrollBarPolicy() const;
70 void setVerticalScrollBarPolicy(Qt::ScrollBarPolicy);
71 QScrollBar *verticalScrollBar() const;
72 void setVerticalScrollBar(QScrollBar *scrollbar);
73
74 Qt::ScrollBarPolicy horizontalScrollBarPolicy() const;
75 void setHorizontalScrollBarPolicy(Qt::ScrollBarPolicy);
76 QScrollBar *horizontalScrollBar() const;
77 void setHorizontalScrollBar(QScrollBar *scrollbar);
78
79 QWidget *cornerWidget() const;
80 void setCornerWidget(QWidget *widget);
81
82 void addScrollBarWidget(QWidget *widget, Qt::Alignment alignment);
83 QWidgetList scrollBarWidgets(Qt::Alignment alignment);
84
85 QWidget *viewport() const;
86 void setViewport(QWidget *widget);
87 QSize maximumViewportSize() const;
88
89 QSize minimumSizeHint() const;
90
91 QSize sizeHint() const;
92
93protected Q_SLOTS:
94 void setupViewport(QWidget *viewport);
95
96protected:
97 QAbstractScrollArea(QAbstractScrollAreaPrivate &dd, QWidget *parent = 0);
98 void setViewportMargins(int left, int top, int right, int bottom);
99 void setViewportMargins(const QMargins &margins);
100
101 bool event(QEvent *);
102 virtual bool viewportEvent(QEvent *);
103
104 void resizeEvent(QResizeEvent *);
105 void paintEvent(QPaintEvent *);
106 void mousePressEvent(QMouseEvent *);
107 void mouseReleaseEvent(QMouseEvent *);
108 void mouseDoubleClickEvent(QMouseEvent *);
109 void mouseMoveEvent(QMouseEvent *);
110#ifndef QT_NO_WHEELEVENT
111 void wheelEvent(QWheelEvent *);
112#endif
113#ifndef QT_NO_CONTEXTMENU
114 void contextMenuEvent(QContextMenuEvent *);
115#endif
116#ifndef QT_NO_DRAGANDDROP
117 void dragEnterEvent(QDragEnterEvent *);
118 void dragMoveEvent(QDragMoveEvent *);
119 void dragLeaveEvent(QDragLeaveEvent *);
120 void dropEvent(QDropEvent *);
121#endif
122
123 void keyPressEvent(QKeyEvent *);
124
125 virtual void scrollContentsBy(int dx, int dy);
126
127private:
128 Q_DECLARE_PRIVATE(QAbstractScrollArea)
129 Q_DISABLE_COPY(QAbstractScrollArea)
130 Q_PRIVATE_SLOT(d_func(), void _q_hslide(int))
131 Q_PRIVATE_SLOT(d_func(), void _q_vslide(int))
132 Q_PRIVATE_SLOT(d_func(), void _q_showOrHideScrollBars())
133
134 friend class QStyleSheetStyle;
135 friend class QWidgetPrivate;
136};
137
138#endif // QT_NO_SCROLLAREA
139
140QT_END_NAMESPACE
141
142QT_END_HEADER
143
144#endif // QABSTRACTSCROLLAREA_H
145