Qt自定义控件

• 开发系统:ubuntu22.04
• IDE:clion
• 构建工具：cmake

Qt自定义控件之插件形式

插件形式是指将自定义控件按照一定的规则，生成动态库，放到Qt
designer插件加载目录/usr/lib/x86_64-linux-gnu/qt5/plugins/designer下，Qt designer启动时加载，自定义控件就像内置控件一样可以直接拖拽。下面是效果图：

自定义控件依赖QDesignerCustomWidgetInterface类，使用此类需要安装qttools5-dev。

sudo apt install qttools5-dev

一个简单示例

下面以一个自定义的Label来介绍，为了简单起见，这个Label相对于QLabel只是可以设置默认的字体颜色（原本的QLabel就可以）。
首先写一个如下cmake，用于动态库的编译

cmake_minimum_required(VERSION 3.28)
project(MyLabel)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)

find_package(Qt5 COMPONENTS
        Core
        Gui
        Widgets
        Designer
        REQUIRED)

include_directories(${PROJECT_SOURCE_DIR})

aux_source_directory(${PROJECT_SOURCE_DIR} SRCS)
file(GLOB QRCS "*.qrc")

add_library(MyLabel SHARED
        ${SRCS}
        ${QRCS})

target_link_libraries(MyLabel
        Qt5::Core
        Qt5::Gui
        Qt5::Widgets
        Qt5::Designer)

定义MyLabel类： mylabel.h

#ifndef MYLABEL_H
#define MYLABEL_H

#include <QLabel>

class MyLabel : public QLabel
{
    Q_OBJECT
    Q_PROPERTY(QColor color READ textColor WRITE setTextColor)

public:
    MyLabel(QWidget *parent = nullptr);
    ~MyLabel();
    void setTextColor(const QColor &c);
    QColor textColor() const;

private:
    QColor color;
};

#endif //MYLABEL_H

mylabel.cpp

#include "mylabel.h"

MyLabel::MyLabel(QWidget *parent)
    : QLabel(parent)
{
    color = QColor(Qt::black);
    setPalette(QPalette(color));
}

MyLabel::~MyLabel()
{
}

void MyLabel::setTextColor(const QColor &c)
{
    color = c;
    setPalette(QPalette(color));
}

QColor MyLabel::textColor() const
{
    return color;
}

定义MyLabel 插件类:mylabelplugin.h

#ifndef MYLABELPLUGIN_H
#define MYLABELPLUGIN_H

#include <QtUiPlugin/QDesignerCustomWidgetInterface>

class MyLabelPlugin : public QObject, public QDesignerCustomWidgetInterface
{
    Q_OBJECT
    Q_PLUGIN_METADATA(IID QDesignerCustomWidgetInterface_iid)
    Q_INTERFACES(QDesignerCustomWidgetInterface)

public:
    MyLabelPlugin(QObject *parent = nullptr);
    QString name() const;
    QString includeFile() const;
    QString group() const;
    QIcon icon() const;
    QString toolTip() const;
    QString whatsThis() const;
    bool isContainer() const;
    QWidget *createWidget(QWidget *parent);
};

#endif //MYLABELPLUGIN_H

mylabelplugin.cpp

#include "mylabelplugin.h"

#include "mylabel.h"

MyLabelPlugin::MyLabelPlugin(QObject *parent)
{
}

QString MyLabelPlugin::name() const
{
    return "MyLabel";
}

QString MyLabelPlugin::includeFile() const
{
    return "mylabel.h";
}

QString MyLabelPlugin::group() const
{
    return tr("Custom Widgets");
}

QIcon MyLabelPlugin::icon() const
{
    return QIcon(":/images/mylabel.png");
}

QString MyLabelPlugin::toolTip() const
{
    return tr("An custom label widget");
}

QString MyLabelPlugin::whatsThis() const
{
    return tr("balabala balabala.");
}

bool MyLabelPlugin::isContainer() const
{
    return false;
}

QWidget *MyLabelPlugin::createWidget(QWidget *parent)
{
    return new MyLabel(parent);
}