Qt 4.8
qgridlayout.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 QGRIDLAYOUT_H
43 #define QGRIDLAYOUT_H
44 
45 #include <QtGui/qlayout.h>
46 #ifdef QT_INCLUDE_COMPAT
47 #include <QtGui/qwidget.h>
48 #endif
49 
50 #include <limits.h>
51 
53 
55 
56 QT_MODULE(Gui)
57 
58 class QGridLayoutPrivate;
59 
61 {
62  Q_OBJECT
64  QDOC_PROPERTY(int horizontalSpacing READ horizontalSpacing WRITE setHorizontalSpacing)
65  QDOC_PROPERTY(int verticalSpacing READ verticalSpacing WRITE setVerticalSpacing)
66 
67 public:
68  explicit QGridLayout(QWidget *parent);
69  QGridLayout();
70 
71 #ifdef QT3_SUPPORT
72  QT3_SUPPORT_CONSTRUCTOR QGridLayout(QWidget *parent, int nRows , int nCols = 1, int border = 0,
73  int spacing = -1, const char *name = 0);
74  QT3_SUPPORT_CONSTRUCTOR QGridLayout(int nRows , int nCols = 1, int spacing = -1, const char *name = 0);
75  QT3_SUPPORT_CONSTRUCTOR QGridLayout(QLayout *parentLayout, int nRows = 1, int nCols = 1, int spacing = -1,
76  const char *name = 0);
77 #endif
78  ~QGridLayout();
79 
80  QSize sizeHint() const;
81  QSize minimumSize() const;
82  QSize maximumSize() const;
83 
84  void setHorizontalSpacing(int spacing);
85  int horizontalSpacing() const;
86  void setVerticalSpacing(int spacing);
87  int verticalSpacing() const;
88  void setSpacing(int spacing);
89  int spacing() const;
90 
91  void setRowStretch(int row, int stretch);
92  void setColumnStretch(int column, int stretch);
93  int rowStretch(int row) const;
94  int columnStretch(int column) const;
95 
96  void setRowMinimumHeight(int row, int minSize);
97  void setColumnMinimumWidth(int column, int minSize);
98  int rowMinimumHeight(int row) const;
99  int columnMinimumWidth(int column) const;
100 
101  int columnCount() const;
102  int rowCount() const;
103 
104  QRect cellRect(int row, int column) const;
105 #ifdef QT3_SUPPORT
106  inline QT3_SUPPORT QRect cellGeometry(int row, int column) const {return cellRect(row, column);}
107 #endif
108 
109  bool hasHeightForWidth() const;
110  int heightForWidth(int) const;
111  int minimumHeightForWidth(int) const;
112 
113  Qt::Orientations expandingDirections() const;
114  void invalidate();
115 
116  inline void addWidget(QWidget *w) { QLayout::addWidget(w); }
117  void addWidget(QWidget *, int row, int column, Qt::Alignment = 0);
118  void addWidget(QWidget *, int row, int column, int rowSpan, int columnSpan, Qt::Alignment = 0);
119  void addLayout(QLayout *, int row, int column, Qt::Alignment = 0);
120  void addLayout(QLayout *, int row, int column, int rowSpan, int columnSpan, Qt::Alignment = 0);
121 
122  void setOriginCorner(Qt::Corner);
123  Qt::Corner originCorner() const;
124 
125 #ifdef QT3_SUPPORT
126  inline QT3_SUPPORT void setOrigin(Qt::Corner corner) { setOriginCorner(corner); }
127  inline QT3_SUPPORT Qt::Corner origin() const { return originCorner(); }
128 #endif
129  QLayoutItem *itemAt(int index) const;
130  QLayoutItem *itemAtPosition(int row, int column) const;
131  QLayoutItem *takeAt(int index);
132  int count() const;
133  void setGeometry(const QRect&);
134 
135  void addItem(QLayoutItem *item, int row, int column, int rowSpan = 1, int columnSpan = 1, Qt::Alignment = 0);
136 
137  void setDefaultPositioning(int n, Qt::Orientation orient);
138  void getItemPosition(int idx, int *row, int *column, int *rowSpan, int *columnSpan);
139 
140 protected:
141 #ifdef QT3_SUPPORT
142  QT3_SUPPORT bool findWidget(QWidget* w, int *r, int *c);
143 #endif
144  void addItem(QLayoutItem *);
145 
146 private:
147  Q_DISABLE_COPY(QGridLayout)
148 
149 public:
150 #ifdef QT3_SUPPORT
151  QT3_SUPPORT void expand(int rows, int cols);
152  inline QT3_SUPPORT void addRowSpacing(int row, int minsize) { addItem(new QSpacerItem(0,minsize), row, 0); }
153  inline QT3_SUPPORT void addColSpacing(int col, int minsize) { addItem(new QSpacerItem(minsize,0), 0, col); }
154  inline QT3_SUPPORT void addMultiCellWidget(QWidget *w, int fromRow, int toRow, int fromCol, int toCol, Qt::Alignment _align = 0)
155  { addWidget(w, fromRow, fromCol, (toRow < 0) ? -1 : toRow - fromRow + 1, (toCol < 0) ? -1 : toCol - fromCol + 1, _align); }
156  inline QT3_SUPPORT void addMultiCell(QLayoutItem *l, int fromRow, int toRow, int fromCol, int toCol, Qt::Alignment _align = 0)
157  { addItem(l, fromRow, fromCol, (toRow < 0) ? -1 : toRow - fromRow + 1, (toCol < 0) ? -1 : toCol - fromCol + 1, _align); }
158  inline QT3_SUPPORT void addMultiCellLayout(QLayout *layout, int fromRow, int toRow, int fromCol, int toCol, Qt::Alignment _align = 0)
159  { addLayout(layout, fromRow, fromCol, (toRow < 0) ? -1 : toRow - fromRow + 1, (toCol < 0) ? -1 : toCol - fromCol + 1, _align); }
160 
161  inline QT3_SUPPORT int numRows() const { return rowCount(); }
162  inline QT3_SUPPORT int numCols() const { return columnCount(); }
163  inline QT3_SUPPORT void setColStretch(int col, int stretch) {setColumnStretch(col, stretch); }
164  inline QT3_SUPPORT int colStretch(int col) const {return columnStretch(col); }
165  inline QT3_SUPPORT void setColSpacing(int col, int minSize) { setColumnMinimumWidth(col, minSize); }
166  inline QT3_SUPPORT int colSpacing(int col) const { return columnMinimumWidth(col); }
167  inline QT3_SUPPORT void setRowSpacing(int row, int minSize) {setRowMinimumHeight(row, minSize); }
168  inline QT3_SUPPORT int rowSpacing(int row) const {return rowMinimumHeight(row); }
169 #endif
170 };
171 
173 
175 
176 #endif // QGRIDLAYOUT_H
virtual QLayoutItem * itemAt(int index) const =0
Must be implemented in subclasses to return the layout item at index.
unsigned char c[8]
Definition: qnumeric_p.h:62
#define QT_END_NAMESPACE
This macro expands to.
Definition: qglobal.h:90
void setSpacing(int)
Definition: qlayout.cpp:469
#define QDOC_PROPERTY(text)
Definition: qglobal.h:2503
#define QT_MODULE(x)
Definition: qglobal.h:2783
#define QT_BEGIN_HEADER
Definition: qglobal.h:136
#define Q_GUI_EXPORT
Definition: qglobal.h:1450
virtual void addItem(QLayoutItem *)=0
Implemented in subclasses to add an item.
The QWidget class is the base class of all user interface objects.
Definition: qwidget.h:150
virtual int minimumHeightForWidth(int) const
Returns the minimum height this widget needs for the given width, w.
#define Q_DISABLE_COPY(Class)
Disables the use of copy constructors and assignment operators for the given Class.
Definition: qglobal.h:2523
virtual void setGeometry(const QRect &)
Reimplemented Function
Definition: qlayout.cpp:655
void invalidate()
Reimplemented Function
Definition: qlayout.cpp:673
virtual bool hasHeightForWidth() const
Returns true if this layout&#39;s preferred height depends on its width; otherwise returns false...
int spacing() const
Qt::Orientations expandingDirections() const
Returns whether this layout can make use of more space than sizeHint().
Definition: qlayout.cpp:1198
QSize maximumSize() const
Returns the maximum size of this layout.
Definition: qlayout.cpp:1181
virtual QLayoutItem * takeAt(int index)=0
Must be implemented in subclasses to remove the layout item at index from the layout, and return the item.
#define QT_BEGIN_NAMESPACE
This macro expands to.
Definition: qglobal.h:89
The QLayoutItem class provides an abstract item that a QLayout manipulates.
Definition: qlayoutitem.h:64
The QSpacerItem class provides blank space in a layout.
Definition: qlayoutitem.h:96
The QLayout class is the base class of geometry managers.
Definition: qlayout.h:90
const char * name
const char * layout
#define Q_OBJECT
Definition: qobjectdefs.h:157
Corner
Definition: qnamespace.h:1456
virtual int count() const =0
Must be implemented in subclasses to return the number of items in the layout.
void addWidget(QWidget *w)
Adds widget w to this layout in a manner specific to the layout.
Definition: qlayout.cpp:319
virtual QSize sizeHint() const =0
Implemented in subclasses to return the preferred size of this item.
The QGridLayout class lays out widgets in a grid.
Definition: qgridlayout.h:60
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
QFactoryLoader * l
quint16 index
QSize minimumSize() const
Returns the minimum size of this layout.
Definition: qlayout.cpp:1166
virtual int heightForWidth(int) const
Returns the preferred height for this layout item, given the width w.
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
void addWidget(QWidget *w)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: qgridlayout.h:116
Orientation
Definition: qnamespace.h:174
#define QT_END_HEADER
Definition: qglobal.h:137