Класс QListWidgetItem

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

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

Открытые типы

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

Связанные внешние функции

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

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

Элемент QListWidgetItem представляет отдельный элемент в QListWidget. Каждый элемент может содержать несколько частей информации и отображать их соответствующим образом.

Удобные классы представлений элементов используют классический интерфейс на основе элементов, а не чисто модельно-представленческий подход. Для более гибкого виджета списка рассмотрите возможность использования класса QListView со стандартной моделью.

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

    new QListWidgetItem(tr("Hazel"), listWidget);

В качестве альтернативы, элементы списка могут также создаваться без родительского виджета, а затем добавляться в список с помощью QListWidget::insertItem().

Элементы списка обычно используются для отображения text() и icon(). Они устанавливаются с помощью функций setText() и setIcon(). Внешний вид текста может быть настроен с помощью setFont(), setForeground() и setBackground(). Текст в элементах списка можно выравнивать с помощью функции setTextAlignment(). Подсказки, подсказки состояния и справка "Что это?" могут быть добавлены к элементам списка с помощью setToolTip(), setStatusTip() и setWhatsThis().

По умолчанию элементы включены, выбираемы, могут быть отмечены флажком и могут быть источником операций перетаскивания.

Флаги каждого элемента могут быть изменены вызовом setFlags() с соответствующим значением (см. Qt::ItemFlags). Элементы с возможностью выбора могут быть выбраны, сняты с выбора и частично выбраны с помощью функции setCheckState(). Соответствующая функция checkState() указывает текущее состояние выбора элемента.

Функция isHidden() может быть использована для определения, скрыт ли элемент. Чтобы скрыть элемент, используйте setHidden().

Наследование

При наследовании от QListWidgetItem для предоставления пользовательских элементов, можно определить новые типы для них, позволяющие отличать их от стандартных элементов. Для подклассов, которым требуется эта функция, убедитесь, что вы вызываете конструктор базового класса со значением нового типа, равным или большим UserType, внутри вашего конструктора.

См. также QListWidget, Моделирование/Представление данных, QTreeWidgetItem и QTableWidgetItem.

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

enum QListWidgetItem::ItemType

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

Вы можете определять новые пользовательские типы в подклассах QListWidgetItem, чтобы гарантировать, что пользовательские элементы обрабатываются особым образом.

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

Документация функций членов

QListWidgetItem::QListWidgetItem(QListWidget *parent = Q_NULLPTR, int type = Type)

Создает пустой элемент виджета списка указанного type с заданным parent. Если parent не указан, элемент необходимо вставить в виджет списка с помощью QListWidget::insertItem().

Этот конструктор вставляет элемент в модель родительского элемента, переданного в конструктор. Если модель отсортирована, поведение вставки неопределённо, так как модель вызовет метод '<' оператора для элемента, который на данном этапе ещё не создан. Чтобы избежать неопределённого поведения, рекомендуется не указывать родительский элемент и использовать QListWidget::insertItem() вместо этого.

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

QListWidgetItem::QListWidgetItem(const QString &text, QListWidget *parent = Q_NULLPTR, int type = Type)

Создает пустой элемент виджета списка указанного type с заданным текстом text и parent. Если родительский элемент не указан, элемент необходимо вставить в виджет списка с помощью QListWidget::insertItem().

Этот конструктор вставляет элемент в модель родительского элемента, переданного в конструктор. Если модель отсортирована, поведение вставки неопределённо, так как модель вызовет метод '<' оператора для элемента, который на данном этапе ещё не создан. Чтобы избежать неопределённого поведения, рекомендуется не указывать родительский элемент и использовать QListWidget::insertItem() вместо этого.

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

QListWidgetItem::QListWidgetItem(const QIcon &icon, const QString &text, QListWidget *parent = Q_NULLPTR, int type = Type)

Создает пустой элемент виджета списка указанного type с заданным icon, text и parent. Если родительский элемент не указан, элемент необходимо вставить в виджет списка с помощью QListWidget::insertItem().

Этот конструктор вставляет элемент в модель родительского элемента, переданного в конструктор. Если модель отсортирована, поведение вставки неопределённо, так как модель вызовет метод '<' оператора для элемента, который на данном этапе ещё не создан. Чтобы избежать неопределённого поведения, рекомендуется не указывать родительский элемент и использовать QListWidget::insertItem() вместо этого.

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

QListWidgetItem::QListWidgetItem(const QListWidgetItem &other)

Создаёт копию other. Обратите внимание, что type() и listWidget() не копируются.

Эта функция полезна при переопределении clone().

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

См. также data() и flags().

[virtual] QListWidgetItem::~QListWidgetItem()

Удаляет элемент списка.

QBrush QListWidgetItem::background() const

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

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

См. также setBackground() и foreground().

Qt::CheckState QListWidgetItem::checkState() const

Возвращает состояние выбора элемента списка (см. Qt::CheckState).

См. также setCheckState() и flags().

[virtual] QListWidgetItem *QListWidgetItem::clone() const

