Класс QTreeWidgetItem

Класс QTreeWidgetItem предоставляет элемент для использования с удобным классом QTreeWidget. Подробнее...

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

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

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

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

Связанные внешние члены

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

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

Класс QTreeWidgetItem — это вспомогательный класс, который заменяет класс QListViewItem в Qt 3. Он предоставляет элемент для использования с классом QTreeWidget.

Элементы обычно создаются с родителем, который является либо QTreeWidget (для элементов верхнего уровня), либо QTreeWidgetItem (для элементов на более низких уровнях дерева). Например, следующий код создает элемент верхнего уровня для представления городов мира и добавляет запись для Осло как дочерний элемент:

    QTreeWidgetItem *cities = new QTreeWidgetItem(treeWidget);
    cities->setText(0, tr("Cities"));
    QTreeWidgetItem *osloItem = new QTreeWidgetItem(cities);
    osloItem->setText(0, tr("Oslo"));
    osloItem->setText(1, tr("Yes"));

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

    QTreeWidgetItem *planets = new QTreeWidgetItem(treeWidget, cities);
    planets->setText(0, tr("Planets"));

Каждый столбец в элементе может иметь свою собственную кисть фона, которая устанавливается с помощью функции setBackground(). Текущую кисть фона можно найти с помощью background(). Текстовую метку для каждого столбца можно отображать с помощью своего шрифта и кисти. Они задаются функциями setFont() и setForeground() и считываются с помощью font() и foreground().

Основное различие между элементами верхнего уровня и элементами на более низких уровнях дерева заключается в том, что у элемента верхнего уровня нет родителя parent(). Эта информация может быть использована для различения элементов и полезна для понимания при вставке и удалении элементов из дерева. Дочерние элементы элемента могут быть удалены с помощью takeChild() и вставлены в заданном индексе в списке дочерних элементов с помощью функции insertChild().

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

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

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

См. также QTreeWidget, QTreeWidgetItemIterator, Моделирование/представление, QListWidgetItem и QTableWidgetItem.

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

Перечисление QTreeWidgetItem::ChildIndicatorPolicy

Перечисление QTreeWidgetItem::ItemType

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

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

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

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

QTreeWidgetItem::QTreeWidgetItem(const QTreeWidgetItem &other)

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

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

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

QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, QTreeWidgetItem *preceding, int type = Type)

Создает элемент виджета дерева указанного type, который вставляется в parent после дочернего элемента preceding.

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

QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, const QStringList &strings, int type = Type)

Создает элемент виджета дерева и добавляет его к заданному parent. Заданный список strings будет установлен в качестве текста элемента для каждого столбца в элементе.

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

QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, int type = Type)

Создает элемент виджета дерева и добавляет его к заданному parent.

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

QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, QTreeWidgetItem *preceding, int type = Type)

Создает элемент виджета дерева указанного type и вставляет его в заданный parent после элемента preceding.

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

QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, const QStringList &strings, int type = Type)

Создает элемент виджета дерева указанного type и добавляет его к элементам в заданном parent. Заданный список strings будет установлен в качестве текста элемента для каждого столбца в элементе.

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

QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, int type = Type)

Создаёт элемент дерева заданного типа type и добавляет его к элементам заданного parent.

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

QTreeWidgetItem::QTreeWidgetItem(const QStringList &strings, int type = Type)

Создаёт элемент дерева заданного типа type. Элемент должен быть вставлен в виджет дерева. Переданный список strings будет установлен в качестве текста элемента для каждого столбца.

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

QTreeWidgetItem::QTreeWidgetItem(int type = Type)

Создаёт элемент дерева заданного типа type. Элемент должен быть вставлен в виджет дерева.

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

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

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

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

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

[virtual] QTreeWidgetItem::~QTreeWidgetItem()

Уничтожает этот элемент виджета дерева.

Элемент будет удалён из QTreeWidgetов, к которым он был добавлен. Это делает безопасным удаление элемента в любое время.

void QTreeWidgetItem::addChild(QTreeWidgetItem *child)

Добавляет элемент child в список дочерних элементов.

