QT model view. Juha Järvensivu 2008

Transkriptio

1 QT model view Juha Järvensivu 2008

2 Johdanto Model, View ja Delegaatit kommunikoivat singaaleista koostuvien rajapintojen avulla Malli informoi data muutoksista View informoi käyttäjän toimista (esim datan valinta) Delegaatti informoi edit statuksesta

3 Geneeriset tietotyypit QModelIndex Indeksi jonka avulla näkymä kysyy dataa mallilta (malli luo käytettävät indeksit) QVariant Malli ja näkymä käsittelevät dataa variant tyyppeinä

4 Model index Tietorakenne, jolla viitataan dataan Sisältää pointterin modeliin, joka indeksin on luonut Temporary references Näkymä ja delegaatit käsittelevät modelin dataa indeksien avulla (QModelIndex) QModelIndex indexa = model->index(0, 0, QModelIndex()); QModelIndex indexb = model->index(1, 1, QModelIndex()); QModelIndex indexc = model->index(2, 1, QModelIndex());

5 Persistent model index QPersistentModelIndex Käytetään QModelIndexin tilalta, jos tarvetta säilöä indeksiä pitkäksi aikaa

6 QVariant Model ja view käsittelevät dataa varianttyyppeinä QT:n data tyypit voidaan muuntaa varianttyyppisiksi Oletusrakentaja generoi Null-variantin QVariant v(123); int x = v.toint();

7 QVariant Variantti sisältää yleensä yhden arvon (esim int, string), mutta myös multivariantit ovat mahdollisia QVariantList = QList<QVariant> QVariantList vlist; QVariant v(vlist);

8 Metatyypin rekisteröinti Myös omia tietotyyppejä voidaan muuttaa variant muotoon, kunhan ne rekisteröidään metaobject-järjestelmään struct MyStruct { int i;... }; Q_DECLARE_METATYPE(MyStruct) MyStruct s; QVariant var; var.setvalue(s);

9 Datan lukeminen variantista Perustyypit voidaan muuttaa to-metodilla (esim v.toint()) Muut tyypit template metodilla int i = var.value<int>(); MyCustomStruct c; if (v.canconvert<mycustomstruct>()) { c = v.value<mycustomstruct>(v); }

10 QAbstractItemModel

11 QAbstractItemModel Standardi rajapinta, jonka kautta näkyvät käyttävät mallin dataa Esittää datan hierarkisena taulukkorakenteena Malli informoi näkymää muutoksista signal-slot mekanismin avulla QModelIndex index = model->index(row, column,...);

12 Read only model Toteutettava rajapinta: QModelIndex index(int r, int c, QModelIndex parent); QModelIndex parent(qmodelindex ind); Int rowcount(); Int columncount(); QVariant data(qmodelindex ind);

13 Editable model Toteutettava lisäksi: bool setdata(qmodelindex ind, QVariant data, int role) ItemFlags Flags(QModelIndex ind) Lisäksi tapahtuneista muutoksista tulee informoida näkymiä signaaleilla emit datachanged(qmodelindex topleft, QModelIndex bottomright)

14 Resizable model Toteutettava lisäksi: insertrows(int row, int count, QModelIndex parent) insertcolumns(int column, int count, QModelIndex parent) removerows(int row, int count, QModelIndex parent) removecolumns(int column, int count, QModelIndex parent)

15 insertrows - toteutus Ennen datan lisäämistä tulee kutsua: begininsertrows(qmodelindex parent, int first, int last) Lisäyksen jälkeen tulee kutsua: endinsertrows()

16 Mallin toteutus Käyttötarpeesta riippuen malli voidaan myös toteuttaa seuraavien luokkien avulla: QAbstractListModel (vain rowcount ja data) QAbstractTableModel (rowcount, columncount, data) Tai käyttää kirjaston valmista QStandardItemModel-luokkaa

17 QAbstractItemView

