На этом шаге мы закончим перечисление основных методов этого класса.
Закончим перечисление основных методов класса QStandardItemModel из модуля QtGui.
- clear () - удаляет все элементы из модели;
- item (<Cтрока>[, <Столбец>=0]) - возвращает ссылку на элемент (экземпляр класса QStandardItem), расположенный в указанной ячейке;
- invisibleRootItem () - возвращает ссылку на невидимый корневой элемент модели в виде экземпляра класса QStandardItem;
- itemFromIndex (<QModelIndex>) - возвращает ссылку на элемент (экземпляр класса QStandardItem), на который ссылается заданный индекс;
- index (<Cтрока>, <Столбец>[, parent=QModelIndex()]) - возвращает индекс элемента (экземпляр класса QModelIndex), расположенного в указанной
ячейке. Необязательный параметр parent задает элемент верхнего уровня для искомого элемента, - если таковой не задан, будет выполнен поиск элемента на самом верхнем уровне иерархии;
- indexFromItem (<QStandardItem>) - возвращает индекс элемента (экземпляр класса QModelIndex), ссылка на который передана в качестве параметра;
- setData (<QModelIndex>, <Значение>[, role=EditRole]) - задает значение для роли role элемента, на который указывает индекс <QModelIndex>.
Метод возвращает значение True, если операция успешно выполнена;
- data (<QModelIndex>[, role=DisplayRole]) - возвращает данные, относящиеся к указанной роли элемента, на который ссылается индекс <QModelIndex>;
- setHorizontalHeaderLabels (<Список строк>) - задает заголовки столбцов. В качестве параметра указывается список строк;
- setVerticalHeaderLabels (<Список строк>) - задает заголовки строк. В качестве параметра указывается список строк;
- setHorizontalHeaderItem (<Индекс>, <QStandardItem>) - задает заголовок столбца. В первом параметре указывается индекс столбца, а во втором параметре - экземпляр
класса QStandardItem;
- setVerticalHeaderItem (<Индекс>, <QStandardItem>) - задает заголовок строки. В первом параметре указывается индекс строки, а во втором параметре - экземпляр класса QStandardItem;
- horizontalHeaderItem (<Индекс>) - возвращает ссылку на указанный заголовок столбца (экземпляр класса QStandardItem);
- verticalHeaderItem (<Индекс>) - возвращает ссылку на указанный заголовок строки (экземпляр класса QStandardItem);
- setHeaderData (<Индекс>, <Ориентация>, <Значение>[, role=EditRole]) - задает значение для указанной роли заголовка. В первом параметре
указывается индекс строки или столбца, а во втором параметре - ориентация (атрибут Horizontal или Vertical класса QtCore.Qt). Метод возвращает значение True, если операция успешно выполнена;
- headerData (<Индекс>, <Ориентация>[, role=DisplayRole]) - возвращает значение, соответствующее указанной роли заголовка. В первом параметре указывается
индекс строки или столбца, а во втором параметре - ориентация;
- findItems (<Teкст>[, flags=MatchExactly][, column=0]) - производит поиск элемента внутри модели в указанном в параметре column столбце по заданному тексту.
Допустимые значения параметра flags мы рассматривали на 134 шаге. В качестве значения метод возвращает список экземпляров класса QStandardItem или пустой список;
- sort (<Индекс столбца>[, order=AscendingOrder]) - производит сортировку. Если во втором параметре указан атрибут AscendingOrder класса QtCore.Qt,
сортировка производится в прямом порядке, а если DescendingOrder - в обратном;
- setSortRole (<Роль>) - задает роль (см. 137 шаг), по которой производится сортировка;
- parent (<QModelIndex>) - возвращает индекс (экземпляр класса QModelIndex) родительского элемента. В качестве параметра указывается индекс (экземпляр
класса QModelIndex) элемента-потомка;
- hasChildren ([parent=QModelIndex()]) - возвращает True, если заданный элемент имеет хотя бы одного потомка, и False - в противном случае.
При изменении значения элемента генерируется сигнал itemChanged(<QStandardItem>). Внутри обработчика через параметр доступна ссылка на элемент, представленный экземпляром класса QStandardItem.
На следующем шаге мы рассмотрим класс QStandardItem.
