На этом шаге мы рассмотрим назначение, пример и основные методы этого класса.

    Каждый элемент модели QStandardItemModel представлен классом QStandardItem из модуля QtGui. Этот класс не только описывает элемент, но и позволяет создавать вложенные структуры, в которых любой элемент может иметь произвольное количество вложенных в него дочерних элементов или элементов-потомков (что пригодится при выводе иерархического списка). Форматы конструктора класса:

  <Объект> = QStandardItem()
  <Объект> = QStandardItem(<Текст>)
  <Объект> = QStandardItem(<QIcon>, <Текст>)
  <Объект> = QStandardItem(<Количество строк>[, <Количество столбцов>=1])

    Последний формат задает количество дочерних элементов и столбцов в них.

    Наиболее часто используемые методы класса QStandardItem приведены далее (за полным их списком обращайтесь к странице https://doc.qt.io/qt-5/qstandarditem.html):

• setRowCount (<Количество строк>) - задает количество дочерних строк;

• setColumnCount (<Количество столбцов>) - задает количество столбцов в дочерних строках;

• rowCount () - возвращает количество дочерних строк;

• columnCount () - возвращает количество столбцов в дочерних строках;

• row () - возвращает индекс строки в дочерней таблице родительского элемента или значение -1, если элемент не содержит родителя (находится на самом верхнем уровне иерархии);

• column () - возвращает индекс столбца в дочерней таблице родительского элемента или значение -1, если элемент не содержит родителя;

• setChild (<Строка>, <Столбец>, <QStandardItem>) - устанавливает заданный третьим параметром элемент в указанную ячейку дочерней таблицы текущего элемента. Пример создания иерархии и вывода ее на экран с применением иерархического списка:

  # -*- coding: utf-8 -*-
  from PyQt5 import QtWidgets, QtGui
  import sys
  app = QtWidgets.QApplication(sys.argv)
  window = QtWidgets.QWidget()
  window.setWindowTitle("QStandardItem")
  
  tv = QtWidgets.QTreeView()
  sti = QtGui.QStandardItemModel(parent = window)
  rootitem1 = QtGui.QStandardItem('QAbstractltemView')
  rootitem2 = QtGui.QStandardItem('Базовый класс')
  item1 = QtGui.QStandardItem('CQListView')
  item2 = QtGui.QStandardItem('Список')
  rootitem1.appendRow([item1, item2])
  item1 = QtGui.QStandardItem('QTableView')
  item2 = QtGui.QStandardItem('Таблица')
  rootitem1.appendRow([item1, item2])
  item1 = QtGui.QStandardItem('QTreeView')
  item2 = QtGui.QStandardItem('Иерархический список')
  rootitem1.appendRow([item1, item2])
  sti.appendRow([rootitem1, rootitem2])
  sti.setHorizontalHeaderLabels(['Класс', 'Описание'])
  tv.setModel(sti)
  tv.setColumnWidth(0, 170)
  
  vbox = QtWidgets.QVBoxLayout()
  vbox.addWidget(tv)
  window.setLayout(vbox)
  window.resize(400,200)
  window.show()
  sys.exit(app.exec_())
  

  Архив с файлом можно взять здесь.

  
  Рис.1. Результат работы приложения

• appendRow (<Список>) - добавляет одну строку в конец дочерней таблицы текущего элемента. В качестве параметра указывается список экземпляров класса QStandardItem, формирующих отдельные столбцы;

• appendRow (<QStandardItem>) - добавляет заданный элемент в конец дочерней таблицы текущего элемента, формируя строку с одним столбцом;

• appendRows (<Список>) - добавляет несколько строк, содержащих по одному столбцу, в конец дочерней таблицы текущего элемента. В качестве параметра указывается список экземпляров класса QStandardItem;

• appendColumn (<Список>) - добавляет один столбец в конец дочерней таблицы текущего элемента. В качестве параметра указывается список экземпляров класса QStandardItem, формирующих отдельные строки;

• insertRow (<Индекс строки>, <Список>) - вставляет одну строку в указанную позицию дочерней таблицы у текущего элемента. В качестве параметра <Список> указывается список экземпляров класса QStandardItem, формирующих отдельные столбцы;

• insertRow (<Индекс строки>, <QStandardItem>) - вставляет заданный элемент в указанную позицию дочерней таблицы у текущего элемента, формируя строку с одним столбцом;

• insertRows (<Индекс строки>, <Список>) - вставляет несколько строк, содержащих поодному столбцу, в указанную позицию дочерней таблицы у текущего элемента. В качестве параметра <Список> указывается список экземпляров класса QStandardItem;

• insertRows (<Индекс строки>, <Количество>) - вставляет несколько пустых строк в указанную позицию дочерней таблицы для текущего элемента;

• insertColumn (<Индекс столбца>, <Список>) - вставляет один столбец в указанную позицию дочерней таблицы у текущего элемента. В качестве параметра <Список> указывается список экземпляров класса QStandardItem, формирующих отдельные строки;

• insertColumns (<Индекс>, <Количество>) - вставляет несколько пустых столбцов в указанную позицию дочерней таблицы у текущего элемента;

• removeRow (<Индекс>) - удаляет строку с указанным индексом;

• removeRows (<Индекс>, <Количество>) - удаляет указанное количество строк, начиная со строки, имеющей индекс <Индекс>;

• removeColumn (<Индекс>) - удаляет столбец с указанным индексом;

• removeColumns (<Индекс>, <Количество>) - удаляет указанное количество столбцов, начиная со столбца, имеющего индекс <Индекс>;

• takeChild (<Строка>[, <Столбец>=0]) - удаляет указанный дочерний элемент и возвращает его в виде экземпляра класса QStandardItem;

• takeRow (<Индекс>) - удаляет указанную строку из дочерней таблицы и возвращает ее в виде списка экземпляров класса QStandardItem;

• takeColuirm (<Индекс>) - удаляет указанный столбец из дочерней таблицы и возвращает его в виде списка экземпляров класса QStandardItem.

    На следующем шаге мы закончим изучение этого вопроса.

Предыдущий шаг Содержание Следующий шаг