Qt自定义窗口部件/控件(实现一个十六进制微调框SpinBox)

1、自定义Qt窗口部件/控件

在某些情况下,我们发现Qt窗口控件需要更多的自定义定制,这些定制可能要比它在Qt设计师里可设置的属性或者对它调用的那些函数更多一些。一个简单而直接的解决方法就是对相关的窗口部件类进行子类化并且使它能够满足我们的需要。

本文主要是通过实现一个十六进制微调框,来演示自定义窗口控件如何使用。

2、十六进制微调框(SpinBox)

QSpinBox一般只支持十进制整数,但是通过重写部分方法,可以让它支持十六进制数值。

2.1、实现思路

1、我们通过正则限制输入的数字和字符 [0-9a-fA-F]{1,8}
2、重写validate方法，用来检查目前为止输入文本的合法性。
3、重写textFromValue方法，用来把一个整数值转换成一个字符串。这里我们需要改为十六进制的规则。
4、重写valueFromText方法，用来把字符串到整数值的逆向转换。同样我们也需要改为十六进制的规则。

2.2、源码

HexSpinBox.h

#ifndef HEXSPINBOX_H
#define HEXSPINBOX_H

#include <QSpinBox>

class HexSpinBox : public QSpinBox
{
public:
    HexSpinBox(QWidget* parent = nullptr);

protected:
    // 重写三个重要的方法
    QValidator::State validate(QString& text, int& pos) const override;
    int valueFromText(const QString& text) const override;
    QString textFromValue(int value) const override;

private:
    QRegExpValidator* validator;

};

#endif // HEXSPINBOX_H

HexSpinBox.cpp

#include "HexSpinBox.h"

HexSpinBox::HexSpinBox(QWidget* parent)
    :QSpinBox{parent}
{
    setRange(0, 255);
    validator = new QRegExpValidator(QRegExp("[0-9a-fA-F]{1,8}"), this); // 0x00 0xFF

}

QValidator::State HexSpinBox::validate(QString &text, int& pos) const
{
    return validator->validate(text, pos);
}

int HexSpinBox::valueFromText(const QString& text) const
{
    return text.toInt(nullptr, 16);
}

QString HexSpinBox::textFromValue(int value) const
{
    return QString::number(value, 16).toUpper();
}