5-1 自定义Qt控件(Customizing Qt Widgets)

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

图5-1 the HexSpinBox widget

在本节中,我们开发一个十六进制的旋转盒来说明怎样来自定义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,在十六进制中,前者合理多了。
用户可以点击上下箭头修改旋转盒的当前值,也可在编辑框里直接输入一个值。如果是字母,我们限制用户的只能输入合理的十六进制数字。为了做到这一点,我们使用一个QRegExpValidator,它只允许输入数字0到9,A到F,和小写字母a到f。
QSpinBox调用函数 validate()确定是否输入的文本是合法的。它会产生三个可能的结果:Invalid(不合法),Intermediate(输入的文本是一个合理值的合理部分),Acceptable(文本是合理的)。QRegExpValidator有一个合适的validate()函数,所以我们就返回调用他的结果。在理论上,如果超过了范围,我们需要返回Invalid或者Intermediate,但是QSpinBox能够帮助我们做这些。
函数textFromValue()把一个整数变换为一个字符串。当用户点击上下箭头时,QSpinBox调用这个函数更新旋转盒的编辑部分。16作为基数,QString::number()把数值转换为小写的十六进制,QString::toUpper()将得到的结果转换为大写。
函数valueFromText()实现了逆转换,把字符串转换为整数。当用户在旋转盒的编辑框中输入一个数值时由QSpinBox调用。使用16作为基数,把当前的文本转换为整数值,如果文本不能转换为十六进制数值,ok置为false,toInt()返回0值。这里我们不需要考虑这个可能性,因为validator只允许输入合法的十六进制字符。我们也可以不传递ok的地址,使用一个空指针也可以。
自定义其他 Qt 控件也遵循一样的步骤,选择一个合理的 Qt 控件,把它作为基类,然后重新实现一些虚函数改变它的行为以满足我们的需要。

你可能感兴趣的:(5-1 自定义Qt控件(Customizing Qt Widgets))