Qt屬性表控件的使用 QtTreePropertyBrowser
https://github.com/lexxmark/QtnProperty
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
地址二:https://github.com/lexxmark/QtnProperty
2.安裝部署
下載下來解壓後會是這樣的一個文件:
這個控件提供了兩種使用方法,一種是dll,一種是靜態編譯。
想用動態鏈接庫的,只需要自己新建一個config.pri文件,裏面寫上SOLUTIONS_LIBRARY = yes即可。建議大家使用動態庫,避免一些moc文件生成的一些詭異問題~~
部署QtTreePropertyBrowser非常簡單,只需要把解壓的文件夾放在你的工程目錄下,在pro文件里加入
想用動態鏈接庫的,只需要自己新建一個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?) 因此很少使用
如果是用QtVariantPropertyManager,那麼它的valueChanged 信號將會是你經常使用的信號,它會發生髮生更改的屬性指針以及更改後的值。
void valueChanged ( QtProperty * property, const QVariant & value )
但爲了知道是哪個屬性,需要附加一個map來進行記錄,
h文件
QMap<QtProperty*,QString>m_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<QtProperty *, QString> propertyToId;
QMap<QString, QtProperty *> idToProperty;