18 Yleistä Näkymä Toteuttaa yleisen layoutin, navigoinnin itemien välillä ja datan valinnan Delegaatti Toteuttaa yksittäisen itemin ulkoasun

19 QAbstractItemView Toteutettava rajapinta: QRect visualrect(qmodelindex ind); QRegion visualregionforselection(qitemselection s); Int horizontaloffset(); QModelIndex indexat(qpoint p); Bool isindexhidden(qmodelindex ind); scrollto() setselection() verticaloffset()

20 Delegaatti QAbstactItemView* pview; QAbstractItemDelegate pdelegate; pview->setitemdelegate(pdelegate, icolumn);

21 QAbstractItemDelegate Toteutettava rajapinta: void paint(qpainter p, QStyleOptionViewItem option, QModelIndex ind) QSize sizehint(qstyleoptionviewitem option, QModelIndex ind)

22 Role arvo Määrittelee mitä tietoa ollaan hakemassa Qt::ItemDataRole Qt::DisplayRole (näytettävä teksti) Qt::DecorationRole (ikoni) Qt::ToolTipRole (toltipteksti) Qt::StatusTipRole (status palkissa näytettävä teksti) Qt::WhatsThisRole (pikaohje) QVariant data(qmodelindex ind, int role);

23 Omien role-arvojen määrittäminen modeliin #define NAME_ROLE Qt::UserRole+1; #define DIRECTOR_ROLE Qt::UserRole+2; #define PRODUCER_ROLE Qt::UserRole+3; #define WRITER_ROLE Qt::UserRole+4; class CMovie { public: QString name() const; QString director() const; QString producer() const; QString writer() const ; QStringList actorlist() const; }; class CMovieModel { QList<CMovie> m_data; };

24 Omien role-arvojen määrittäminen modeliin QVariant CMovieModel::data(QModelIndex ind, int role) { QVariant result; if(ind.isvalid()) { switch(role) { case Qt::DisplayRole: case NAME_ROLE : result = QVariant( m_data[ind.row()].name() ); break; case WRITER_ROLE : result = QVariant( m_data[ind.row()].writer() ); break; case DIRECTOR_ROLE : result = QVariant( m_data[ind.row()].director() ); break; } } } return result;

25 QItemSelectionModel Pitää kirjaa valituista itemeistä Liittyy yhteen modeliin, mutta voidaan antaa usealle näkymälle

26 QItemSelectionModel QAbstactItemModel* pmodel; QItemSelectionModel* selectionmodel(pmodel); QAbstractItemView* pview1; pview1->setmodel(pmodel); pview1->setselectionmodel(pmodel); QAbstractItemView* pview2; pview2->setmodel(pmodel); pview2->setselectionmodel(pmodel);

27 Filter

28 Filtterit Käyttötarkoituksia: Näyttää vain osan mallin datasta käyttäjälle Järjestää datan alkuperäisestä poikkeavaan järjestykseen Toteuttaa saman rajapinnan kuin model (QAbstractItemModel)

29 QAbstractProxyModel Toteutettava rajapinta: QModelIndex mapfromsource(qmodelindex source) QModelIndex maptosource(qmodelindex source) Peritty QAbstractItemModel kantaluokasta

30 QSortFilterProxyModel QTreeView *treeview = new QTreeView; MyItemModel *sourcemodel = new MyItemModel(this); QSortFilterProxyModel *proxymodel = new QSortFilterProxyModel(this); proxymodel->setsourcemodel(sourcemodel); treeview->setmodel(proxymodel);

31 QSortFilterProxyModel void setfilter(qstring writer) { m_writer = writer;} bool MySortFilterProxyModel::filterAcceptsRow(int sourcerow, const QModelIndex &sourceparent) const { QModelIndex ind = sourcemodel()->index(sourcerow, 0, sourceparent); QString s = sourcemodel()->data(ind,writer_role).tostring(); } return (s == m_writer);

32 Lähteet Throlltech QT Model-View programming