Qt 框架中的一个容器小部件QStackedWidget的基本使用

QStackedWidget 是 Qt 框架中的一个容器小部件，它允许你将多个子小部件（通常是 QWidget 对象）堆叠起来，但是每次只能显示其中一个。它类似于一个标签页式的界面，用户可以通过点击不同的标签来切换显示不同的内容。

1.基本概念

以下是一些关于 QStackedWidget 的关键点：

属性

• currentIndex: 当前显示的子小部件的索引。
• count: QStackedWidget 中包含的子小部件的数量。

方法

• addWidget(QWidget *widget): 向 QStackedWidget 中添加一个新的子小部件。
• removeWidget(QWidget *widget): 从 QStackedWidget 中移除一个子小部件。
• setCurrentIndex(int index): 设置当前显示的子小部件的索引。
• setCurrentWidget(QWidget *widget): 设置当前显示的子小部件，通过小部件指针。

信号

• currentChanged(int index): 当当前显示的子小部件的索引改变时发出。

示例

以下是一个简单的例子，展示了如何使用 QStackedWidget：

#include <QApplication>
#include <QStackedWidget>
#include <QWidget>
#include <QPushButton>
#include <QVBoxLayout>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    // 创建 QStackedWidget 实例
    QStackedWidget stackedWidget;

    // 创建第一个页面
    QWidget *page1 = new QWidget;
    QVBoxLayout *layout1 = new QVBoxLayout(page1);
    layout1->addWidget(new QPushButton("按钮1"));
    layout1->addWidget(new QPushButton("按钮2"));
    stackedWidget.addWidget(page1);

    // 创建第二个页面
    QWidget *page2 = new QWidget;
    QVBoxLayout *layout2 = new QVBoxLayout(page2);
    layout2->addWidget(new QPushButton("按钮3"));
    layout2->addWidget(new QPushButton("按钮4"));
    stackedWidget.addWidget(page2);

    // 显示 QStackedWidget
    stackedWidget.show();

    return app.exec();
}

在这个例子中，我们创建了一个 QStackedWidget，并向其中添加了两个页面。每个页面包含两个按钮。由于 QStackedWidget 只显示当前索引对应的页面，所以用户可以通过 setCurrentIndex 方法来切换显示不同的页面。

动画效果

QStackedWidget 支持在页面切换时添加动画效果。你可以通过设置 QStackedWidget 的 animation 属性来实现：

stackedWidget.setAnimationOptions(QStackedWidget::SlideLeft);

这将使页面切换时向左滑动。

QStackedWidget 是 Qt 中的一个类，它是一个用于在多个布局容器之间切换的容器。它类似于一个堆栈，每次只能显示一个布局。用户可以通过调用 setCurrentIndex() 方法来改变当前显示的布局。下面是如何使用 QStackedWidget 的一些基本步骤：

2.进阶内容

定义和初始化 QStackedWidget

首先，你需要在你的 Qt 项目中包含 QStackedWidget：

#include <QStackedWidget>

然后在你的类中初始化 QStackedWidget：

QStackedWidget *stackedWidget = new QStackedWidget(this);

添加页面到 QStackedWidget

你可以通过调用 addWidget() 方法来向 QStackedWidget 添加页面。每个页面通常是一个 QWidget 的实例：

QWidget *page1 = new QWidget();
QWidget *page2 = new QWidget();

// 添加页面到 QStackedWidget
stackedWidget->addWidget(page1);
stackedWidget->addWidget(page2);

设置当前页面

你可以通过调用 setCurrentIndex() 方法来改变当前显示的页面。索引从 0 开始，表示第一个添加的页面：

stackedWidget->setCurrentIndex(0); // 显示 page1
stackedWidget->setCurrentIndex(1); // 显示 page2

信号和槽

QStackedWidget 提供了一些与页面切换相关的信号，你可以通过连接这些信号到槽来实现更复杂的行为：

• currentChanged(int index)：当页面改变时触发，参数为新的索引值。

  connect(stackedWidget, &QStackedWidget::currentChanged, [this](int index) {
  qDebug() << "切换到页面: " << index;
  });

在布局中使用 QStackedWidget

你可以在 QMainWindow 或其他布局容器中使用 QStackedWidget。例如，将 QStackedWidget 添加到 QMainWindow 的中央布局中：

QMainWindow *mainWindow = new QMainWindow();
QVBoxLayout *centralLayout = new QVBoxLayout;
centralLayout->addWidget(stackedWidget);
mainWindow->setCentralWidget(new QWidget(mainWindow));
mainWindow->setLayout(centralLayout);

使用 QStackedWidget 的额外功能

• 添加动画：可以使用 QPropertyAnimation 来为页面切换添加动画效果。
• 隐藏/显示页面：通过设置 QWidget 的 isVisible() 属性来控制页面的可见性。
• 页面的布局：每个添加到 QStackedWidget 的页面可以有自己的布局，例如 QVBoxLayout 或 QHBoxLayout。

示例完整代码

#include <QMainWindow>
#include <QVBoxLayout>
#include <QStackedWidget>
#include <QWidget>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QMainWindow *mainWindow = new QMainWindow();
    QVBoxLayout *centralLayout = new QVBoxLayout;
    centralLayout->setContentsMargins(0, 0, 0, 0); // 设置布局的内边距

    QWidget *page1 = new QWidget();
    QVBoxLayout *layout1 = new QVBoxLayout(page1);
    layout1->addWidget(new QLabel("这是页面1"));

    QWidget *page2 = new QWidget();
    QVBoxLayout *layout2 = new QVBoxLayout(page2);
    layout2->addWidget(new QLabel("这是页面2"));

    QStackedWidget *stackedWidget = new QStackedWidget();
    stackedWidget->addWidget(page1);
    stackedWidget->addWidget(page2);

    centralLayout->addWidget(stackedWidget);
    mainWindow->setCentralWidget(new QWidget(mainWindow));
    mainWindow->setLayout(centralLayout);

    mainWindow->show();

    return app.exec();
}

这个例子展示了如何创建一个简单的 QMainWindow，其中包含一个 QStackedWidget，并添加了两个页面。每个页面包含一个 QLabel，用于显示文本。