Описание класса QListViewКласс QListView является представлением в виде списка или пиктограммы в модели. Далее... #include <QListView> Унаследован от:QAbstractItemView. От него наследуются: QHelpIndexWidget, QListWidget и QUndoView. Открытые типы
Свойства
Открытые функции
Переопределённые открытые функции
Сигналы
Защищенные функции
Переопределённые защищённые функции
Дополнительные унаследованные члены
Подробное описаниеКласс QListView является представлением в виде списка или пиктограммы в модели. QListView представляет записи, хранящиеся в модели в виде простого, неиерархического списка или совокупности пиктограмм. Данный класс используется для представления в виде списка и пиктограмм там, где раньше использовались классы QListBox и QIconView, но использует более гибкий подход, предоставляемый архитектурой Qt модель/представление. Класс QListView является одним из Классов модель/представление и частью Структуры модель/представление Qt. Это представление не отображает горизонтальных и вертикальных заголовков; чтобы отображать список элементов с горизонтальным заголовком, используйте QTreeView. QListView реализует интерфейсы, определенные в классе QAbstractItemView, чтобы позволить ему отображать данные предоставляемые моделями, производными от класса QAbstractItemModel. Элементы списка могут быть показаны в двух режимах: В режиме ListMode элементы отображаются в форме простого списка; в режиме IconMode представление списка принимает форму icon view, в которой элементы отображаются с помощью пиктограмм, аналогично файлам в файловом менеджере. По умолчанию представление находится в режиме ListMode. Чтобы изменить режим представления, используйте функцию setViewMode(), а чтобы определить текущий режим представления, используйте viewMode(). Элементы в этих представлениях размещаются в направлении, определённом функцией представления flow(). В зависимости от состояния movement() представления элементы могут быть зафиксированы на месте или иметь возможность перемещаться. Если элементы в модели не могут быть полностью размещены по направлению к размещению, они могут быть перенесены у границы виджета представления; это зависит от isWrapping(). Это свойство полезно, когда элементы представлены в виде представления пиктограмм. Функции resizeMode() и layoutMode() управляют, как и когда элементы размещаются. Элементы расположены в соответствии с их spacing() и могут существовать в пределах воображаемой сетки с шагом, определенным gridSize(). Элементы могут быть отрисованы как большие или маленькие пиктограммы в зависимости от их iconSize(().
Повышение эффективностиВозможно показать подсказки о данных, это необходимо, в основном, для повышения эффективности при показе большого количества элементов. Один из подходов, который может быть принят во внимание, заключается в показе элементов с равными размерами и установленным в true свойством uniformItemSizes. Смотрите также Классы представлений, QTreeView, QTableView и QListWidget. Описание типов-членовenum QListView::Flow
enum QListView::LayoutMode
Смотрите также batchSize. enum QListView::Movement
enum QListView::ResizeMode
enum QListView::ViewMode
Описание свойствbatchSize : intДанное свойство содержит количество виджетов, содержащихся в компоновщике. Значение по умолчанию равно 100. Это свойство было введено в Qt 4.2. Функции доступа:
flow : FlowЭто свойство содержит значение, в каком направлении должно происходить расположение. Если это свойство равно LeftToRight, элементы будут размещены слева направо. Если свойство isWrapping равно true, размещение будет переносится, когда оно достигнет правой стороны видимой области. Если это свойство равно TopToBottom, элементы будут размещаться от верхней части видимой области, переносясь, когда оно достигнет нижней части. Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов. По умолчанию это свойство установлено в TopToBottom. Функции доступа:
Смотрите также viewMode. gridSize : QSizeЭто свойство содержит шаг сетки размещения. Это свойство есть шаг сетки, в которой размещаются элементы. По умолчанию размер пустой, что означает, что нет сетки и размещение делается не по сетке. Установка этого свойства в непустой размер приводит к размещению по сетке. (Когда действует размещение по сетке свойство spacing игнорируется.) Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов. Функции доступа:
Смотрите также viewMode. isWrapping : boolЭто свойство указывает, могут ли элементы переноситься при размещении. Это свойство указывает, должно ли размещение переносится, когда нет больше места в видимой области. Точка, в которой размещение переносится, зависит от свойства flow. Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов. По умолчанию это свойство равно false. Функции доступа:
Смотрите также viewMode. layoutMode : LayoutModeЭто свойство определяет, должно ли размещение элементов происходить немедленно или должно быть отложено. Это свойство содержит режим размещения для элементов. При режиме SinglePass (по умолчанию) элементы размещаются все сразу. При режиме Batched элементы размещаются блоками по batchSize элементов. Это делает возможным немедленно просматривать и взаимодействовать с видимыми элементами, пока размещаются остальные. Функции доступа:
Смотрите также viewMode. modelColumn : intЭто свойство содержит номер отображаемого столбца в модели. По умолчанию это свойство содержит 0, указывая на то, что первый столбец в модели должен быть показан. Функции доступа:
movement : MovementЭто свойство указывает, могут ли элементы быть свободно перемещены, привязаны ли они к сетке или не могут быть перемещены вообще. Это свойство определяет, как пользователь может перемещать элементы в представлении. Static означает, что элементы не могут быть перемещены пользователем. Free означает, что пользователь может перетаскивать элементы в любую позицию в представлении. Snap означает, что пользователь может перетаскивать элементы, но только в позиции воображаемой сетки, заданной свойством gridSize. Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов. По умолчанию это свойство установлено в Static. Функции доступа:
Смотрите также gridSize, resizeMode и viewMode. resizeMode : ResizeModeЭто свойство указывает, должны ли элементы размещаться снова, когда представление изменяет размер. Если это свойство равно Adjust, элементы будут размещаться снова, когда представление изменяет размер. Если установлено значение Fixed, элементы не будут размещаться, когда представление изменяет размер. По умолчанию это свойство установлено в Fixed. Функции доступа:
Смотрите также movement, gridSize и viewMode. selectionRectVisible : boolЭто свойство указывает, должен ли быть видимым прямоугольник выделения. Если данное свойство равно true, то прямоугольник является видимым; в противном случае он скрыт. Замечание: Прямоугольник выделения отображается только в режиме, когда возможно выбрать более одного элемента, т.е. он не будет отображаться в режиме выбора QAbstractItemView::SingleSelection. По умолчанию это свойство равно false. Это свойство было введено в Qt 4.3. Функции доступа:
spacing : intЭто свойство содержит расстояние вокруг элементов в размещении. Это свойство есть шаг сетки, в которой размещаются элементы. Установка этого свойства, когда представление видимо, приведет к повторному размещению элементов. По умолчанию это свойство содержит значение, равное 0. Функции доступа:
Смотрите также viewMode. uniformItemSizes : boolЭто свойство указывает, имеют ли все элементы в представлении одинаковый размер. Это свойство устанавливается в true только если оно гарантирует, что все элементы в представлении имеют одинаковый размер. Это позволяет представлению производить некоторую оптимизацию в целях улучшения производительности. По умолчанию это свойство равно false. Это свойство было введено в Qt 4.1. Функции доступа:
viewMode : ViewModeЭто свойство содержит режим отображения QListView. Это свойство изменит другие неустановленные свойства, чтобы соответствовать установленному режиму отображения. Характерные для QListView свойства, которые были уже установлены, не будут изменяться, пока не установлен флаг clearPropertyFlags(). Установка этого режима включает или выключает режим перетаскивания (drag and drop), основанные на движении при выделении. Для ListMode по умолчанию режим перемещения равен Static (drag and drop выключен); для IconMode по умолчанию этот режим равен Free (drag and drop включён). Функции доступа:
Смотрите также isWrapping, spacing, gridSize, flow, movement и resizeMode. wordWrap : boolЭто свойство отвечает за политику переноса текста в элементах. Если оно равно true, происходит перенос по непосредственному окончанию слов; в противном случае переноса нет вообще. Свойство равно false по умолчанию. Пожалуйста обратите внимание на то, что даже если разрешен перенос строк, ячейка не будет увеличена для предоставления места для текста. Оно будет печатать многточие для текста, который не может быть показан, согласно режима представления textElideMode. Это свойство было введено в Qt 4.2. Функции доступа:
Описание функций-членовQListView::QListView ( QWidget * parent = 0 )Создает новый QListView с заданным родителем parent, чтобы отобразить модель. Используйте setModel(), чтобы задать модель. QListView::~QListView ()Разрушает представление. void QListView::clearPropertyFlags ()Очищает характерные для QListView флаги свойств. Смотрите viewMode. Свойства, унаследованные от QAbstractItemView, не управляются флагами свойств. Точнее, dragEnabled и acceptsDrops вычисляются QListView при вызове setMovement() или setViewMode(). void QListView::currentChanged ( const QModelIndex & current, const QModelIndex & previous ) [virtual protected]Переопределено из QAbstractItemView::currentChanged(). void QListView::dataChanged ( const QModelIndex & topLeft, const QModelIndex & bottomRight ) [virtual protected]Переопределено из QAbstractItemView::dataChanged(). void QListView::dragLeaveEvent ( QDragLeaveEvent * e ) [virtual protected]Переопределено из QWidget::dragLeaveEvent(). void QListView::dragMoveEvent ( QDragMoveEvent * e ) [virtual protected]Переопределено из QWidget::dragMoveEvent(). void QListView::dropEvent ( QDropEvent * e ) [virtual protected]Переопределено от QWidget::dropEvent(). bool QListView::event ( QEvent * e ) [virtual protected]Переопределено от QObject::event(). int QListView::horizontalOffset () const [virtual protected]Переопределено из QAbstractItemView::horizontalOffset(). QModelIndex QListView::indexAt ( const QPoint & p ) const [virtual]Переопределено из QAbstractItemView::indexAt(). void QListView::indexesMoved ( const QModelIndexList & indexes ) [signal]Данный сигнал испускается, когда определённые indexes передвигаются в представлении. Эта функция была введена в Qt 4.2. bool QListView::isIndexHidden ( const QModelIndex & index ) const [virtual protected]Переопределено из QAbstractItemView::isIndexHidden(). bool QListView::isRowHidden ( int row ) constВозвращает true, если row скрыт; в противном случае возвращает false. void QListView::mouseMoveEvent ( QMouseEvent * e ) [virtual protected]Переопределено из QWidget::mouseMoveEvent(). void QListView::mouseReleaseEvent ( QMouseEvent * e ) [virtual protected]Переопределено из QWidget::mouseReleaseEvent(). QModelIndex QListView::moveCursor ( CursorAction cursorAction, Qt::KeyboardModifiers modifiers ) [virtual protected]Переопределено из QAbstractItemView::moveCursor(). void QListView::paintEvent ( QPaintEvent * e ) [virtual protected]Переопределено от QWidget::paintEvent(). QRect QListView::rectForIndex ( const QModelIndex & index ) const [protected]Возвращает прямоугольник элементов для позиции index в модели. Прямоугольник состоит из координат. Смотрите также visualRect(). void QListView::resizeEvent ( QResizeEvent * e ) [virtual protected]Переопределено от QWidget::resizeEvent(). void QListView::rowsAboutToBeRemoved ( const QModelIndex & parent, int start, int end ) [virtual protected]Переопределено из QAbstractItemView::rowsAboutToBeRemoved(). void QListView::rowsInserted ( const QModelIndex & parent, int start, int end ) [virtual protected]Переопределено из QAbstractItemView::rowsInserted(). void QListView::scrollTo ( const QModelIndex & index, ScrollHint hint = EnsureVisible ) [virtual]Переопределено из QAbstractItemView::scrollTo(). QModelIndexList QListView::selectedIndexes () const [virtual protected]Переопределено из QAbstractItemView::selectedIndexes(). void QListView::selectionChanged ( const QItemSelection & selected, const QItemSelection & deselected ) [virtual protected]Переопределено из QAbstractItemView::selectionChanged(). void QListView::setPositionForIndex ( const QPoint & position, const QModelIndex & index ) [protected]Устанавливает положение содержимого элемента модели с индексом index в позицию заданную с помощью position. If the list view's movement mode is Static or its view mode is ListView, this function will have no effect. Эта функция была введена в Qt 4.1. void QListView::setRowHidden ( int row, bool hide )Если hide равен true, переданный row будет скрыт; в противном случае row будет показан. Смотрите также isRowHidden(). void QListView::setSelection ( const QRect & rect, QItemSelectionModel::SelectionFlags command ) [virtual protected]Переопределено из QAbstractItemView::setSelection(). void QListView::startDrag ( Qt::DropActions supportedActions ) [virtual protected]Переопределено из QAbstractItemView::startDrag(). void QListView::timerEvent ( QTimerEvent * e ) [virtual protected]Переопределено из QObject::timerEvent(). void QListView::updateGeometries () [virtual protected]Переопределено из QAbstractItemView::updateGeometries(). int QListView::verticalOffset () const [virtual protected]Переопределено из QAbstractItemView::verticalOffset(). QStyleOptionViewItem QListView::viewOptions () const [virtual protected]Переопределено из QAbstractItemView::viewOptions(). QRect QListView::visualRect ( const QModelIndex & index ) const [virtual]Переопределено из QAbstractItemView::visualRect(). QRegion QListView::visualRegionForSelection ( const QItemSelection & selection ) const [virtual protected]Переопределено из QAbstractItemView::visualRegionForSelection(). Начиная с 4.7, возвращённая область содержит только прямоугольники, пересекающиеся (или полностью находящиеся) в области просмотра. |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |