(转)5.1自定义Qt控件(Customizing Qt Widgets)

在某些情况下，我们发现有些Qt控件通过设置它的属性或者调用函数不能满足我们的要求，还需要更多的要求。一个简单且直接的解决方法就是从这些Qt继承然后让它们满足我们的需要。

图5－1 the HexSpinBox widget

在本节中，我们开发一个十六进制的spin box来说明怎样来自定义Qt的控件。QSpinBox只支持十进制整数，但是从它派生新类能够接受和显示十六进制数值是非常简单的。

#ifndef HEXSPINBOX_H
#define  HEXSPINBOX_H
#include  < QSpinBox >
class  QRegExpValidator;
class  HexSpinBox :  public  QSpinBox
{
    Q_OBJECT
public :
    HexSpinBox(QWidget  * parent  =   0 );
protected :
    QValidator::State validate(QString  & text,  int   & pos)  const ;
     int  valueFromText( const  QString  & text)  const ;
    QString textFromValue( int  value)  const ;
private :
    QRegExpValidator  * validator;
};
#endif

 类HexSpinBox继承了很多QSpinBox的功能。它提供了一个典型的构造函数，重载了QSpinBox的三个虚函数。

#include  < QtGui >
#include  " hexspinbox.h "
HexSpinBox::HexSpinBox(QWidget  * parent)
    : QSpinBox(parent)
{
    setRange( 0 ,  255 );
    validator  =   new  QRegExpValidator(QRegExp( " [0-9A-Fa-f]{1,8} " ),  this );
}
QValidator::State HexSpinBox::validate(QString  & text,  int   & pos)  const
{
     return  validator -> validate(text, pos);
}
QString HexSpinBox::textFromValue( int  value)  const
{
     return  QString::number(value,  16 ).toUpper();
}
QString HexSpinBox::textFromValue( int  value)  const
{
     return  QString::number(value,  16 ).toUpper();
}
int  HexSpinBox::valueFromText( const  QString  & text)  const
{
     bool  ok;
     return  text.toInt( & ok,  16 );
}

 

我们设置默认的数值范围是0到255（0X00到0XFF），在QSpinBox中默认的范围是0到99，在十六进制中，前者合理多了。

用户可以点击上下箭头修改spin box的当前值，也可在编辑框里直接输入一个值。如果是直接输入一个值，我们要限制用户的输入是合理的十六进制数。为了做到这一点，我们使用一个QRegExpValidator，它只允许输入1到8个字符，范围是0到9，A到F，和小写字母a到f。

QSpinBox调用函数 validate()确定是否输入的文本是合法的。它会产生三个可能的结果：Invalid（不合法），Intermediate（输入的文本是似是而非的），Acceptable（文本是合理的）。QRegExpValidator有一个合适的validate()函数，所以我们就返回调用他的结果。在理论上，如果超过了范围，我们需要返回Invalid或者Intermediate，但是QSpinBox能够帮助我们做这些。

函数textFromValue()把一个整数变换为一个字符串。当用户点击上下箭头时，QSpinBox调用这个函数更新spin box的编辑部分值。16作为基数，使用静态函数QString::number()把数值转换为小写的十六进制，QString::toUpper()将得到的结果转换为大写。

函数valueFromText()实现了逆转换，把字符串转换为整数。当用户在spin box的编辑框中输入一个数值时由QSpinBox调用该函数。使用16作为基数，把当前的文本转换为整数值，如果文本不能转换为十六进制数值，ok置为false，toInt()返回0值。这里我们不需要考虑这个可能性，因为validator只允许输入合法的十六进制字符。我们也可以不传递 ok变量的地址，使用一个空指针也可以。

自定义其他 Qt 控件也遵循一样的步骤，选择一个合理的 Qt 控件，把它作为基类，然后重新实现一些虚函数改变它的行为以满足我们的需要。