Qt 屬性表控件的使用 QtTreePropertyBrowser

1.簡介

屬性表是vs2003時引入的的新控件，用於流量和設置大量的信息，現在，很多軟件上都能看到它的身影，如vs，Qt Creator等IDE的詳細設置里都離不開屬性表。

下圖是Qt Creator里的屬性表

 

 

雖然，再Qt Creator里，屬性表到處可見，但是，卻沒有集成到常用控件里面，vs2008 fp里就給 MFC添加了CMFCPropertyGridCtrl，大Qt當然不能沒有它，Qt的項目里是有這個控件的，很可能是此控件的設計和其他的風格有點差別，所以還沒被Qt正式收錄。

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);  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函數獲取。把上面代碼稍作變形：

    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

    QtVariantPropertyManager*m_pVarManager; 2     QtVariantEditorFactory*m_pVarFactory;

cpp

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

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

cpp

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  
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;