Qt 4.8
qsplitter.h
Go to the documentation of this file.
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 QSPLITTER_H
43 #define QSPLITTER_H
44 
45 #include <QtGui/qframe.h>
46 #include <QtGui/qsizepolicy.h>
47 
49 
51 
52 QT_MODULE(Gui)
53 
54 #ifndef QT_NO_SPLITTER
55 
56 class QSplitterPrivate;
57 class QTextStream;
58 template <typename T> class QList;
59 
60 class QSplitterHandle;
61 
63 {
64  Q_OBJECT
65 
70 
71 public:
72  explicit QSplitter(QWidget* parent = 0);
73  explicit QSplitter(Qt::Orientation, QWidget* parent = 0);
74  ~QSplitter();
75 
76  void addWidget(QWidget *widget);
77  void insertWidget(int index, QWidget *widget);
78 
79  void setOrientation(Qt::Orientation);
80  Qt::Orientation orientation() const;
81 
82  void setChildrenCollapsible(bool);
83  bool childrenCollapsible() const;
84 
85  void setCollapsible(int index, bool);
86  bool isCollapsible(int index) const;
87  void setOpaqueResize(bool opaque = true);
88  bool opaqueResize() const;
89  void refresh();
90 
91  QSize sizeHint() const;
92  QSize minimumSizeHint() const;
93 
94  QList<int> sizes() const;
95  void setSizes(const QList<int> &list);
96 
97  QByteArray saveState() const;
98  bool restoreState(const QByteArray &state);
99 
100  int handleWidth() const;
101  void setHandleWidth(int);
102 
103  int indexOf(QWidget *w) const;
104  QWidget *widget(int index) const;
105  int count() const;
106 
107  void getRange(int index, int *, int *) const;
108  QSplitterHandle *handle(int index) const;
109 
110  void setStretchFactor(int index, int stretch);
111 
112 Q_SIGNALS:
113  void splitterMoved(int pos, int index);
114 
115 protected:
116  virtual QSplitterHandle *createHandle();
117 
118  void childEvent(QChildEvent *);
119 
120  bool event(QEvent *);
121  void resizeEvent(QResizeEvent *);
122 
123  void changeEvent(QEvent *);
124  void moveSplitter(int pos, int index);
125  void setRubberBand(int position);
126  int closestLegalPosition(int, int);
127 
128 public:
129 #ifdef QT3_SUPPORT
130  QT3_SUPPORT_CONSTRUCTOR QSplitter(QWidget* parent, const char* name);
131  QT3_SUPPORT_CONSTRUCTOR QSplitter(Qt::Orientation, QWidget* parent, const char* name);
132  enum ResizeMode { Stretch, KeepSize, FollowSizeHint, Auto };
133  QT3_SUPPORT void setResizeMode(QWidget *w, ResizeMode mode);
134  inline QT3_SUPPORT void moveToFirst(QWidget *w) { insertWidget(0,w); }
135  inline QT3_SUPPORT void moveToLast(QWidget *w) { addWidget(w); }
136  inline QT3_SUPPORT void setCollapsible(QWidget *w, bool collapse)
137  { setCollapsible(indexOf(w), collapse); }
138  QT3_SUPPORT void setMargin(int margin) { setContentsMargins(margin, margin, margin, margin); }
139  QT3_SUPPORT int margin() const
140  { int margin; int dummy; getContentsMargins(&margin, &dummy, &dummy, &dummy); return margin; }
141 #endif
142 
143 private:
146 private:
147  friend class QSplitterHandle;
148 };
149 
150 //#ifdef QT3_SUPPORT
151 #ifndef QT_NO_TEXTSTREAM
154 #endif
155 //#endif
156 
159 {
160  Q_OBJECT
161 public:
163  void setOrientation(Qt::Orientation o);
164  Qt::Orientation orientation() const;
165  bool opaqueResize() const;
166  QSplitter *splitter() const;
167 
168  QSize sizeHint() const;
169 
170 protected:
171  void paintEvent(QPaintEvent *);
172  void mouseMoveEvent(QMouseEvent *);
175  void resizeEvent(QResizeEvent *);
176  bool event(QEvent *);
177 
178  void moveSplitter(int p);
179  int closestLegalPosition(int p);
180 
181 private:
184 };
185 
186 #endif // QT_NO_SPLITTER
187 
189 
191 
192 #endif // QSPLITTER_H
Q_GUI_EXPORT QTextStream & operator>>(QTextStream &, QSplitter &)
#define QT_END_NAMESPACE
This macro expands to.
Definition: qglobal.h:90
QPointer< QWidget > widget
#define QT_MODULE(x)
Definition: qglobal.h:2783
virtual QSize minimumSizeHint() const
#define QT_BEGIN_HEADER
Definition: qglobal.h:136
Qt::Orientation orientation
the orientation of the splitter
Definition: qsplitter.h:66
virtual void mouseReleaseEvent(QMouseEvent *)
This event handler, for event event, can be reimplemented in a subclass to receive mouse release even...
Definition: qwidget.cpp:9286
#define Q_GUI_EXPORT
Definition: qglobal.h:1450
The QByteArray class provides an array of bytes.
Definition: qbytearray.h:135
virtual void mousePressEvent(QMouseEvent *)
This event handler, for event event, can be reimplemented in a subclass to receive mouse press events...
Definition: qwidget.cpp:9261
static qreal position(QGraphicsObject *item, QDeclarativeAnchorLine::AnchorLine anchorLine)
The QWidget class is the base class of all user interface objects.
Definition: qwidget.h:150
virtual void resizeEvent(QResizeEvent *)
This event handler can be reimplemented in a subclass to receive widget resize events which are passe...
Definition: qwidget.cpp:9587
#define Q_DISABLE_COPY(Class)
Disables the use of copy constructors and assignment operators for the given Class.
Definition: qglobal.h:2523
The QSplitterHandle class provides handle functionality of the splitter.
Definition: qsplitter.h:158
#define Q_SIGNALS
Definition: qobjectdefs.h:72
bool opaqueResize
whether resizing is opaque
Definition: qsplitter.h:67
virtual QSize sizeHint() const
virtual void paintEvent(QPaintEvent *)
This event handler can be reimplemented in a subclass to receive paint events passed in event...
Definition: qwidget.cpp:9548
#define QT_BEGIN_NAMESPACE
This macro expands to.
Definition: qglobal.h:89
void changeEvent(QEvent *)
This event handler can be reimplemented to handle state changes.
Definition: qframe.cpp:574
void getContentsMargins(int *left, int *top, int *right, int *bottom) const
Returns the widget&#39;s contents margins for left, top, right, and bottom.
Definition: qwidget.cpp:7509
virtual void childEvent(QChildEvent *)
This event handler can be reimplemented in a subclass to receive child events.
Definition: qobject.cpp:1332
void setContentsMargins(int left, int top, int right, int bottom)
Sets the margins around the contents of the widget to have the sizes left, top, right, and bottom.
Definition: qwidget.cpp:7449
const char * name
The QResizeEvent class contains event parameters for resize events.
Definition: qevent.h:349
int handleWidth
the width of the splitter handles
Definition: qsplitter.h:68
#define Q_OBJECT
Definition: qobjectdefs.h:157
bool childrenCollapsible
whether child widgets can be resized down to size 0 by the user
Definition: qsplitter.h:69
The QMouseEvent class contains parameters that describe a mouse event.
Definition: qevent.h:85
The QChildEvent class contains event parameters for child object events.
Definition: qcoreevent.h:353
The QTextStream class provides a convenient interface for reading and writing text.
Definition: qtextstream.h:73
Q_GUI_EXPORT QTextStream & operator<<(QTextStream &, const QSplitter &)
bool event(QEvent *e)
Reimplemented Function
Definition: qframe.cpp:587
quint16 index
QSize sizeHint() const
em>Reimplemented Function
Definition: qframe.cpp:508
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53
#define Q_DECLARE_PRIVATE(Class)
Definition: qglobal.h:2467
bool event(QEvent *)
This is the main event handler; it handles event event.
Definition: qwidget.cpp:8636
virtual void mouseMoveEvent(QMouseEvent *)
This event handler, for event event, can be reimplemented in a subclass to receive mouse move events ...
Definition: qwidget.cpp:9239
The QPaintEvent class contains event parameters for paint events.
Definition: qevent.h:298
Orientation
Definition: qnamespace.h:174
The QEvent class is the base class of all event classes.
Definition: qcoreevent.h:56
The QFrame class is the base class of widgets that can have a frame.
Definition: qframe.h:55
#define QT_END_HEADER
Definition: qglobal.h:137
The QSplitter class implements a splitter widget.
Definition: qsplitter.h:62
The QList class is a template class that provides lists.
Definition: qdatastream.h:62