Qt - kontrolka QListView

Stronę tą wyświetlono już: 2021 razy

Kontrolka QListView wizualnie przypomina wcześniej omawianą kontrolkę QListWidget, jednakże funkcjonuje ona na nieco innej zasadzie i umożliwia znacznie większą elastyczność sterowania jej funkcjonalnością i wyglądem. Niestety jest to obarczone nieco bardziej złożonym procesem obsługi tej kontrolki. W przykładzie, który mam zamiar pokazać wyeliminowałem konieczność tworzenia dodatkowych kontrolek do wprowadzania danych przez użytkownika do mojej listy. W kontrolce QListView po odpowiednim ustawieniu jej właściwości metodą setEditTriggers i zaznaczeniu myszką jednej z dostępnych pozycji można zmienić jej zawartość wpisując po prostu tekst. Klawisz enter zatwierdza zmianę. To samo można zrobić klikając dwukrotnie na danym elemencie listy i edytując zawarty w nim tekst.

Zanim przejdę do kodu warto zerknąć łaskawym okiem na wygląd samego graficznego interfejsu użytkownika, na który składa się tylko jedna kontrolka QListView, która zastąpi wszystkie dodatkowe przyciski i kontrolkę QLineEdit z poprzedniej strony.

Qt Creator - interfejs graficzny z kontrolką QListView
Rys. 1
Qt Creator - interfejs graficzny z kontrolką QListView

W kodzie obiekt klasy QListView nazwałem countriesList.

Kod programu w pliku mainwindow.h:

Listing 1
  1. #ifndef MAINWINDOW_H
  2. #define MAINWINDOW_H
  4. #include <QMainWindow>
  5. #include <QStringListModel>
  6. #include <QDebug>
  7. #include <QMessageBox>
  8. #include <QShortcut>
  10. namespace Ui {
  11. class MainWindow;
  12. }
  14. class MainWindow : public QMainWindow
  15. {
  16. Q_OBJECT
  18. QStringListModel *countriesListModel; // model, który zostanie podpięty pod kontrolkę QListView
  19. QString country; // pomocnicza zmienna konieczna do przechowywania informacji o tekście zawartym w danym elemencie kontrolki przed jego modyfikacją
  20. QShortcut *shDelete; // skrót klawiaturowy do podpięcia slotu onDeleteItem
  21. public:
  22. explicit MainWindow(QWidget *parent = 0);
  23. ~MainWindow();
  25. private slots:
  26. // slot podpięty pod sygnał wysyłany, gdy tekst w elementach kontrolki został zmieniony
  27. void countryDataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QVector<int> &roles = QVector<int> ());
  28. // slot podpięty pod sygnał wysyłany, gdy element w kontrolce został kliknięty dwa razy (co będzie oznaczało edycję tekstu kontrolki
  29. void on_countriesList_doubleClicked(const QModelIndex &index);
  30. // slot podpięty pod skrót klawiaturowy oznaczający usuwanie elementu zaznaczonego
  31. void onDeleteItem();
  32. // slot podpięty pod sygnał wysyłany, gdy wcześniej zaznaczony na liście element został nadpisany poprzez rozpoczęcie wpisywania tekstu
  33. void on_countriesList_pressed(const QModelIndex &index);
  35. private:
  36. Ui::MainWindow *ui;
  37. };
  39. #endif // MAINWINDOW_H

Kontrolka QListView do dodawania elementów listy wykorzystuje obiekt klasy QStringListModel, który po utworzeniu trzeba podpiąć pod obiekt klasy QListView wykorzystując jej metodę setModel. Wszystko to zostanie uczynione w konstruktorze klasy MainWindow w pliku mainwindow.cpp:

Listing 2
  1. #include "mainwindow.h"
  2. #include "ui_mainwindow.h"
  4. MainWindow::MainWindow(QWidget *parent) :
  5. QMainWindow(parent),
  6. ui(new Ui::MainWindow)
  7. {
  8. ui->setupUi(this);
  10. countriesListModel = new QStringListModel(this); // tworzenie nowego obiektu modelu
  12. countriesListModel->setStringList(
  13. {"Polska", "Czechy", "Słowacja"} // dodaję parę początkowych pozycji
  14. );
  16. ui->countriesList->setModel(countriesListModel); // podpinam model pod kontrolkę QListView
  18. ui->countriesList->setEditTriggers(
  19. QAbstractItemView::AnyKeyPressed | // edycja zaznaczonego elementu na dowolny znak tekstowy
  20. QAbstractItemView::DoubleClicked // edycja elementu po dwukrotnym kliknięciu lewym przyciskiem myszy
  21. );
  23. int row = countriesListModel->rowCount(); // pobieram liczbę wierszy
  25. countriesListModel->insertRow(row); // wstawiam dodatkowy wiersz na końcu
  26. QModelIndex index = countriesListModel->index(row, 0); // pobieram obiekt wstawionego indeksu
  27. countriesListModel->setData(index, QVariant("*")); // i ustawiam jego tekst
  29. // podpięcie sygnału dataChanged obiektu countriesListModel pod slot countryDataChanged okna głównego
  30. QObject::connect(countriesListModel, SIGNAL(dataChanged(QModelIndex,QModelIndex,QVector<int>)), this, SLOT(countryDataChanged(QModelIndex,QModelIndex,QVector<int>)));
  31. // tworzę skrót klawiaturowy podpięty pod kontrolkę QListView
  32. QShortcut* shDelete = new QShortcut(QKeySequence(Qt::Key_Delete), ui->countriesList);
  33. // podpinam sygnał obiektu shDelete pod slot onDeleteItem okna głównego
  34. connect(shDelete, SIGNAL(activated()), this, SLOT(onDeleteItem()));
  35. }
  37. MainWindow::~MainWindow()
  38. {
  39. delete ui;
  40. }
  42. void MainWindow::countryDataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QVector<int> &roles){
  43. if(topLeft != bottomRight) // jak więcej niż dwa elementy są edytowane to nie wykonuj dalszych działań
  44. return;
  46. int rowCount = countriesListModel->rowCount(); // pobieram liczbę wierszy
  47. // jeżeli tekst jest pusty
  48. if(topLeft.data().toString() == ""){
  49. countriesListModel->setData(topLeft, country); // to przywracam pierwotne ustawienie
  50. return;
  51. }
  52. // wyszukuję elementy pasujące do wprowadzonego tekstu
  53. QModelIndexList finded = countriesListModel->match(countriesListModel->index(0, 0), Qt::DisplayRole, topLeft.data(), -1, Qt::MatchExactly);
  54. // jak znaleziono więcej niż jeden to znaczy, że taki element już istniał
  55. if(finded.size() > 1){
  56. QMessageBox::warning(this, "Uwaga!", "Kraj o nazwie: " + topLeft.data().toString() + " już jest na liście");
  57. countriesListModel->setData(topLeft, country);
  58. }else if(topLeft.row() == rowCount - 1){ // jeżeli edytowany był ostatni element
  59. if(topLeft.data().toString() != "*"){ // i tekst nie jest "*" to
  60. countriesListModel->insertRow(rowCount); // dodaję nową pozycję
  61. QModelIndex index = countriesListModel->index(rowCount, 0); // pobieram jej obiekt
  62. countriesListModel->setData(index, QVariant("*")); // i ustawiam tekst na "*"
  63. }
  64. }
  65. }
  67. void MainWindow::on_countriesList_doubleClicked(const QModelIndex &index)
  68. {
  69. country = index.data().toString(); // zapamiętywanie początkowej wartości edytowanego indeksu
  70. }
  72. void MainWindow::onDeleteItem(){
  73. int row = ui->countriesList->currentIndex().row(); // pobieram indeks
  74. if(row != countriesListModel->rowCount() - 1){ // jak nie jest równy ostatniemu elementowi to
  75. countriesListModel->removeRow(row); // usuwam wiersz
  76. }
  77. }
  79. void MainWindow::on_countriesList_pressed(const QModelIndex &index)
  80. {
  81. country = index.data().toString(); // zapamiętywanie początkowej wartości edytowanego indeksu
  82. }
Strony powiązane
strony powiązane
  1. doc.qt.io/qt-5/qlistview.html#dataChanged - opis klasy QListView na stronie dokumentacji Qt
Tematy powiązane

Komentarze