Создаёт точную копию элемента.

[virtual] QVariant QListWidgetItem::data(int role) const

Возвращает данные элемента для заданного role. Переопределите эту функцию, если вам нужны дополнительные роли или специальное поведение для определённых ролей.

См. также Qt::ItemDataRole и setData().

Qt::ItemFlags QListWidgetItem::flags() const

Возвращает флаги элемента для данного элемента (см. Qt::ItemFlags).

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

QFont QListWidgetItem::font() const

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

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

QBrush QListWidgetItem::foreground() const

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

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

См. также setForeground() и background().

QIcon QListWidgetItem::icon() const

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

См. также setIcon() и iconSize.

bool QListWidgetItem::isHidden() const

Возвращает true если элемент скрыт; в противном случае возвращает false.

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

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

bool QListWidgetItem::isSelected() const

Возвращает true если элемент выбран; в противном случае возвращает false.

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

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

QListWidget *QListWidgetItem::listWidget() const

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

[virtual] void QListWidgetItem::read(QDataStream &in)

Считывает элемент из потока in.

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

void QListWidgetItem::setBackground(const QBrush &brush)

Устанавливает кисть фона элемента списка на заданную brush.

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

См. также background() и setForeground().

void QListWidgetItem::setCheckState(Qt::CheckState state)

Устанавливает состояние выбора элемента списка в state.

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

[virtual] void QListWidgetItem::setData(int role, const QVariant &value)

Устанавливает данные для заданного role на заданное значение value. Переопределите эту функцию, если вам нужны дополнительные роли или специальное поведение для определённых ролей.

См. также Qt::ItemDataRole и data().

void QListWidgetItem::setFlags(Qt::ItemFlags flags)

Устанавливает флаги элемента списка на flags.

См. также flags() и Qt::ItemFlags.

void QListWidgetItem::setFont(const QFont &font)

Устанавливает шрифт, используемый при рисовании элемента, на указанный font.

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

void QListWidgetItem::setForeground(const QBrush &brush)

Устанавливает кисть переднего плана элемента списка на заданную brush.

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

См. также foreground() и setBackground().

void QListWidgetItem::setHidden(bool hide)

Скрывает элемент, если hide равно true; в противном случае отображает элемент.

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

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

void QListWidgetItem::setIcon(const QIcon &icon)

Устанавливает значок для элемента списка на указанный icon.

См. также icon(), text() и iconSize.

void QListWidgetItem::setSelected(bool select)

Устанавливает состояние выбора элемента на select.

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

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

void QListWidgetItem::setSizeHint(const QSize &size)

Устанавливает подсказку размера для элемента списка на size. Если подсказка размера не установлена, делегат элемента вычислит подсказку размера на основе данных элемента.

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

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

void QListWidgetItem::setStatusTip(const QString &statusTip)

Устанавливает подсказку состояния для элемента списка на текст, заданный параметром statusTip. Для работы этой функции необходимо включить отслеживание нажатий мыши в QListWidget.

См. также statusTip(), setToolTip(), setWhatsThis() и QWidget::setMouseTracking().

void QListWidgetItem::setText(const QString &text)

Устанавливает текст для элемента списка на заданный text.

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

void QListWidgetItem::setTextAlignment(int alignment)

Устанавливает выравнивание текста элемента списка на alignment.

См. также textAlignment() и Qt::AlignmentFlag.

void QListWidgetItem::setToolTip(const QString &toolTip)

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

См. также toolTip(), setStatusTip() и setWhatsThis().

void QListWidgetItem::setWhatsThis(const QString &whatsThis)

Устанавливает подсказку справки "Что это?" для элемента списка на текст, заданный параметром whatsThis.

См. также whatsThis(), setStatusTip() и setToolTip().

QSize QListWidgetItem::sizeHint() const

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

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

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

QString QListWidgetItem::statusTip() const

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

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

QString QListWidgetItem::text() const

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

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

int QListWidgetItem::textAlignment() const

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

См. также setTextAlignment() и Qt::AlignmentFlag.

QString QListWidgetItem::toolTip() const

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

См. также setToolTip(), statusTip() и whatsThis().

int QListWidgetItem::type() const

Возвращает тип, переданный в конструктор QListWidgetItem.

QString QListWidgetItem::whatsThis() const

Возвращает текст подсказки "Что это?" для элемента списка.

См. также setWhatsThis(), statusTip() и toolTip().

[virtual] void QListWidgetItem::write(QDataStream &out) const

Записывает элемент в поток out.

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

[virtual] bool QListWidgetItem::operator<(const QListWidgetItem &other) const

Возвращает true если текст этого элемента меньше текста элемента other; в противном случае возвращает false.

QListWidgetItem &QListWidgetItem::operator=(const QListWidgetItem &other)

Присваивает данные и флаги элемента other этому элементу. Обратите внимание, что type() и listWidget() не копируются.

Эта функция полезна при переопределении clone().

См. также data() и flags().