Класс 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

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

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

[protected] void QTreeWidgetItem::emitDataChanged()

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

Вам обычно не нужно вызывать эту функцию, если вы не переопределили 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 в список дочерних элементов.

Если элемент child уже вставлен в другое место, он не будет вставлен снова.

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. Установка кисти по умолчанию позволит представлению использовать цвет по умолчанию из стиля.

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

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

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

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

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

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

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

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

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

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

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

void QTreeWidgetItem::setDisabled(bool disabled)

Деактивирует элемент, если disabled равно true; в противном случае активирует элемент.

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

void QTreeWidgetItem::setExpanded(bool expand)

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

См. также 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, иначе показывает элемент.

См. также 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.

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

Возвращает текст в указанном column.

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

int QTreeWidgetItem::textAlignment(int column) const

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

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

QString QTreeWidgetItem::toolTip(int column) const

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

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

QTreeWidget *QTreeWidgetItem::treeWidget() const

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

int QTreeWidgetItem::type() const

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

QString QTreeWidgetItem::whatsThis(int column) const

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

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

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

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

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

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

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