Класс QListWidget

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

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

Свойства

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

• 13 свойств, унаследованных от QListView
• 16 свойств, унаследованных от QAbstractItemView
• 3 свойства, унаследованных от QAbstractScrollArea
• 6 свойств, унаследованных от QFrame
• 58 свойств, унаследованных от QWidget
• 1 свойство, унаследованное от QObject

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

Реализованные публичные функции

• 32 публичных функций, унаследованных от QListView
• 57 публичных функций, унаследованных от QAbstractItemView
• 20 публичных функций, унаследованных от QAbstractScrollArea
• 14 публичных функций, унаследованных от QFrame
• 211 публичных функций, унаследованных от QWidget
• 31 публичной функции, унаследованной от QObject
• 14 публичных функций, унаследованных от QPaintDevice

Публичные слоты

• 9 публичных слотов, унаследованных от QAbstractItemView
• 19 публичных слотов, унаследованных от QWidget
• 1 публичный слот, унаследованный от QObject

Сигналы

• 1 сигнал унаследован от QListView
• 7 сигналов унаследованных от QAbstractItemView
• 3 сигнала унаследованных от QWidget
• 2 сигнала унаследованных от QObject

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

Переопределенные защищенные функции

• 28 защищенных функций унаследованных от QListView
• 37 защищенных функций унаследованных от QAbstractItemView
• 20 защищенных функций унаследованных от QAbstractScrollArea
• 4 защищенных функций унаследованных от QFrame
• 35 защищенных функций унаследованных от QWidget
• 9 защищенных функций унаследованных от QObject
• 1 защищенная функция унаследованная от QPaintDevice

Дополнительные унаследованные члены

• 5 статических публичных членов унаследованных от QWidget
• 11 статических публичных членов унаследованных от QObject
• 9 защищенных слотов унаследованных от QAbstractItemView
• 1 защищенный слот унаследованный от QWidget

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

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

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() с новым текущим элементом и элементом, который был текущим ранее.

Виджет списка стиля Windows Vista.	Виджет списка стиля Macintosh.	Виджет списка стиля Fusion.

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

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

QListWidget::QListWidget(QWidget *parent = Q_NULLPTR)

Создает пустой QListWidget с указанным родительским виджетом.

QListWidget::~QListWidget()

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

void QListWidget::addItem(const QString &label)

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

void QListWidget::addItem(QListWidgetItem *item)

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

Предупреждение: Элемент QListWidgetItem может быть добавлен в QListWidget только один раз. Добавление одного и того же элемента QListWidgetItem в QListWidget несколько раз приведёт к неопределённому поведению.

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

void QListWidget::addItems(const QStringList &labels)

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

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

[slot] void QListWidget::clear()

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

Предупреждение: Все элементы будут удалены навсегда.

void QListWidget::closePersistentEditor(QListWidgetItem *item)

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

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

QListWidgetItem *QListWidget::currentItem() const

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

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

[signal] void QListWidget::currentItemChanged(QListWidgetItem *current, QListWidgetItem *previous)

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

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

[signal] void QListWidget::currentRowChanged(int currentRow)

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

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

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

[signal] void QListWidget::currentTextChanged(const QString &currentText)

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

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

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

Переопределено из QWidget::dropEvent().

[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, если он редактируемый.

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

Переопределено из QObject::event().

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

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

[protected] QModelIndex QListWidget::indexFromItem(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().

QListWidgetItem *QListWidget::item(int row) const

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

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

[signal] void QListWidget::itemActivated(QListWidgetItem *item)

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

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

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

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

Это перегруженный метод.

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

[signal] void QListWidget::itemChanged(QListWidgetItem *item)

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

[signal] void QListWidget::itemClicked(QListWidgetItem *item)

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

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

[signal] void QListWidget::itemDoubleClicked(QListWidgetItem *item)

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

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

[signal] void QListWidget::itemEntered(QListWidgetItem *item)

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

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

[protected] QListWidgetItem *QListWidget::itemFromIndex(const QModelIndex &index) const

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

[signal] void QListWidget::itemPressed(QListWidgetItem *item)

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

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

[signal] void QListWidget::itemSelectionChanged()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

void QListWidget::openPersistentEditor(QListWidgetItem *item)

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

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

void QListWidget::removeItemWidget(QListWidgetItem *item)

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

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

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

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

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

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

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

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

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

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

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

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

void QListWidget::setCurrentItem(QListWidgetItem *item)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QListWidgetItem *QListWidget::takeItem(int row)

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

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

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

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

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