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的 在CODE上查看代碼片派生到我的代碼片
  1. QtVariantPropertyManager*m_pVarManager;  

 


cpp:
  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函數獲取。把上面代碼稍作變形:
  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
  1. QtVariantPropertyManager*m_pVarManager;  
  2. QtVariantEditorFactory*m_pVarFactory;  

cpp
  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文件

  1. QMap<QtProperty*,QString>m_property_dic;  
  2. QtVariantPropertyManager*m_pVarManager;  
  3. QtVariantEditorFactory*m_pVarFactory;  

cpp

  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;


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM