Evgenii Legotckoi
26 октября 2015 г. 23:25

QML - Урок 007. ListView Qml. Динамическое создание и удаление элементов

В статье про динамическое создание виджетов в Qt я уже рассказывал, как создавать и удалять кнопки динамически, а также как с ними взаимодействовать. И там использовался Vertical Layout , а случае с Qml мы сможем использовать ListView Qml, как аналогично используется при программирование в Java под Android. Что, к слову говоря, также применимо при программировании на Qt под Android.

В статье про динамическое создание виджетов использовались для примера объекты класса QButton. В данной статье будут использоваться объекты Button Qml, о кастомизации которых было рассказано в следующей статье . Но кнопки будут размещаться в ListView Qml.

Структура проекта для работы с ListView Qml

На это раз обойдёмся проектом, созданным по умолчанию и даже без дизайнера интерфейсов. Тем более, что на момент написания статьи не все параметры можно было задать в дизайнере. А структура проекта следующая:

  • QmlDynamic.pro - профайл проекта;
  • deployment.pri - файл правил деплоя на целевую платформу;
  • main.cpp - основной файл запуска приложения;
  • main.qml - qml файл с исходными кодами программы

main.qml

Поскольку все остальные файлы не представляют для нас никакого интереса и создаются по умолчанию, то сразу перейдём к разбору полётов с файлом main.qml.

Алгоритм работы программы следующий. В верхней части окна приложения имеется объект Row, в котором располагается текстовое поле и две кнопки. Остальную часть окна приложения занимает объект ListView Qml. По нажатию одной из кнопок в Row создаётся динамический объект в ListView Qml, который содержит кнопку. По нажатию динамической кнопки в текстовое поле в Row передаётся индекс ListElement, в котором находится кнопку, по которой производилось нажатие. И далее нажатием второй кнопки в объекте Row по индексу из текстового поля удаляется элемент из ListView Qml, а значение в текстовом поле стирается.

Примечателен тот факт, что при удалении элемента, который располагается в середине списка, например, индексы всех элементов, следующих за этим элементом уменьшаются на один. То есть индексы элементов пересчитываются автоматически.

  1. import QtQuick 2.5
  2. import QtQuick.Controls 1.4
  3.  
  4. ApplicationWindow {
  5. visible: true
  6. width: 640
  7. height: 480
  8. title: qsTr("Hello World")
  9.  
  10. /* Номер создаваемой кнопки, для её визуальной идентификации
  11. * при демонстрации проекта
  12. */
  13. property int number: 0
  14.  
  15. /* Строка с полем, где отображается индекс нажатой динамической кнопки,
  16. * кнопкой для создания динамических кнопок,
  17. * и кнопкой для удаления динамических кнопок по индексу
  18. * */
  19. Row {
  20. id: row
  21. // Задаём размеры строки и прибиваем к верхней части окна приложения
  22. height: 50
  23. anchors.top: parent.top
  24. anchors.left: parent.left
  25. anchors.right: parent.right
  26.  
  27. // Задаём размещение поля с индексом кнопки
  28. Rectangle {
  29. width: (parent.width / 5)
  30. height: 50
  31.  
  32. // Устанавливаем текстовое поле для размещения индекса кнопки
  33. Text {
  34. id: textIndex
  35. anchors.fill: parent
  36. text: ""
  37. verticalAlignment: Text.AlignVCenter
  38. horizontalAlignment: Text.AlignHCenter
  39. }
  40. }
  41.  
  42. // Кнопка для создания динамических кнопок
  43. Button {
  44. id: button1
  45. text: qsTr("Create Button")
  46. width: (parent.width / 5)*2
  47. height: 50
  48.  
  49. /* По клику по кнопке добавляем в model ListView
  50. * объект, с заданными параметрами
  51. * */
  52. onClicked: {
  53. listModel.append({idshnik: "Button " + (++number)})
  54.  
  55. }
  56. }
  57.  
  58. // Кнопка для удаления динамических кнопок
  59. Button {
  60. id: button2
  61. text: qsTr("Delete Button")
  62. width: (parent.width / 5)*2
  63. height: 50
  64.  
  65. // Удаляем кнопку по её индексу в ListView
  66. onClicked: {
  67. if(textIndex.text != ""){
  68. listModel.remove(textIndex.text)
  69. textIndex.text = "" // Обнуляем текстовое поле с индексом
  70. }
  71. }
  72. }
  73. }
  74.  
  75. // ListView для представления данных в виде списка
  76. ListView {
  77. id: listView1
  78. // Размещаем его в оставшейся части окна приложения
  79. anchors.top: row.bottom
  80. anchors.bottom: parent.bottom
  81. anchors.left: parent.left
  82. anchors.right: parent.right
  83.  
  84. /* в данном свойстве задаём вёрстку одного объекта
  85. * который будем отображать в списке в качестве одного элемента списка
  86. * */
  87. delegate: Item {
  88. id: item
  89. anchors.left: parent.left
  90. anchors.right: parent.right
  91. height: 40
  92.  
  93. // В данном элементе будет находиться одна кнопка
  94. Button {
  95. anchors.fill: parent
  96. anchors.margins: 5
  97.  
  98. /* самое интересное в данном объекте
  99. * задаём свойству text переменную, по имени которой будем задавать
  100. * свойства элемента
  101. * */
  102. text: idshnik
  103.  
  104. // По клику по кнопке отдаём в текстовое поле индекс элемента в ListView
  105. onClicked: {
  106. textIndex.text = index
  107. }
  108. }
  109. }
  110.  
  111. // Сама модель, в которой будут содержаться все элементы
  112. model: ListModel {
  113. id: listModel // задаём ей id для обращения
  114. }
  115. }
  116. }

Итог

В результате Вы получите приложение, в котором динамически создаются и удаляются элементы с кнопками, которое будет выглядеть так, как показано на рисунке. Также Вы можете ознакомиться с демонстрацией работы приложения в видеоуроке.

Видеоурок

Вам это нравится? Поделитесь в социальных сетях!

L
  • 14 июня 2017 г. 15:09

Здравствуйте,


Скажите, как реализовать следующее. Из объекта C++ посылается сигнал. Этот сигнал передает int ID - номер элемента.  В QML этот сигнал принимается и объект из ListModel с index == ID, например, меняет текст или свой  цвет.
Evgenii Legotckoi
  • 15 июня 2017 г. 13:27

Не хотелось бы повторяться. В статье по сигналам и слотам в QML есть вариант использования C++ объекта. Там используется тип Connections , который можно настроить на сигнал, который передаёт некое значение, тот же самый ID.

Connections {
    target: appCore 
    onSendToQml: {
        
    }
}
При этом сигнатура сигнала и обработчика не прописывается в этом соединении. Мы просто знаем, что в сигнале передаётся ID типа int, например с таким названием: sendedID.

Далее необходимо по этому ID изменить цвет. Тут есть такой момент, Изменения в свойствах делегата ListView необходимо делать через модель данных. То есть, модель данных должна содержать поле с указанием цвета. Можно сделать по умолчанию чёрный, а потом изменять его.
delegate: Text {
    anchors.left: parent.left
     anchors.right: parent.right
     height: 50
    horizontalAlignment: Text.AlignHCenter
    verticalAlignment: Text.AlignVCenter

    color: textColor // Роль с цветом
    text: textList // Роль с текстом
}
Тогда изменение цвета будет выглядеть так:
Connections {
    target: appCore 
    onSendToQml: {
          listModel.get(sendedID).textColor = "blue"
    }
}
L
  • 15 июня 2017 г. 14:21

Большое спасибо за ответ.

АК
  • 27 октября 2017 г. 17:08

А я не понимаю, как представление ссылается на модель? Нигде ведь не указано, что представление использует именно модель с id : listModel.

ps.
Ни JavaScript ни JSON не знаю, проблема в этом ? :)

Evgenii Legotckoi
  • 27 октября 2017 г. 17:11

Сама модель устанавливается в качестве property в представление.

model: ListModel {
    id: listModel // задаём ей id для обращения
}
Это для представления достаточно. По факту, даже этот id можно не указывать. Указание данного id было необходимо, чтобы другие объекты интерфейса, которые не относятся к модели, могли бы к ней обратиться.

Точно.
Я почему-то подумал, что парент у ListModel  главное окно, а не представление.
Три закрывающие скобки сбили с толка :)
Спасибо.

Evgenii Legotckoi
  • 27 октября 2017 г. 17:27

Можно и окно парентом сделать, то есть написать код модели под представлением. Но тогда в property model потребуется передать id этой модели.

АК
  • 10 января 2018 г. 17:00

Не могу понять, как мы добавляем новый элемент в listModel на строчке 53.
Как я понял из прочитанного: delegate дополняет listModel своими данными, чтобы было удобно ее отображать. В данном случае этими данными является idshnik. Сама listModel не хранит idshnik.
Возникает вопрос, как мы можем писать следующее  listModel.append({idshnik: "Button " + (++number)}).
Ведь что получается, что добавляя новый элемент в listModel мы передаем данные idshnik, а listModel их не хранит. Получается, они передаются сразу делегату? Или я запутался?

idshnik - это роль в модели данных.
Когда в QML в модель добавляются данные таким способом

listModel.append({idshnik: "Button " + (++number)})
То при попытке забрать данные из модели в QML вызывается во внутренностях ListView метод модели data() , который присутствует во всех моделях в Qt. Как я понимаю, в качестве роли передаётся QString ("idshnik") из делегата, и если в текущем объекте такая роль была найдена
{idshnik: "Button " + (++number)}
то возвращается некоторое значение, которое там было задано.

