Класс QListWidget

Класс QListWidget предоставляет виджет списка на основе элементов. Подробнее...

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

Свойства

• count : const int
• currentRow : int
• sortingEnabled : bool

Открытые функции

Переопределённые открытые функции

Открытые слоты

Сигналы

Защищённые функции

Реализованные защищённые функции

Подробное описание

QListWidget — это удобный класс, предоставляющий представление списка, аналогичное представлению QListView, но с классическим интерфейсом на основе элементов для добавления и удаления элементов. QListWidget использует внутреннюю модель для управления каждым элементом QListWidgetItem в списке.

Для более гибкого представления списка используйте класс QListView со стандартной моделью.

Виджеты списков создаются так же, как и другие виджеты:

    QListWidget *listWidget = new QListWidget(this);

Свойство selectionMode() виджета списка определяет, сколько элементов в списке можно выбрать одновременно, а также можно ли создавать сложные выделения элементов. Это можно установить с помощью функции setSelectionMode().

Существует два способа добавления элементов в список: они могут быть созданы с виджетом списка как родительским виджетом, или они могут быть созданы без родительского виджета и добавлены в список позже. Если виджет списка уже существует, когда элементы создаются, первый метод проще в использовании:

    new QListWidgetItem(tr("Oak"), listWidget);
    new QListWidgetItem(tr("Fir"), listWidget);
    new QListWidgetItem(tr("Pine"), listWidget);

Если вам нужно вставить новый элемент в список в определённой позиции, то он должен быть создан без родительского виджета. Затем функция insertItem() должна использоваться для размещения его в списке. Виджет списка получит владение элементом.

    QListWidgetItem *newItem = new QListWidgetItem;
    newItem->setText(itemText);
    listWidget->insertItem(row, newItem);

Для нескольких элементов можно использовать insertItems() вместо этого. Количество элементов в списке определяется с помощью функции count(). Для удаления элементов из списка используйте takeItem().

Текущий элемент в списке можно найти с помощью currentItem() и изменить с помощью setCurrentItem(). Пользователь также может изменить текущий элемент, перемещаясь с помощью клавиатуры или нажав на другой элемент. При изменении текущего элемента генерится сигнал currentItemChanged() с новым текущим элементом и элементом, который был текущим ранее.

См. также QListWidgetItem, QListView, QTreeView, Модель/Представление программирование и Пример диалога вкладки.

Документация по функциям-членам

QListWidget::QListWidget(QWidget *parent = nullptr)

Создаёт пустой QListWidget с заданным parent.

[slot] void QListWidget::очистить()

Удаляет все элементы и выделения в представлении.

[signal] void QListWidget::изменение текущего элемента(QListWidgetItem *current, QListWidgetItem *previous)

Этот сигнал генерируется всякий раз, когда текущий элемент изменяется.

previous — элемент, который ранее имел фокус; current — новый текущий элемент.

[signal] void QListWidget::изменение текущей строки(int currentRow)

Этот сигнал генерируется всякий раз, когда текущий элемент изменяется.

currentRow — номер строки текущего элемента. Если текущего элемента нет, currentRow равен -1.

Примечание: Сигнал оповещения для свойства текущая строка.

[signal] void QListWidget::изменение текста текущего элемента(const QString &currentText)

Этот сигнал генерируется всякий раз, когда текущий элемент изменяется.

currentText — текстовые данные в текущем элементе. Если текущего элемента нет, currentText недействителен.

[signal] void QListWidget::активировать элемент(QListWidgetItem *item)

Этот сигнал генерируется, когда item активируется. Элемент активируется, когда пользователь нажимает или дважды щелкает по нему, в зависимости от конфигурации системы. Он также активируется, когда пользователь нажимает клавишу активации (в Windows и X11 это клавиша Ввод, в Mac OS X это Command+O).

[signal] void QListWidget::изменение элемента(QListWidgetItem *item)

Этот сигнал генерируется всякий раз, когда данные элемента item изменяются.

[signal] void QListWidget::щелчок по элементу(QListWidgetItem *item)

Этот сигнал генерируется со указанным item, когда на элемент виджета нажата кнопка мыши.

См. также itemPressed() и itemDoubleClicked().

[signal] void QListWidget::дважды щелкнутый по элементу(QListWidgetItem *item)

Этот сигнал генерируется со указанным item, когда на элемент виджета дважды нажата кнопка мыши.

См. также itemClicked() и itemPressed().

[signal] void QListWidget::курсор вошёл в элемент(QListWidgetItem *item)

Этот сигнал генерируется, когда курсор мыши входит в элемент. Элемент item — входящий элемент. Этот сигнал генерируется только при включённом отслеживании мыши или при нажатии кнопки мыши во время перемещения в элемент.

См. также QWidget::setMouseTracking().

[signal] void QListWidget::нажатие на элемент(QListWidgetItem *item)

Этот сигнал генерируется со указанным item, когда на элемент виджета нажата кнопка мыши.

См. также itemClicked() и itemDoubleClicked().

[signal] void QListWidget::изменение выбора элементов()

Этот сигнал генерируется всякий раз, когда меняется выбор.

См. также selectedItems(), QListWidgetItem::isSelected() и currentItemChanged().

[slot] void QListWidget::scrollToItem(const QListWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible)

Прокручивает представление при необходимости, чтобы обеспечить видимость элемента item.

hint задает расположение элемента item после операции.

[virtual] QListWidget::~QListWidget()

Удаляет виджет списка и все его элементы.

void QListWidget::addItem(const QString &label)

Вставляет элемент с текстом label в конец виджета списка.

void QListWidget::addItem(QListWidgetItem *item)

Вставляет элемент item в конец виджета списка.

См. также insertItem().

void QListWidget::addItems(const QStringList &labels)

Вставляет элементы с текстом labels в конец виджета списка.

См. также insertItems().

void QListWidget::closePersistentEditor(QListWidgetItem *item)

Закрывает постоянный редактор для данного элемента item.

См. также openPersistentEditor() и isPersistentEditorOpen().

QListWidgetItem *QListWidget::currentItem() const

Возвращает текущий элемент.

См. также setCurrentItem().

[override virtual protected] void QListWidget::dropEvent(QDropEvent *event)

Переопределяет: QListView::dropEvent(QDropEvent *event).

[virtual protected] bool QListWidget::dropMimeData(int index, const QMimeData *data, Qt::DropAction action)

Обрабатывает данные data, предоставленные внешней операцией перетаскивания, завершившейся заданным действием action в заданном index. Возвращает true если data и action могут быть обработаны моделью; в противном случае возвращает false.

См. также supportedDropActions().

void QListWidget::editItem(QListWidgetItem *item)

Начинает редактирование элемента item, если он редактируемый.

[override virtual protected] bool QListWidget::event(QEvent *e)

Переопределяет: QListView::event(QEvent *e).

QList<QListWidgetItem *> QListWidget::findItems(const QString &text, Qt::MatchFlags flags) const

Находит элементы с текстом, соответствующим строке text, используя заданные flags.

QModelIndex QListWidget::indexFromItem(const QListWidgetItem *item) const

Возвращает QModelIndex, связанную с данным элементом item.

void QListWidget::insertItem(int row, QListWidgetItem *item)

Вставляет элемент item в позицию в списке, заданную row.

См. также addItem().

void QListWidget::insertItem(int row, const QString &label)

Вставляет элемент с текстом label в виджет списка в позиции, заданной row.

См. также addItem().

void QListWidget::insertItems(int row, const QStringList &labels)

Вставляет элементы из списка labels в список, начиная с заданного row.

См. также insertItem() и addItem().

[since 5.10] bool QListWidget::isPersistentEditorOpen(QListWidgetItem *item) const

Возвращает значение, указывающее, открыт ли постоянный редактор для элемента item.

Эта функция была добавлена в Qt 5.10.

См. также openPersistentEditor() и closePersistentEditor().

QListWidgetItem *QListWidget::item(int row) const

Возвращает элемент, занимающий заданный row в списке, если он задан; в противном случае возвращает nullptr.

См. также row().

QListWidgetItem *QListWidget::itemAt(const QPoint &p) const

Возвращает указатель на элемент в координатах p. Координаты относительны к области отображения (viewport) виджета списка.

QListWidgetItem *QListWidget::itemAt(int x, int y) const

Это перегруженная функция.

Возвращает указатель на элемент в координатах (x, y). Координаты относительны к области отображения (viewport) виджета списка.

QListWidgetItem *QListWidget::itemFromIndex(const QModelIndex &index) const

Возвращает указатель на QListWidgetItem, связанный с заданным index.

QWidget *QListWidget::itemWidget(QListWidgetItem *item) const

Возвращает виджет, отображаемый в данном элементе item.

См. также setItemWidget() и removeItemWidget().

QList<QListWidgetItem *> QListWidget::items(const QMimeData *data) const

Возвращает список указателей на элементы, содержащиеся в объекте data. Если объект не был создан виджетом QListWidget в том же процессе, список пустой.

[virtual protected] QMimeData *QListWidget::mimeData(const QList<QListWidgetItem *> &items) const

Возвращает объект, содержащий сериализованное описание указанных элементов items. Формат описания элементов получен из функции mimeTypes().

Если список элементов пуст, возвращается nullptr вместо сериализованного пустого списка.

[virtual protected] QStringList QListWidget::mimeTypes() const

Возвращает список MIME-типов, которые могут быть использованы для описания списка элементов виджета списка.

См. также mimeData().

void QListWidget::openPersistentEditor(QListWidgetItem *item)

Открывает редактор для данного элемента item. Редактор остаётся открытым после редактирования.

См. также closePersistentEditor() и isPersistentEditorOpen().

void QListWidget::removeItemWidget(QListWidgetItem *item)

Удаляет виджет, установленный на данный элемент item.

Для удаления элемента (строки) из списка полностью, либо удалите элемент, либо используйте takeItem().

См. также itemWidget() и setItemWidget().

int QListWidget::row(const QListWidgetItem *item) const

Возвращает строку, содержащую данный элемент item.

См. также item().

QList<QListWidgetItem *> QListWidget::selectedItems() const

Возвращает список всех выделенных элементов в списке.

void QListWidget::setCurrentItem(QListWidgetItem *item)

Устанавливает текущим элементом item.

Если режим выбора не NoSelection, элемент также выбирается.

См. также currentItem().

void QListWidget::setCurrentItem(QListWidgetItem *item, QItemSelectionModel::SelectionFlags command)

Устанавливает текущим элементом item, используя указанное command.

void QListWidget::setCurrentRow(int row, QItemSelectionModel::SelectionFlags command)

Устанавливает текущей строкой заданную row, используя указанное command.

Примечание: Функция-сеттер для свойства currentRow.

void QListWidget::setItemWidget(QListWidgetItem *item, QWidget *widget)

Устанавливает widget для отображения в заданном item.

Эта функция должна использоваться только для отображения статического содержимого вместо элемента списка. Если требуется отображать пользовательское динамическое содержимое или реализовать пользовательский редактор, используйте QListView и подкласс QStyledItemDelegate вместо этого.

См. также itemWidget(), removeItemWidget(), и Классы-делегаты.

[override virtual] void QListWidget::setSelectionModel(QItemSelectionModel *selectionModel)

Переопределяет: QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).

void QListWidget::sortItems(Qt::SortOrder order = Qt::AscendingOrder)

Сортирует все элементы в списке в соответствии с заданным order.

[virtual protected] Qt::DropActions QListWidget::supportedDropActions() const

Возвращает поддерживаемые действия перетаскивания для этого представления.

См. также Qt::DropActions.

QListWidgetItem *QListWidget::takeItem(int row)

Удаляет и возвращает элемент из заданной row в списке; в противном случае возвращает nullptr.

Элементы, удаленные из списка, не будут управляться Qt и должны быть удалены вручную.

См. также insertItem() и addItem().

QRect QListWidget::visualItemRect(const QListWidgetItem *item) const

Возвращает прямоугольник на области просмотра, занимаемый элементом в позиции item.