Spec-Zone.ru › Qt 5.14

Тип QML BasicTableView

Заявление об импорте: import QtQuick.Controls.Private 1.0
Наследует:

ScrollView

Наследуется от:

TableView и TreeView

  • Список всех членов, включая унаследованные

Свойства

  • 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API