Spec-Zone.ru › Qt 5.15

Тип QML BasicTableView

Наследует:

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.15/qml-basictableview.html

Spec-Zone.ru

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