QStackedLayout¶
The
QStackedLayout
class provides a stack of widgets where only one widget is visible at a time. More…
Synopsis¶
Functions¶
def
currentIndex
()def
currentWidget
()def
insertWidget
(index, w)def
setStackingMode
(stackingMode)def
stackingMode
()def
widget
(arg__1)
Slots¶
def
setCurrentIndex
(index)def
setCurrentWidget
(w)
Signals¶
def
currentChanged
(index)def
widgetRemoved
(index)
Detailed Description¶
QStackedLayout
can be used to create a user interface similar to the one provided byQTabWidget
. There is also a convenienceQStackedWidget
class built on top ofQStackedLayout
.A
QStackedLayout
can be populated with a number of child widgets (“pages”). For example:QWidget *firstPageWidget = new QWidget; QWidget *secondPageWidget = new QWidget; QWidget *thirdPageWidget = new QWidget; QStackedLayout *stackedLayout = new QStackedLayout; stackedLayout->addWidget(firstPageWidget); stackedLayout->addWidget(secondPageWidget); stackedLayout->addWidget(thirdPageWidget); QVBoxLayout *mainLayout = new QVBoxLayout; mainLayout->addLayout(stackedLayout); setLayout(mainLayout);
QStackedLayout
provides no intrinsic means for the user to switch page. This is typically done through aQComboBox
or aQListWidget
that stores the titles of theQStackedLayout
‘s pages. For example:QComboBox *pageComboBox = new QComboBox; pageComboBox->addItem(tr("Page 1")); pageComboBox->addItem(tr("Page 2")); pageComboBox->addItem(tr("Page 3")); connect(pageComboBox, SIGNAL(activated(int)), stackedLayout, SLOT(setCurrentIndex(int)));When populating a layout, the widgets are added to an internal list. The
indexOf()
function returns the index of a widget in that list. The widgets can either be added to the end of the list using theaddWidget()
function, or inserted at a given index using theinsertWidget()
function. TheremoveWidget()
function removes the widget at the given index from the layout. The number of widgets contained in the layout, can be obtained using thecount()
function.The
widget()
function returns the widget at a given index position. The index of the widget that is shown on screen is given bycurrentIndex()
and can be changed usingsetCurrentIndex()
. In a similar manner, the currently shown widget can be retrieved using thecurrentWidget()
function, and altered using thesetCurrentWidget()
function.Whenever the current widget in the layout changes or a widget is removed from the layout, the
currentChanged()
andwidgetRemoved()
signals are emitted respectively.See also
-
class
QStackedLayout
¶ Constructs a
QStackedLayout
with no parent.This
QStackedLayout
must be installed on a widget later on to become effective.See also
addWidget()
insertWidget()
Constructs a new
QStackedLayout
and inserts it into the givenparentLayout
.Constructs a new
QStackedLayout
with the givenparent
.This layout will install itself on the
parent
widget and manage the geometry of its children.
-
PySide2.QtWidgets.QStackedLayout.
StackingMode
¶ This enum specifies how the layout handles its child widgets regarding their visibility.
Constant
Description
QStackedLayout.StackOne
Only the current widget is visible. This is the default.
QStackedLayout.StackAll
All widgets are visible. The current widget is merely raised.
-
PySide2.QtWidgets.QStackedLayout.
currentChanged
(index)¶ - Parameters
index –
int
-
PySide2.QtWidgets.QStackedLayout.
currentIndex
()¶ - Return type
int
See also
-
PySide2.QtWidgets.QStackedLayout.
currentWidget
()¶ - Return type
Returns the current widget, or 0 if there are no widgets in this layout.
See also
-
PySide2.QtWidgets.QStackedLayout.
insertWidget
(index, w)¶ - Parameters
index –
int
w –
QWidget
- Return type
int
Inserts the given
widget
at the givenindex
in thisQStackedLayout
. Ifindex
is out of range, the widget is appended (in which case it is the actual index of thewidget
that is returned).If the
QStackedLayout
is empty before this function is called, the givenwidget
becomes the current widget.Inserting a new widget at an index less than or equal to the current index will increment the current index, but keep the current widget.
See also
addWidget()
removeWidget()
setCurrentWidget()
-
PySide2.QtWidgets.QStackedLayout.
setCurrentIndex
(index)¶ - Parameters
index –
int
See also
-
PySide2.QtWidgets.QStackedLayout.
setCurrentWidget
(w)¶ - Parameters
w –
QWidget
Sets the current widget to be the specified
widget
. The new current widget must already be contained in this stacked layout.See also
-
PySide2.QtWidgets.QStackedLayout.
setStackingMode
(stackingMode)¶ - Parameters
stackingMode –
StackingMode
See also
-
PySide2.QtWidgets.QStackedLayout.
stackingMode
()¶ - Return type
See also
-
PySide2.QtWidgets.QStackedLayout.
widget
(arg__1)¶ - Parameters
arg__1 –
int
- Return type
Returns the widget at the given
index
, or 0 if there is no widget at the given position.See also
-
PySide2.QtWidgets.QStackedLayout.
widgetRemoved
(index)¶ - Parameters
index –
int
© 2018 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.