См. также insertChild() и takeChild().

void QTreeWidgetItem::addChildren(const QList<QTreeWidgetItem *> &children)

Добавляет данный список children к элементу.

См. также insertChildren() и takeChildren().

QBrush QTreeWidgetItem::background(int column) const

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

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

Qt::CheckState QTreeWidgetItem::checkState(int column) const

Возвращает состояние отметки метки в заданном column.

См. также setCheckState() и Qt::CheckState.

QTreeWidgetItem *QTreeWidgetItem::child(int index) const

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

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

int QTreeWidgetItem::childCount() const

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

QTreeWidgetItem::ChildIndicatorPolicy QTreeWidgetItem::childIndicatorPolicy() const

Возвращает политику индикатора дочерних элементов. Эта политика определяет, когда отображается индикатор раскрытия/свертывания ветви дерева.

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

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

Создаёт глубокую копию элемента и его дочерних элементов.

int QTreeWidgetItem::columnCount() const

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

[virtual] QVariant QTreeWidgetItem::data(int column, int role) const

Возвращает значение для столбца и роли элемента.

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

[protected] void QTreeWidgetItem::emitDataChanged()

Вызывает сигнал dataChanged() для модели, связанной с этим элементом, по этому элементу.

Обычно вызывать эту функцию нужно только в том случае, если вы расширили класс QTreeWidgetItem и переопределили data() и/или setData().

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

Qt::ItemFlags QTreeWidgetItem::flags() const

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

Значение по умолчанию для флагов — Qt::ItemIsSelectable | Qt::ItemIsUserCheckable | Qt::ItemIsEnabled | Qt::ItemIsDragEnabled | Qt::ItemIsDropEnabled.

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

QFont QTreeWidgetItem::font(int column) const

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

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

QBrush QTreeWidgetItem::foreground(int column) const

Возвращает кисть, используемую для отрисовки переднего плана (например, текста) указанного column. Установка кисти по умолчанию позволит представлению использовать цвет по умолчанию из стиля.

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

QIcon QTreeWidgetItem::icon(int column) const

Возвращает значок, отображаемый в указанном column.

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

int QTreeWidgetItem::indexOfChild(QTreeWidgetItem *child) const

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

void QTreeWidgetItem::insertChild(int index, QTreeWidgetItem *child)

Вставляет элемент child в index в списке дочерних элементов.

Если дочерний элемент уже вставлен где-то ещё, он не будет вставлен ещё раз.

void QTreeWidgetItem::insertChildren(int index, const QList<QTreeWidgetItem *> &children)

Вставляет заданный список children в список дочерних элементов элемента по index.

Дочерние элементы, которые уже были вставлены где-либо ещё, не будут вставлены.

bool QTreeWidgetItem::isDisabled() const

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

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

bool QTreeWidgetItem::isExpanded() const

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

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

bool QTreeWidgetItem::isFirstColumnSpanned() const

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

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

bool QTreeWidgetItem::isHidden() const

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

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

bool QTreeWidgetItem::isSelected() const

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

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

QTreeWidgetItem *QTreeWidgetItem::parent() const

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

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

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

Читает элемент из потока in. Это считывает данные только в один элемент.

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

void QTreeWidgetItem::removeChild(QTreeWidgetItem *child)

Удаляет указанный элемент, обозначенный как child. Удаляемый элемент не будет удалён.

void QTreeWidgetItem::setBackground(int column, const QBrush &brush)

Устанавливает кисть фона метки в заданном column на указанную brush. Установка кисти по умолчанию позволит представлению использовать цвет по умолчанию из стиля.

Примечание: Если Qt Стиль используется на том же виджете, что и setBackground(), стили будут иметь приоритет, если настройки конфликтуют.

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

void QTreeWidgetItem::setCheckState(int column, Qt::CheckState state)

Устанавливает состояние отметки элемента в заданном column на state.

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

void QTreeWidgetItem::setChildIndicatorPolicy(QTreeWidgetItem::ChildIndicatorPolicy policy)

