| Wiki Markup |
|---|
{alias:qstackedwidget}
h2. Name
*qstackedwidget* — container widget for vertically stacked widgets. Similar to qtabwidget
h2. Syntax
{panel:|borderStyle=solid|borderWidth=1|bgColor=#FFFFAA}
*qstackedwidget* \[ _parent_ ]
{panel}
h2. Description
The *qstackedwidget* command creates a QStackedWidget object. This container widget has the ability to stack child widgets on top of each other like pages in a book. It is similar to a [QTabWidget] but without the tabs. The widgets to be stacked are created separately and added using the [qaddwidget] command.
Only one widget at a time is visible in the QWidgetStack. To select which one, invoke the [qsetcurrentwidget] command with the widget id as argument.
{note}
The widgets that are to be stacked should not be added to a layout.
{note}
h2. Arguments
_parent_
{indent}The parent widget. This argument is rarely needed since adding the QStackedWidget to a layout will set the parent correctly.
{indent}
h2. Examples
h3. Ex.1: QStackedWidget
{anchor:QStackedWidget}
{noformat:|borderWidth=1|bgColor=#eeeeee} |
Name
qstackedwidget — container widget for vertically stacked widgets. Similar to qtabwidget
Syntax
| Panel |
|---|
| bgColor | #FFFFAA |
|---|
| borderWidth | 1 |
|---|
| borderStyle | solid |
|---|
|
qstackedwidget [ parent ] |
Description
The qstackedwidget command creates a QStackedWidget object. This container widget has the ability to stack child widgets on top of each other like pages in a book. It is similar to a QTabWidget but without the tabs. The widgets to be stacked are created separately and added using the qaddwidget command.
Only one widget at a time is visible in the QWidgetStack. To select which one, invoke the qsetcurrentwidget command with the widget id as argument.
| Note |
|---|
The widgets that are to be stacked should not be added to a layout. |
Arguments
parent
Examples
Ex.1: QStackedWidget
| Anchor |
|---|
| QStackedWidget |
|---|
| QStackedWidget |
|---|
|
| No Format |
|---|
| bgColor | #eeeeee |
|---|
| borderWidth | 1 |
|---|
|
# Window
set w [qwidget ]
qsetwindowtitle QStackedWidget
# Create layout to contain stack and buttons
set layout [qvboxlayout $w]
# Create stacked widget and add to layout
set stackedwidget [qstackedwidget]
qaddwidget $layout $stackedwidget
# Create two editors and add to stack
set editor1 [qtextedit]
qsettext "Editor 1"
qaddwidget $stackedwidget $editor1
set editor2 [qtextedit]
qsettext "Editor 2"
qaddwidget $stackedwidget $editor2
# Create two buttons that sets current page
set b1 [qpushbutton "First page" "qsetcurrentwidget $stackedwidget $editor1"]
qaddwidget $layout $b1
set b2 [qpushbutton "Second page" "qsetcurrentwidget $stackedwidget $editor2"]
qaddwidget $layout $b2
qshow $w
{noformat}
!att:_img_cmd^qstackedwidget.png!
Example +QStackedWidget+ shows a QStackedWidget with two pages. Each page contains a texteditor of type QTextEdit added with the [qaddwidget] command. To switch between the pages two buttons are created, one for each page. When pushed they call [qsetcurrentwidget], providing the desired visible widget as argument.
{pagebreak} |
Image Added
Example QStackedWidget shows a QStackedWidget with two pages. Each page contains a texteditor of type QTextEdit added with the qaddwidget command. To switch between the pages two buttons are created, one for each page. When pushed they call qsetcurrentwidget, providing the desired visible widget as argument.