【Qt控件之QListWidget】介绍及使用,利用QListWidget、QToolButton、和布局控件实现抽屉式组合控件

概述

QListWidget类提供了基于项目的列表小部件。

QListWidget是一个方便的类,类似于QListView提供的列表视图,但使用经典的基于项目的接口来添加和删除项目。QListWidget使用内部模型来管理列表中的每个QListWidgetItem

对于更灵活的列表视图小部件,请使用具有标准模型的QListView类。

列表小部件的构造方式与其他小部件相同:

cpp 复制代码
      QListWidget *listWidget = new QListWidget(this);

列表小部件的selectionMode()确定列表中可以同时选择多少个项目,以及是否可以创建复杂的项目选择。可以使用setSelectionMode()函数进行设置。

有两种方法可以将项目添加到列表中:可以将它们构造为具有列表小部件作为父小部件,也可以构造为没有父小部件,稍后将其添加到列表中。如果在构造项目时已经存在列表小部件,则使用第一种方法更容易:

cpp 复制代码
      new QListWidgetItem(tr("Oak"), listWidget);
      new QListWidgetItem(tr("Fir"), listWidget);
      new QListWidgetItem(tr("Pine"), listWidget);

如果需要在特定位置将新项目插入列表中,则应该构造该项目时不带父小部件。然后应使用insertItem()函数将其放置在列表中。列表小部件将拥有该项目。

cpp 复制代码
      QListWidgetItem *newItem = new QListWidgetItem;
      newItem->setText(itemText);
      listWidget->insertItem(row, newItem);

对于多个项目,可以使用insertItems()。可以使用count()函数获取列表中的项目数。要从列表中删除项目,请使用takeItem()

可以使用currentItem()找到列表中的当前项目,并使用setCurrentItem()来更改当前项目。用户还可以通过键盘导航或单击不同的项目来更改当前项目。当前项目更改时,会发出currentItemChanged()信号,其中包含新的当前项目和先前的项目。

常用函数

QListWidget的构造函数:

  • QListWidget(QWidget *parent = nullptr):构造一个QListWidget对象,父对象为parent

枚举类型:

  • QListWidget::SelectionMode:用于指定列表项的选择模式,包括NoSelectionSingleSelectionMultiSelectionExtendedSelectionContiguousSelection

常用函数包括但不限于:

  • void addItem(const QIcon &icon, const QString &text):向列表中添加一个带有图标和文本的项。
  • void addItem(const QString &text):向列表中添加一个只有文本的项。
  • void addItems(const QStringList &labels):向列表中一个字符串列表。
  • void insertItem(int row, const QString &label):在指定位置插入一个只有文本的项。
  • int count() const:返回列表中的项数。
  • int currentRow() const:返回当前选中项的索引。
  • QListWidgetItem *item(int row) const:返回指定位置的列表项。
  • QStringList selectedItems() const:返回当前选中的项的文本列表。
  • void clear():清除列表中的所有项。
  • void setSelectionMode(QListWidget::SelectionMode mode):设置选择模式。
  • void setIconSize(const QSize &size):设置图标的大小。
  • void setCurrentRow(int row):设置当前选中项的索引。
  • void sortItems(Qt::SortOrder order = Qt::AscendingOrder):按字母顺序对列表项进行排序。

信号和槽:

  • void itemClicked(QListWidgetItem *item):当点击一个项时发出的信号。可以使用 connect 函数将这个信号连接到自定义的槽函数上。
  • void itemDoubleClicked(QListWidgetItem *item):当双击一个项时发出的信号。
  • void itemSelectionChanged():当选中项发生改变时发出的信号。

以上只是QListWidget常用的函数和信号/槽,还有其他可用的函数和信号/槽可以根据需要查阅帮助文档。

示例

.h

cpp 复制代码
#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QToolButton>
#include <QVBoxLayout>
#include <QListWidget>


class DrawerWidget : public QWidget {
    Q_OBJECT
public:
    DrawerWidget(QWidget *parent = nullptr) : QWidget(parent) {
        listWidget = new QListWidget(this);
        listWidget->addItems(QStringList() << "1" << "2" << "3");

        toolButton = new QToolButton(this);
        toolButton->setArrowType(Qt::RightArrow);

        QVBoxLayout *layout = new QVBoxLayout(this);
        layout->addWidget(toolButton);
        layout->addWidget(listWidget);

        connect(toolButton, &QToolButton::clicked, this, &DrawerWidget::toggleDrawer);

        drawerOpened = true;
    }

private slots:
    void toggleDrawer() {
        if (drawerOpened) {
            listWidget->hide();
            toolButton->setArrowType(Qt::DownArrow);
        } else {
            listWidget->show();
            toolButton->setArrowType(Qt::RightArrow);
        }

        drawerOpened = !drawerOpened;
    }

private:
    QListWidget *listWidget;
    QToolButton *toolButton;
    bool drawerOpened;
};


namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private:
    Ui::MainWindow *ui;
};

#endif // MAINWINDOW_H

.cpp

cpp 复制代码
#include "mainwindow.h"
#include "ui_mainwindow.h"

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    QWidget* pW = new QWidget(this);
    QVBoxLayout* pVB = new QVBoxLayout(pW);
    pVB->addWidget(new DrawerWidget(this));
    pVB->addWidget(new DrawerWidget(this));
    pVB->addWidget(new DrawerWidget(this));
    pVB->addStretch();

    setCentralWidget(pW);
}

MainWindow::~MainWindow()
{
    delete ui;
}

main.cpp

cpp 复制代码
#include "mainwindow.h"
#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;
    w.show();

    return a.exec();
}

效果

实现思路

  • 首先,创建自定义组合控件
    -- 利用QToolButton和QListWidget实现抽屉式控件
  • 将自定义组合控件添加到主窗口
  • 显示
相关推荐
-凌凌漆-20 分钟前
【Qt】QStringLiteral 介绍
开发语言·qt
程序员爱钓鱼20 分钟前
Go语言项目工程化 — 常见开发工具与 CI/CD 支持
开发语言·后端·golang·gin
想要入门的程序猿22 分钟前
Qt写入excel
数据库·qt·excel
军训猫猫头1 小时前
1.如何对多个控件进行高效的绑定 C#例子 WPF例子
开发语言·算法·c#·.net
真的想上岸啊1 小时前
学习C++、QT---18(C++ 记事本项目的stylesheet)
开发语言·c++·学习
明天好,会的1 小时前
跨平台ZeroMQ:在Rust中使用zmq库的完整指南
开发语言·后端·rust
丁劲犇2 小时前
用 Turbo Vision 2 为 Qt 6 控制台应用创建 TUI 字符 MainFrame
开发语言·c++·qt·tui·字符界面·curse
旷世奇才李先生2 小时前
Next.js 安装使用教程
开发语言·javascript·ecmascript
charlie1145141913 小时前
深入理解Qt的SetWindowsFlags函数
开发语言·c++·qt·原理分析
likeGhee3 小时前
python缓存装饰器实现方案
开发语言·python·缓存