Тип QML BasicTableView
| Заявление об импорте: | import QtQuick.Controls.Private 1.0 |
| Наследует: | |
| Наследуется от: |
Свойства
- alternatingRowColors : bool
- backgroundVisible : bool
- columnCount : int
- contentFooter : Component
- contentHeader : Component
- headerDelegate : Component
- headerVisible : bool
- rowDelegate : Component
- selectionMode : int
- sortIndicatorColumn : int
- sortIndicatorOrder : int
- sortIndicatorVisible : bool
Методы
- TableViewColumn addColumn(object column)
- TableViewColumn getColumn(int index)
- TableViewColumn insertColumn(int index, object column)
- void moveColumn(int from, int to)
- void removeColumn(int index)
- void resizeColumnsToContents()
Подробное описание
Документация по свойствам
alternatingRowColors : bool
Это свойство установлено в true если вид альтернативно меняет цвет строки. Значение по умолчанию — true.
backgroundVisible : bool
Это свойство определяет, должен ли фон быть заполнен или нет.
Значение по умолчанию — true.
Примечание: rowDelegate не затрагивается этим свойством.
[только для чтения] columnCount : int
Текущее количество столбцов
contentFooter : Component
Это нижняя часть контента представления.
contentHeader : Component
Это верхняя часть контента представления.
headerDelegate : Component
Это свойство определяет делегата для отрисовки заголовка.
В делегате заголовка вы можете получить доступ к следующим специальным свойствам:
- styleData.value - значение или текст для этого элемента
- styleData.column - индекс столбца
- styleData.pressed - true, когда столбец нажимается
- styleData.containsMouse - true, когда столбец находится под курсором
- styleData.textAlignment - горизонтальное выравнивание текста столбца (с QtQuickControls 1.1)
headerVisible : bool
Это свойство определяет, виден ли заголовок. Значение по умолчанию — true.
rowDelegate : Component
Это свойство определяет делегата для отрисовки строки.
В делегате строки вы можете получить доступ к следующим специальным свойствам:
- styleData.alternate - true, когда строка использует альтернативный цвет фона
- styleData.selected - true, когда строка в данный момент выбрана
- styleData.row - индекс строки
- styleData.hasActiveFocus - true, когда строка имеет фокус (с QtQuick.Controls 1.3)
- styleData.pressed - true, когда строка нажата (с QtQuick.Controls 1.3)
Примечание: По причинам производительности созданные делегаты могут быть повторно использованы в нескольких строках таблицы. Это означает, что при использовании неявных свойств, таких как styleData.row или model, эти значения могут измениться после создания делегата. Это означает, что вы не должны предполагать, что контент является фиксированным, когда Component.onCompleted вызывается, а вместо этого полагайтесь на привязки к таким свойствам.
selectionMode : int
Этот перечисление указывает, как представление реагирует на пользовательские выделения:
Возможные режимы:
- SelectionMode.NoSelection - Элементы не могут быть выделены.
- SelectionMode.SingleSelection - Когда пользователь выбирает элемент, любой уже выбранный элемент становится невыбранным, и пользователь не может отменить выбор выбранного элемента. (По умолчанию)
- SelectionMode.MultiSelection - Когда пользователь выбирает элемент обычным способом, статус выбора этого элемента переключается, а другие элементы остаются без изменений.
- SelectionMode.ExtendedSelection - Когда пользователь выбирает элемент обычным способом, выбор очищается, и новый элемент выбирается. Однако, если пользователь нажимает клавишу Ctrl при щелчке по элементу, выбранный элемент переключается, а все остальные элементы остаются нетронутыми. Если пользователь нажимает клавишу Shift при щелчке по элементу, все элементы между текущим элементом и щелкнутым элементом выбираются или отменяют выбор в зависимости от состояния щелкнутого элемента. Несколько элементов можно выбрать, перетаскивая курсор по ним.
- SelectionMode.ContiguousSelection - Когда пользователь выбирает элемент обычным способом, выбор очищается, и новый элемент выбирается. Однако, если пользователь нажимает клавишу Shift при щелчке по элементу, все элементы между текущим элементом и щелкнутым элементом выбираются.
Это свойство было добавлено в QtQuick.Controls 1.1.
sortIndicatorColumn : int
Индекс текущего столбца сортировки. Значение по умолчанию — 0.
sortIndicatorOrder : int
Это устанавливает порядок сортировки индикатора сортировки. Допустимые значения:
- Qt.AscendingOrder - значение по умолчанию
- Qt.DescendingOrder
sortIndicatorVisible : bool
Это свойство отображает или скрывает индикатор сортировки. Значение по умолчанию — false.
Примечание: Само представление не сортирует данные.
Документация по методам
TableViewColumn addColumn(object column)
Добавляет column и возвращает добавленный столбец.
Аргумент column может быть экземпляром TableViewColumn или компонентом. Компонент должен содержать TableViewColumn. В противном случае возвращается null.
TableViewColumn getColumn(int index)
Возвращает столбец по заданному index или null если index недопустим.
TableViewColumn insertColumn(int index, object column)
Вставляет column в заданный index и возвращает вставленный столбец.
Аргумент column может быть экземпляром TableViewColumn или компонентом. Компонент должен содержать TableViewColumn. В противном случае возвращается null.
void moveColumn(int from, int to)
Перемещает столбец from в to.
void removeColumn(int index)
Удаляет и уничтожает столбец по заданному index.
void resizeColumnsToContents()
Изменяет размер всех столбцов, чтобы содержимое столбцов и заголовки помещались.
Этот метод был представлен в QtQuick.Controls 1.2.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qml-qtquick-controls-private-basictableview.html