Qt属性表控件的使用 QtTreePropertyBrowser

Posted 莫水千流

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Qt属性表控件的使用 QtTreePropertyBrowser相关的知识，希望对你有一定的参考价值。

属性表是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的技术分享技术分享
  1. QtVariantPropertyManager*m_pVarManager;  

 


cpp:
[cpp] view plain copy 技术分享技术分享
  1. m_pVarManager =newQtVariantPropertyManager(ui->propertyTree);  
  2. QtVariantProperty *item =m_pVarManager->addProperty(QVariant::Int, QStringLiteral("整形数据："));  
  3. item->setValue(101);  
  4. ui->propertyTree->addProperty(item);  
  5. item =m_pVarManager->addProperty(QVariant::Bool, QStringLiteral("布尔型数据："));  
  6. item->setValue(true);  
  7. ui->propertyTree->addProperty(item);  
  8. item =m_pVarManager->addProperty(QVariant::Double, QStringLiteral("浮点数据："));  
  9. item->setValue(3.1415926);  
  10. ui->propertyTree->addProperty(item);  
  11. item =m_pVarManager->addProperty(QVariant::String, QStringLiteral("字符串数据："));  
  12. ui->propertyTree->addProperty(item);  
  13. item->setValue(QStringLiteral("尘中远"));  

效果如下：
技术分享


QtVariantPropertyManager的静态函数groupTypeId用于返回“组”的ID,如果需要添加分组，addProperty的id编号就需要用到groupTypeId函数获取。把上面代码稍作变形：
[cpp] view plain copy 技术分享技术分享
  1. m_pVarManager =newQtVariantPropertyManager(ui->propertyTree);     
  2. QtProperty *groupItem =m_pVarManager->addProperty(QtVariantPropertyManager::groupTypeId(),QStringLiteral("组1"));  
  3. QtVariantProperty *item =m_pVarManager->addProperty(QVariant::Int, QStringLiteral("整形数据："));  
  4. item->setValue(101);  
  5. groupItem->addSubProperty(item);  
  6. item =m_pVarManager->addProperty(QVariant::Bool, QStringLiteral("布尔型数据："));  
  7. item->setValue(true);  
  8. groupItem->addSubProperty(item);  
  9. item =m_pVarManager->addProperty(QVariant::Double, QStringLiteral("浮点数据："));  
  10. item->setValue(3.1415926);  
  11. groupItem->addSubProperty(item);  
  12. item =m_pVarManager->addProperty(QVariant::String, QStringLiteral("字符串数据："));  
  13. groupItem->addSubProperty(item);  
  14. item->setValue(QStringLiteral("尘中远"));  
  15. ui->propertyTree->addProperty(groupItem);  

技术分享

3.2 修改内容

目前，按照上面代码显示的属性都是不能更改的，如果需要更改，可以添加一个工厂（Factory），QtTreePropertyBrowser的setFactoryForManager函数，会把一个Manager和一个Factory关联起来，那么所有Manager产生的属性，都可以进行编辑
头文件：
H
[cpp] view plain copy 技术分享技术分享
  1. QtVariantPropertyManager*m_pVarManager;  
  2. QtVariantEditorFactory*m_pVarFactory;  

cpp
[cpp] view plain copy 技术分享技术分享
  1. m_pVarManager =newQtVariantPropertyManager(ui->propertyTree);  
  2. m_pVarFactory =newQtVariantEditorFactory(ui->propertyTree);  
  3. QtProperty *groupItem =m_pVarManager->addProperty(QtVariantPropertyManager::groupTypeId(),QStringLiteral("组1"));  
  4. QtVariantProperty *item =m_pVarManager->addProperty(QVariant::Int, QStringLiteral("整形数据："));  
  5. item->setValue(101);  
  6. groupItem->addSubProperty(item);  
  7. item =m_pVarManager->addProperty(QVariant::Bool, QStringLiteral("布尔型数据："));  
  8. item->setValue(true);  
  9. groupItem->addSubProperty(item);  
  10. item =m_pVarManager->addProperty(QVariant::Double, QStringLiteral("浮点数据："));  
  11. item->setValue(3.1415926);  
  12. groupItem->addSubProperty(item);  
  13. item =m_pVarManager->addProperty(QVariant::String, QStringLiteral("字符串数据："));  
  14. groupItem->addSubProperty(item);  
  15. item->setValue(QStringLiteral("尘中远"));  
  16. ui->propertyTree->addProperty(groupItem);  
  17. 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文件

[cpp] view plain copy 技术分享技术分享
  1. QMap<QtProperty*,QString>m_property_dic;  
  2. QtVariantPropertyManager*m_pVarManager;  
  3. QtVariantEditorFactory*m_pVarFactory;  

cpp

[cpp] view plain copy 技术分享技术分享
  1. XXXClass::XXXClass(QWidget *parent)  
  2. :QMainWindow(parent),ui(newUi::XXXClass) {  
  3.     m_pVarManager =newQtVariantPropertyManager(ui->propertyTree);  
  4.     m_pVarFactory =newQtVariantEditorFactory(ui->propertyTree);  
  5.     connect(m_pVarManager,&QtVariantPropertyManager::valueChanged,this,&XXXClass::variantPropertyValueChanged);  
  6.     ui->propertyTree->setFactoryForManager(m_pVarManager,m_pVarFactory);  
  7.     QtVariantProperty *item =m_pVarManager->addProperty(QVariant::Int, QStringLiteral("参数1"));  
  8.     item->setValue(1);  
  9.     ui->propertyTree->addProperty(item);  
  10.     m_property_dic[item] =QStringLiteral("参数1");  
  11.     item =m_pVarManager->addProperty(QVariant::Double, QStringLiteral("参数2"));  
  12.     item->setValue(2);  
  13.     ui->propertyTree->addProperty(item);  
  14.     m_property_dic[item] =QStringLiteral("参数2");  
  15.     item =m_pVarManager->addProperty(QVariant::String, QStringLiteral("参数3"));  
  16.     item->setValue(QStringLiteral("czy"));  
  17.     ui->propertyTree->addProperty(item);  
  18.     m_property_dic[item] =QStringLiteral("参数3");  
  19.     item =m_pVarManager->addProperty(QVariant::Bool, QStringLiteral("参数4"));  
  20.     item->setValue(true);  
  21.     ui->propertyTree->addProperty(item);  
  22.     m_property_dic[item] =QStringLiteral("参数4");  
  23. }  
  24.    
  25. voidXXXClass::variantPropertyValueChanged(QtProperty *property, constQVariant &value)  
  26. {  
  27.     QString s =m_property_dic[property];  
  28.     qDebug()<<s<<":"<<value;  
  29. }  


技术分享
输出：


"" : 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<QtProperty *, QString> propertyToId;
  QMap<QString, QtProperty *> idToProperty;

以上是关于Qt属性表控件的使用 QtTreePropertyBrowser的主要内容，如果未能解决你的问题，请参考以下文章

Qt常用QSS集合

使用qt帮助 查看样式表stylesheet的帮助文档

QT如何设置QTableWidget控件占满下方？

Qt样式表都有哪些属性可以设置

Qt如何去掉按钮等控件的虚线框（焦点框）

Qt编写自定义控件属性设计器