Устанавливает политику индикатора элемента. Данная политика определяет, когда отображается индикатор развёртывания/сворачивания ветви дерева. Значение по умолчанию — DontShowIndicatorWhenChildless.

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

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

Устанавливает значение для элемента в column и role на заданное value.

Role описывает тип данных, заданных value, и определяется перечислением Qt::ItemDataRole.

Примечание: Реализация по умолчанию рассматривает Qt::EditRole и Qt::DisplayRole как ссылки на одни и те же данные.

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

void QTreeWidgetItem::setDisabled(bool disabled)

Отключает элемент, если disabled равно true; иначе включает элемент.

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

void QTreeWidgetItem::setExpanded(bool expand)

Развертывает элемент, если expand равно true, иначе сворачивает элемент.

Предупреждение: QTreeWidgetItem должен быть добавлен в QTreeWidget перед вызовом этой функции.

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

void QTreeWidgetItem::setFirstColumnSpanned(bool span)

Устанавливает первую секцию, чтобы она охватывала все столбцы, если span равно true; иначе все секции элемента отображаются.

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

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

Устанавливает флаги для элемента на заданные flags. Они определяют, может ли элемент быть выбран или изменён. Часто используется для отключения элемента.

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

void QTreeWidgetItem::setFont(int column, const QFont &font)

Устанавливает шрифт для отображения текста в заданном column на указанный font.

См. также font(), setText() и setForeground().

void QTreeWidgetItem::setForeground(int column, const QBrush &brush)

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

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

void QTreeWidgetItem::setHidden(bool hide)

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

Примечание: Вызов этой функции не имеет эффекта, если элемент не находится в представлении. В частности, вызов setHidden(true) для элемента и только потом добавление его в представление приведет к отображению элемента.

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

void QTreeWidgetItem::setIcon(int column, const QIcon &icon)

Устанавливает значок для отображения в заданном column на icon.

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

void QTreeWidgetItem::setSelected(bool select)

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

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

void QTreeWidgetItem::setSizeHint(int column, const QSize &size)

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

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

void QTreeWidgetItem::setStatusTip(int column, const QString &statusTip)

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

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

void QTreeWidgetItem::setText(int column, const QString &text)

Устанавливает текст для отображения в заданном column на заданный text.

См. также text(), setFont() и setForeground().

void QTreeWidgetItem::setTextAlignment(int column, int alignment)

Устанавливает выравнивание текста для метки в заданном column на указанное alignment (см. Qt::AlignmentFlag).

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

void QTreeWidgetItem::setToolTip(int column, const QString &toolTip)

Устанавливает всплывающую подсказку для заданного column на toolTip.

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

void QTreeWidgetItem::setWhatsThis(int column, const QString &whatsThis)

Устанавливает подсказку «Что это?» для заданного column на whatsThis.

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

QSize QTreeWidgetItem::sizeHint(int column) const

Возвращает размер подсказки, установленный для элемента дерева в заданном column (см. QSize).

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

void QTreeWidgetItem::sortChildren(int column, Qt::SortOrder order)

Сортирует дочерние элементы элемента, используя заданный order, по значениям в заданном column.

Примечание: Эта функция ничего не делает, если элемент не связан с QTreeWidget.

QString QTreeWidgetItem::statusTip(int column) const

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

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

QTreeWidgetItem *QTreeWidgetItem::takeChild(int index)

Удаляет элемент в index и возвращает его, в противном случае возвращает 0.

QList<QTreeWidgetItem *> QTreeWidgetItem::takeChildren()

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

QString QTreeWidgetItem::text(int column) const

Возвращает текст в указанном столбце.

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

int QTreeWidgetItem::textAlignment(int column) const

Возвращает выравнивание текста для метки в заданном столбце (см. Qt::AlignmentFlag).

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

QString QTreeWidgetItem::toolTip(int column) const

Возвращает подсказку для заданного столбца.

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

QTreeWidget *QTreeWidgetItem::treeWidget() const

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

int QTreeWidgetItem::type() const

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

QString QTreeWidgetItem::whatsThis(int column) const

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

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

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

Записывает элемент в поток out. Это записывает данные только из одного элемента.

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

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

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