Qt屬性表控件的使用 QtTreePropertyBrowser

Qt屬性表控件的使用 QtTreePropertyBrowser

時間:2015-06-16 14:44:29      閱讀:3954      評論:0      收藏:0      [點我收藏+]

標籤:qt   property   屬性表   

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文件里加入
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文件

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;

Qt屬性表控件的使用 QtTreePropertyBrowser

標籤:qt   property   屬性表   

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章