Qt属性表控件的使用
扫描二维码
随时随地手机看文章
1.简介
属性表是vs2003时引入的的新控件,用于流量和设置大量的信息,现在,很多软件上都能看到它的身影,如vs,Qt Creator等IDE的详细设置里都离不开属性表。
下图是Qt Creator里的属性表
虽然,再Qt Creator里,属性表到处可见,但是,却没有集成到常用控件里面,vs2008 fp里就给MFC添加了CMFCPropertyGridCtrl,大Qt当然不能没有它,Qt的项目里是有这个控件的,很可能是此控件的设计和其他的风格有点差别,所以还没被Qt正式收录。下载地址:https://qt.gitorious.org/qt-solutions/qt-solutions/source/4d0c295cfe31ee765b5019442dd1554839f7a766:qtpropertybrowser
下载地址更新:http://download.csdn.net/detail/czyt1988/9516757 无需积分
2.安装部署
下载下来解压后会是这样的一个文件:
这个控件提供了两种使用方法,一种是dll,一种是静态编译。
想用动态链接库的,只需要自己新建一个config.pri文件,里面写上SOLUTIONS_LIBRARY = yes即可。建议大家使用动态库,避免一些moc文件生成的一些诡异问题~~
部署QtTreePropertyBrowser非常简单,只需要把解压的文件夹放在你的工程目录下,在pro文件里加入
include($$PWD/[qtpropertybrowser文件夹]/src/qtpropertybrowser.pri)
[qtpropertybrowser文件夹]是你放置qtpropertybrowser文件的文件夹名,例如,工程下建立qtpropertybrowser文件夹,里面把解压的所有文件放入,那么在pro文件里,就写成include($$PWD/qtpropertybrowser/src/qtpropertybrowser.pri)加上上面那句,刷新一下,工程会加入如下内容:
和在designer里,放置一个widget,并右键点击,选择提升为提升的类名写QtTreePropertyBrowser,基类选择Widget,选择全局包含,这时,就可以把QWidget设置为QtTreePropertyBrowser。编译运行效果如图3.属性表的使用简介
3.1添加内容
QtTreePropertyBrowser是通过Manager来管理属性的,他提供了很多类型的管理,属性表里的属性条目,是通过Manager来创建并且管理的。因此需要创建属性时,首先要创建一个Manager,再通过Manager来创建属性。Manager的addProperty()函数就是用于生成属性,同时,Manager提供了几个信号,用于告知属性的改变,它们是:propertyInserted(), propertyRemoved(), propertyChanged() 和propertyDestroyed(),各种类型的Manager如下:
QtBoolPropertyManager
QtColorPropertyManager
QtDatePropertyManager
QtDateTimePropertyManager
QtDoublePropertyManager
QtEnumPropertyManager
QtFlagPropertyManager
QtFontPropertyManager
QtGroupPropertyManager
QtIntPropertyManager
QtPointPropertyManager
QtRectPropertyManager
QtSizePropertyManager
QtSizePolicyPropertyManager
QtStringPropertyManager
QtTimePropertyManager
QtVariantPropertyManager
每个属性条目对应着QtProperty或者QtVariantProperty,属性条目都是通过Manager的addProperty函数生成,函数是个工厂函数,返回一个Property的指针,通过这个Property指针,可以对属性值进行设置。通过QtTreePropertyBrowser的addProperty函数把Property添加进属性表进行显示,下面演示属性条目的添加: 头文件:
QtVariantPropertyManager*m_pVarManager;
cpp:
m_pVarManager =newQtVariantPropertyManager(ui->propertyTree); QtVariantProperty *item =m_pVarManager->addProperty(QVariant::Int, QStringLiteral("整形数据:")); item->setValue(101); ui->propertyTree->addProperty(item); item =m_pVarManager->addProperty(QVariant::Bool, QStringLiteral("布尔型数据:")); item->setValue(true); ui->propertyTree->addProperty(item); item =m_pVarManager->addProperty(QVariant::Double, QStringLiteral("浮点数据:")); item->setValue(3.1415926); ui->propertyTree->addProperty(item); item =m_pVarManager->addProperty(QVariant::String, QStringLiteral("字符串数据:")); ui->propertyTree->addProperty(item); item->setValue(QStringLiteral("尘中远"));
效果如下:
QtVariantPropertyManager的静态函数groupTypeId用于返回“组”的ID,如果需要添加分组,addProperty的id编号就需要用到groupTypeId函数获取。把上面代码稍作变形:
m_pVarManager =newQtVariantPropertyManager(ui->propertyTree); QtProperty *groupItem =m_pVarManager->addProperty(QtVariantPropertyManager::groupTypeId(),QStringLiteral("组1")); QtVariantProperty *item =m_pVarManager->addProperty(QVariant::Int, QStringLiteral("整形数据:")); item->setValue(101); groupItem->addSubProperty(item); item =m_pVarManager->addProperty(QVariant::Bool, QStringLiteral("布尔型数据:")); item->setValue(true); groupItem->addSubProperty(item); item =m_pVarManager->addProperty(QVariant::Double, QStringLiteral("浮点数据:")); item->setValue(3.1415926); groupItem->addSubProperty(item); item =m_pVarManager->addProperty(QVariant::String, QStringLiteral("字符串数据:")); groupItem->addSubProperty(item); item->setValue(QStringLiteral("尘中远")); ui->propertyTree->addProperty(groupItem);
3.2 修改内容
目前,按照上面代码显示的属性都是不能更改的,如果需要更改,可以添加一个工厂(Factory),QtTreePropertyBrowser的setFactoryForManager函数,会把一个Manager和一个Factory关联起来,那么所有Manager产生的属性,都可以进行编辑
头文件:
H
QtVariantPropertyManager*m_pVarManager; QtVariantEditorFactory*m_pVarFactory;
cpp
m_pVarManager =newQtVariantPropertyManager(ui->propertyTree); m_pVarFactory =newQtVariantEditorFactory(ui->propertyTree); QtProperty *groupItem =m_pVarManager->addProperty(QtVariantPropertyManager::groupTypeId(),QStringLiteral("组1")); QtVariantProperty *item =m_pVarManager->addProperty(QVariant::Int, QStringLiteral("整形数据:")); item->setValue(101); groupItem->addSubProperty(item); item =m_pVarManager->addProperty(QVariant::Bool, QStringLiteral("布尔型数据:")); item->setValue(true); groupItem->addSubProperty(item); item =m_pVarManager->addProperty(QVariant::Double, QStringLiteral("浮点数据:")); item->setValue(3.1415926); groupItem->addSubProperty(item); item =m_pVarManager->addProperty(QVariant::String, QStringLiteral("字符串数据:")); groupItem->addSubProperty(item); item->setValue(QStringLiteral("尘中远")); ui->propertyTree->addProperty(groupItem); ui->propertyTree->setFactoryForManager(m_pVarManager,m_pVarFactory);
如果有些内容想让编辑,有些内容不想让用户编辑,可以设置两个manager,一个设置Factory另外一个不设置,那么设置了Factory的manager生成的属性就可以编辑,没设置的就不可用编辑了
(感觉很蛋疼~~)
。
3.3 响应信号和槽
QtAbstractPropertyManager里有propertyChanged信号,响应属性的值的改变,但这个信号你不清楚属性是什么类型的(bool ,int ,string,double?) 因此很少使用
void QtAbstractPropertyManager::propertyChanged ( QtProperty * property );
如果是用QtVariantPropertyManager,那么它的valueChanged 信号将会是你经常使用的信号,它会发生发生更改的属性指针以及更改后的值。
void valueChanged ( QtProperty * property, const QVariant & value )
但为了知道是哪个属性,需要附加一个map来进行记录,
h文件
QMapm_property_dic; QtVariantPropertyManager*m_pVarManager; QtVariantEditorFactory*m_pVarFactory;
cpp
XXXClass::XXXClass(QWidget *parent) :QMainWindow(parent),ui(newUi::XXXClass) { m_pVarManager =newQtVariantPropertyManager(ui->propertyTree); m_pVarFactory =newQtVariantEditorFactory(ui->propertyTree); connect(m_pVarManager,&QtVariantPropertyManager::valueChanged,this,&XXXClass::variantPropertyValueChanged); ui->propertyTree->setFactoryForManager(m_pVarManager,m_pVarFactory); QtVariantProperty *item =m_pVarManager->addProperty(QVariant::Int, QStringLiteral("参数1")); item->setValue(1); ui->propertyTree->addProperty(item); m_property_dic[item] =QStringLiteral("参数1"); item =m_pVarManager->addProperty(QVariant::Double, QStringLiteral("参数2")); item->setValue(2); ui->propertyTree->addProperty(item); m_property_dic[item] =QStringLiteral("参数2"); item =m_pVarManager->addProperty(QVariant::String, QStringLiteral("参数3")); item->setValue(QStringLiteral("czy")); ui->propertyTree->addProperty(item); m_property_dic[item] =QStringLiteral("参数3"); item =m_pVarManager->addProperty(QVariant::Bool, QStringLiteral("参数4")); item->setValue(true); ui->propertyTree->addProperty(item); m_property_dic[item] =QStringLiteral("参数4"); } voidXXXClass::variantPropertyValueChanged(QtProperty *property, constQVariant &value) { QString s =m_property_dic[property]; qDebug()<<s<<":"<<value; }
输出:
"" : QVariant(int, 1)
"" : QVariant(double, 2)
"" : QVariant(QString, "czy")
"" : QVariant(bool, true)
"参数1" : QVariant(int, 123)
"参数2" : QVariant(double, 13)
"参数3" : QVariant(QString, "")
"参数3" : QVariant(QString, "中国")
"参数4" : QVariant(bool, false)
"参数4" : QVariant(bool, true)
参考提供的例子,有时候,为了方便双向控制,还会建立一个映射
QMap