How to Use a QSqlQueryModel in QML/it: Difference between revisions
No edit summary |
No edit summary |
||
Line 1: | Line 1: | ||
[[ | [[How_to_use_a_QSqlQueryModel_in_QML|English]] [[How_to_use_a_QSqlQueryModel_in_QML_Spanish|Spanish]] '''Italiano''' | ||
=Come usare QSqlQueryModel in | = Come usare QSqlQueryModel in QML = | ||
Il software che ho sviluppato, Photo Parata, è un applicazione client server che usa come backend sql. Per la maggior parte del tempo i dati da visualizzare di Photo Parata displays richiedono alcune joins. Per questo motivo,i modelli sono derivati da QSqlQueryModel, non QSqlTableModel. | Il software che ho sviluppato, Photo Parata, è un applicazione client server che usa come backend sql. Per la maggior parte del tempo i dati da visualizzare di Photo Parata displays richiedono alcune joins. Per questo motivo,i modelli sono derivati da QSqlQueryModel, non QSqlTableModel. | ||
In questa guida, vi guiderà attraverso le fasi della creazione di un modello personalizzato per | In questa guida, vi guiderà attraverso le fasi della creazione di un modello personalizzato per QML, derivato da QSqlQueryModel. | ||
Voglio ringraziare | Voglio ringraziare "Christophe Dumez":http://cdumez.blogspot.com/ per il suo blog "How to use C++ list model in QML":http://cdumez.blogspot.com/2010/11/how-to-use-c-list-model-in-qml.html. Grazie a questo blog che sono riuscito a mettere insieme le seguenti cose: | ||
(La sorgente dei dati per questo esempio è stato preso da uno degli esempi di Sql che viene fornito con Qt, | (La sorgente dei dati per questo esempio è stato preso da uno degli esempi di Sql che viene fornito con Qt, "examples\sql\masterdetail":http://doc.qt.nokia.com/stable/sql-masterdetail-database-h.html) | ||
===Fase 1: Creare una classe C++ derivata da QSqlQueryModel:=== | === Fase 1: Creare una classe C++ derivata da QSqlQueryModel: === | ||
Tutta la magia avviene nel costruttore e nei dati del metodo overload(). | Tutta la magia avviene nel costruttore e nei dati del metodo overload(). | ||
<code><br />class ArtistsSqlModel : public QSqlQueryModel<br />{<br /> Q_OBJECT<br />public:<br /> explicit ArtistsSqlModel(QObject '''parent);<br /> void refresh();<br /> QVariant data(const QModelIndex &index, int role) const;<br />signals:<br />public slots:<br />private:<br /> const static char''' COLUMN_NAMES[];<br /> const static char* SQL_SELECT;<br />};<br /></code> | |||
=== Fase 2: Implementare due costanti statiche === | |||
Ho sempre due variabili costanti statiche in ciascuno dei miei modelli che derivano da QSqlQueryModel, COLUMN_NAMES e SQL_SELECT. L'ordine dei nomi delle colonne in COLUMN_NAMES deve corrispondere l'ordine in cui sono elencati nella SELECT | |||
<code>const char* ArtistsSqlModel::COLUMN_NAMES[] = {<br /> "artist&quot;,<br /> "title&quot;,<br /> "year&quot;,<br /> NULL<br />};<br />const char* ArtistsSqlModel::SQL_SELECT =<br />"SELECT artists.artist, albums.title, albums.year&quot;<br />" FROM albums&quot;<br />" JOIN artists ON albums.artistid = artists.id&quot;;<br /></code> | |||
===Fase 4: Implementare il metodo data():=== | === Fase 3: Settare roleNames nel costruttore === | ||
Questa fase è dove tutta la magia accade realmente. Il QML farà riferimento alle varie colonne con le roleNames nomi ruolo impostata sul modello. | |||
<code>ArtistsSqlModel::ArtistsSqlModel(QObject *parent) :<br /> QSqlQueryModel(parent)<br />{<br /> int idx = 0;<br /> QHash&lt;int, QByteArray&gt; roleNames;<br /> while( COLUMN_NAMES[idx]) {<br /> roleNames[Qt::UserRole + idx + 1] = COLUMN_NAMES[idx];<br /> idx++;<br /> }<br /> setRoleNames(roleNames);<br /> refresh();<br />}</code> | |||
=== Fase 4: Implementare il metodo data(): === | |||
Finché il ruolo che viene richiesto non è un ruolo utente, restituisce il valore predefinito. Ma se il ruolo è un ruolo utente, riporta la colonna corretta: | Finché il ruolo che viene richiesto non è un ruolo utente, restituisce il valore predefinito. Ma se il ruolo è un ruolo utente, riporta la colonna corretta: | ||
=== | <code>QVariant ArtistsSqlModel::data(const QModelIndex &index, int role) const<br />{<br /> QVariant value = QSqlQueryModel::data(index, role);<br /> if(role < Qt::UserRole)<br /> {<br /> value = QSqlQueryModel::data(index, role);<br /> }<br /> else<br /> {<br /> int columnIdx = role - Qt::UserRole - 1;<br /> QModelIndex modelIndex = this->index(index.row(), columnIdx);<br /> value = QSqlQueryModel::data(modelIndex, Qt::DisplayRole);<br /> }<br /> return value;<br />} </code> | ||
=== Fase 5: Abilitare QML a riconoscere il modello: === | |||
Create un istanza del modello (prendete nota che il costruttore del modello deve interrogare il DB la prima volta). Poi settatelo come proprietà sul contenuto della vista, in questo caso l'ho chiamato artistModel: | |||
<code><br /> ArtistsSqlModel *artistsSqlModel = new ArtistsSqlModel( qApp);<br /> QmlApplicationViewer viewer;<br /> viewer.rootContext()->setContextProperty("artistsModel&quot;, artistsSqlModel);<br /> viewer.setOrientation(QmlApplicationViewer::ScreenOrientationAuto);<br /> viewer.setMainQmlFile&amp;#40;QLatin1String("qml/SQLListView/main.qml&quot;&#41;);<br /> viewer.showExpanded(); | |||
</code> | |||
=== Fase 6: Creare la lista QML e delegati === | |||
Poiché il modello è stato esposto alla fase 5, il modello esiste e può essere usato in QML. Semplicemente settate il modello della ListView con il nome usato nella fase 5. | |||
<code><br /> ListView {<br /> id: list_view1<br /> clip: true<br /> anchors.margins: 10<br /> anchors.fill: parent<br /> model: artistsModel<br /> delegate: ArtistItemDelegate {}<br /> }<br /></code> | |||
E infine l'implementazione del delegato. Si noti come i nomi indicati nella roleModel vengono utilizzati come i valori da associare alla proprietà Text degli oggetti di testo: | |||
'''ArtistItemDelegate.qml'''<br /><code>import Qt 4.7 | |||
Item {<br /> id: delegate<br /> width: delegate.ListView.view.width;<br /> height: 30<br /> clip: true<br /> anchors.margins: 4 | |||
Row {<br /> anchors.margins: 4<br /> anchors.fill: parent<br /> spacing: 4; | |||
Text {<br /> text: artist<br /> width: 150<br /> } | |||
Text {<br /> text: title<br /> width: 300;<br /> } | |||
Text {<br /> text: year<br /> width: 50;<br /> }<br /> }<br />}</code> | |||
Tutti i miei esempi in Qt si possono trovare a questo indirizzo. http://www.miltonstreet.com/qt/ | Tutti i miei esempi in Qt si possono trovare a questo indirizzo. "http://www.miltonstreet.com/qt/&quot;:http://www.miltonstreet.com/qt/ |
Revision as of 11:12, 24 February 2015
Come usare QSqlQueryModel in QML
Il software che ho sviluppato, Photo Parata, è un applicazione client server che usa come backend sql. Per la maggior parte del tempo i dati da visualizzare di Photo Parata displays richiedono alcune joins. Per questo motivo,i modelli sono derivati da QSqlQueryModel, non QSqlTableModel.
In questa guida, vi guiderà attraverso le fasi della creazione di un modello personalizzato per QML, derivato da QSqlQueryModel.
Voglio ringraziare "Christophe Dumez":http://cdumez.blogspot.com/ per il suo blog "How to use C++ list model in QML":http://cdumez.blogspot.com/2010/11/how-to-use-c-list-model-in-qml.html. Grazie a questo blog che sono riuscito a mettere insieme le seguenti cose:
(La sorgente dei dati per questo esempio è stato preso da uno degli esempi di Sql che viene fornito con Qt, "examples\sql\masterdetail":http://doc.qt.nokia.com/stable/sql-masterdetail-database-h.html)
Fase 1: Creare una classe C++ derivata da QSqlQueryModel:
Tutta la magia avviene nel costruttore e nei dati del metodo overload().
<br />class ArtistsSqlModel : public QSqlQueryModel<br />{<br /> Q_OBJECT<br />public:<br /> explicit ArtistsSqlModel(QObject '''parent);<br /> void refresh();<br /> QVariant data(const QModelIndex &index, int role) const;<br />signals:<br />public slots:<br />private:<br /> const static char''' COLUMN_NAMES[];<br /> const static char* SQL_SELECT;<br />};<br />
Fase 2: Implementare due costanti statiche
Ho sempre due variabili costanti statiche in ciascuno dei miei modelli che derivano da QSqlQueryModel, COLUMN_NAMES e SQL_SELECT. L'ordine dei nomi delle colonne in COLUMN_NAMES deve corrispondere l'ordine in cui sono elencati nella SELECT
const char* ArtistsSqlModel::COLUMN_NAMES[] = {<br /> "artist&quot;,<br /> "title&quot;,<br /> "year&quot;,<br /> NULL<br />};<br />const char* ArtistsSqlModel::SQL_SELECT =<br />"SELECT artists.artist, albums.title, albums.year&quot;<br />" FROM albums&quot;<br />" JOIN artists ON albums.artistid = artists.id&quot;;<br />
Fase 3: Settare roleNames nel costruttore
Questa fase è dove tutta la magia accade realmente. Il QML farà riferimento alle varie colonne con le roleNames nomi ruolo impostata sul modello.
ArtistsSqlModel::ArtistsSqlModel(QObject *parent) :<br /> QSqlQueryModel(parent)<br />{<br /> int idx = 0;<br /> QHash&lt;int, QByteArray&gt; roleNames;<br /> while( COLUMN_NAMES[idx]) {<br /> roleNames[Qt::UserRole + idx + 1] = COLUMN_NAMES[idx];<br /> idx++;<br /> }<br /> setRoleNames(roleNames);<br /> refresh();<br />}
Fase 4: Implementare il metodo data():
Finché il ruolo che viene richiesto non è un ruolo utente, restituisce il valore predefinito. Ma se il ruolo è un ruolo utente, riporta la colonna corretta:
QVariant ArtistsSqlModel::data(const QModelIndex &index, int role) const<br />{<br /> QVariant value = QSqlQueryModel::data(index, role);<br /> if(role < Qt::UserRole)<br /> {<br /> value = QSqlQueryModel::data(index, role);<br /> }<br /> else<br /> {<br /> int columnIdx = role - Qt::UserRole - 1;<br /> QModelIndex modelIndex = this->index(index.row(), columnIdx);<br /> value = QSqlQueryModel::data(modelIndex, Qt::DisplayRole);<br /> }<br /> return value;<br />}
Fase 5: Abilitare QML a riconoscere il modello:
Create un istanza del modello (prendete nota che il costruttore del modello deve interrogare il DB la prima volta). Poi settatelo come proprietà sul contenuto della vista, in questo caso l'ho chiamato artistModel:
<br /> ArtistsSqlModel *artistsSqlModel = new ArtistsSqlModel( qApp);<br /> QmlApplicationViewer viewer;<br /> viewer.rootContext()->setContextProperty("artistsModel&quot;, artistsSqlModel);<br /> viewer.setOrientation(QmlApplicationViewer::ScreenOrientationAuto);<br /> viewer.setMainQmlFile&amp;#40;QLatin1String("qml/SQLListView/main.qml&quot;&#41;);<br /> viewer.showExpanded();
Fase 6: Creare la lista QML e delegati
Poiché il modello è stato esposto alla fase 5, il modello esiste e può essere usato in QML. Semplicemente settate il modello della ListView con il nome usato nella fase 5.
<br /> ListView {<br /> id: list_view1<br /> clip: true<br /> anchors.margins: 10<br /> anchors.fill: parent<br /> model: artistsModel<br /> delegate: ArtistItemDelegate {}<br /> }<br />
E infine l'implementazione del delegato. Si noti come i nomi indicati nella roleModel vengono utilizzati come i valori da associare alla proprietà Text degli oggetti di testo:
ArtistItemDelegate.qml
import Qt 4.7
Item {<br /> id: delegate<br /> width: delegate.ListView.view.width;<br /> height: 30<br /> clip: true<br /> anchors.margins: 4
Row {<br /> anchors.margins: 4<br /> anchors.fill: parent<br /> spacing: 4;
Text {<br /> text: artist<br /> width: 150<br /> }
Text {<br /> text: title<br /> width: 300;<br /> }
Text {<br /> text: year<br /> width: 50;<br /> }<br /> }<br />}
Tutti i miei esempi in Qt si possono trovare a questo indirizzo. "http://www.miltonstreet.com/qt/":http://www.miltonstreet.com/qt/