строчки 111-114

        model: ListModel {
            id: listModel // задаём ей id для обращения
        }
Создается модель без каких-либо еще ролей, это так?

А где тот момент, когда роль задается?
Строчка 53?
listModel.append({idshnik: "Button " + (++number)})
При первом добавлении элемента задается роль?

Или на строчке 102 внутри создания делегата?
text: idshnik
Но ведь это всего лишь текст кнопки.

Не могу понять как это именно работает :)

Роли здесь определяются автоматически. В самой модели в данном случае роль не определяется, как например сделано в этой статье , где имена ролей указываются в методе roleNames. Так что да, в строка 111-114 создаётся модель без предопределённых ролей.


На строке 53 создаётся объект со свойствами, у которых есть имена. Эти имена и являются ролями.

На строке 102 по сути написано имя роли, которую нужно попытаться найти в объекте модели.

Как я понимаю, когда делегат пытается получить данные из модели, он отправляет в модель имя роли, по которому модель отыскивает нужное свойство в объекте, который был добавлен в строке 53.

Учитывая, что все кастомные типы данных в QML наследуются от QObject, то и создаваемый объект должен также наследоваться от этого класса. А QObject может иметь динамически создаваемые property, доступ к которым осуществляется через имя, в данном случае таким имененем выступает роль (idshnik).

Отлично, теперь понял.

И изменить набор ролей уже будет нельзя, если мы их уже задали.

Что говорится в "Note that when creating content dynamically the set of available properties cannot be changed once set. Whatever properties are first added to the model are the only permitted properties in the model." на http://doc.qt.io/Qt-5/qml-qtqml-models-listmodel.html#append-method .

Благодарю, Евгений.

R
  • 27 ноября 2018 г. 14:21

Приветствую. Подскажите пожалуйста, как сделать так что бы на элементе ListView изначально был activeFocus. Ни как не получается это сделать. Даже если добавить

  1. Component.onCompleted:
  2. {
  3. listView.forceActiveFocus();
  4. }

То все равно

  1. onActiveFocusChanged: { console.log("activeFocusChanged", activeFocus) }

выдает сначала true, а потом сразу же false. Если же нажать Tab то актив фокус сразу же устанавливается на элементе ListView. Вроде доходчиво объяснил проблему. Помогите кто знает решение.

Evgenii Legotckoi
  • 27 ноября 2018 г. 14:32

Наверное, у вас что-то ещё не успело загрузиться в тот момент, и это что-то забирает фокус на себя. Попробуйте найти тот виджет, который забирает фокус и после его инициализации верните фокус на ListView.

R
  • 27 ноября 2018 г. 16:26

Дело в том, что на данный момент на странице нет ничего кроме этого ListView, а в нем лишь модель и делегат.

Evgenii Legotckoi
  • 28 ноября 2018 г. 14:06

Не помню порядок инициализации в QML и вызова метода onCompleted, возможно, что объекты в делегате будут созданы последними в итоге.

Можете попробовать сделать задержку таймером установить фокус по сработке таймера.

R
  • 29 ноября 2018 г. 9:48

Я нашел в чем проблема. Страница у меня эта не первая, и не единственная. И проблемы прилетали с основного файла где крутился StackView с моими страницами. И еще я реализовал разные страницы как Item, а не Page. То есть общий фон и на нем сменялись эти самые Item'ы. Перевел все на Page - и все проблемы исчезли.

Evgenii Legotckoi
  • 29 ноября 2018 г. 14:47

Ну видите )) Было же ещё что-то кроме того ListView ))

juvf
  • 3 ноября 2022 г. 14:20

Добрый день.
Очень полезная статья. Спасибо.

Вопрос такой: 1) нужно "взять" кнопку 2 пальцем (прикаснулись пальцем к кнопке 2, держим, через 2-3 кнопка оторвалась от ListView) и перетащить её между 7 и 8. Как такое в Qml реализовать? куда копать?
2) можно удалить кнопку "викинув" её? Т.е. горизонтально чиркнули по кнопке слева направо, кнопка визуально улетела и соседние кнопки сомкнулись. Наподобе как в андроиде удаляются уведомления.

Evgenii Legotckoi
  • 12 декабря 2022 г. 14:51

Давно уже не работал с QML. Qt поддерживает во вторых котролах Material Design, но не знаю, насколько он реализует данный функционал. Felgo - QML based фреймворк реализует подобные вещи.
Но что касается drag and drop фунционала, то тут нужно создавать плавающий rectangle, который будет летать за пальцем, правильно высчитывать все позиции всех элементов и т.д. В общем достаточное количество кода будет.

Комментарии

Только авторизованные пользователи могут публиковать комментарии.
Пожалуйста, авторизуйтесь или зарегистрируйтесь