Qt中自定义控件的三种实现方式

在 Qt 应用开发中，标准控件往往无法满足所有需求。自定义控件允许开发者创建具有特定功能和外观的控件，提高代码复用性和界面一致性。Qt 提供了多种方式来开发自定义控件，从简单的组合现有控件到完全自定义绘制。

1. 继承现有控件并重写（最常用）

适用场景：已有控件功能基本满足，但需要添加行为或限制。

实现方式：继承如 QLineEdit、QPushButton 等控件，重写部分方法。

class MyCustomButton : public QPushButton {Q_OBJECT
public:explicit MyCustomButton(QWidget *parent = nullptr) : QPushButton(parent) {}protected:void paintEvent(QPaintEvent *event) override {Q_UNUSED(event);QPainter painter(this);// 自定义绘制逻辑painter.fillRect(rect(), Qt::red);painter.drawText(rect(), Qt::AlignCenter, text());}void mousePressEvent(QMouseEvent *event) override {// 自定义鼠标点击处理emit customClicked();QPushButton::mousePressEvent(event); // 调用父类实现}signals:void customClicked();
};

2. 组合现有控件（复合控件）

将多个现有控件组合起来，形成一个新的功能更复杂的控件。通过一个容器控件管理多个子控件，并对外提供统一的接口。

适用场景：需要将多个简单控件组合成一个功能单元，如自定义的日期选择器、带标签的输入框等。

实现要点：

• 通常继承自QWidget作为容器
• 在构造函数中创建并布局子控件
• 提供统一的接口用于操作子控件
• 可以将子控件的信号汇总或转换为自定义信号

class SearchBox : public QWidget {Q_OBJECT
public:explicit SearchBox(QWidget *parent = nullptr) : QWidget(parent) {// 创建子控件m_lineEdit = new QLineEdit(this);m_button = new QPushButton("Search", this);// 设置布局QHBoxLayout *layout = new QHBoxLayout(this);layout->addWidget(m_lineEdit);layout->addWidget(m_button);// 连接信号槽connect(m_button, &QPushButton::clicked, this, &SearchBox::searchClicked);}QString getText() const {return m_lineEdit->text();}signals:void searchClicked();private:QLineEdit *m_lineEdit;QPushButton *m_button;
};

3. 完全自定义绘制（自绘控件）

直接继承QWidget或QFrame，完全通过重写paintEvent()函数实现所有绘制逻辑，不依赖任何现有控件。

适用场景：需要实现特殊外观或行为的控件，如仪表盘、自定义图表、音频波形显示等。

实现要点：

通常继承自QWidget

重写paintEvent()实现所有绘制逻辑

重写sizeHint()提供默认大小建议

重写事件处理函数实现交互功能

可能需要使用QPainter进行复杂绘制

class DialGauge : public QWidget {Q_OBJECTQ_PROPERTY(int value READ value WRITE setValue NOTIFY valueChanged)
public:explicit DialGauge(QWidget *parent = nullptr) : QWidget(parent), m_value(0) {}int value() const { return m_value; }void setValue(int value) {if (m_value != value) {m_value = value;emit valueChanged(m_value);update(); // 触发重绘}}QSize sizeHint() const override {return QSize(200, 200);}protected:void paintEvent(QPaintEvent *event) override {Q_UNUSED(event);QPainter painter(this);painter.setRenderHint(QPainter::Antialiasing);// 绘制背景painter.drawEllipse(rect().adjusted(10, 10, -10, -10));// 绘制指针painter.save();painter.translate(width()/2, height()/2);painter.rotate(m_value * 1.8); // 将0-100转换为0-180度painter.drawLine(0, 0, 0, -height()/2 + 20);painter.restore();}signals:void valueChanged(int value);private:int m_value;
};

选择建议

• 如需简单扩展现有控件功能，选择第一种方式
• 如需组合多个控件形成新控件，选择第二种方式
• 如需实现独特外观或复杂图形，选择第三种方式

参考文章：

1.Qt 自定义控件开发方法与实践

2.QT中自定义控件的三种实现方式