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

Это перечисление было введено или изменено в Qt 4.3.

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

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

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

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

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

QTreeWidgetItem::QTreeWidgetItem(const QTreeWidgetItem &other)

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

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

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

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

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

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

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

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

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

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

QTreeWidgetItem::QTreeWidgetItem(int 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 к элементу.

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

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

QBrush QTreeWidgetItem::background(int column) const

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

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

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

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

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

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

QTreeWidgetItem *QTreeWidgetItem::child(int index) const

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

См. также 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() для этого элемента.

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

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

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

Qt::ItemFlags QTreeWidgetItem::flags() const

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

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

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

QFont QTreeWidgetItem::font(int column) const

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

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

QBrush QTreeWidgetItem::foreground(int column) const

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

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

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

QIcon QTreeWidgetItem::icon(int column) const

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

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

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

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

bool QTreeWidgetItem::isDisabled() const

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

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

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

bool QTreeWidgetItem::isExpanded() const

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

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

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

bool QTreeWidgetItem::isFirstColumnSpanned() const

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

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

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

bool QTreeWidgetItem::isHidden() const

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

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

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

bool QTreeWidgetItem::isSelected() const

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

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

См. также 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(), стили будут иметь приоритет, если настройки конфликтуют.

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

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

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

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

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

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

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

См. также 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; в противном случае включает элемент.

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

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

void QTreeWidgetItem::setExpanded(bool expand)

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

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

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

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

void QTreeWidgetItem::setFirstColumnSpanned(bool span)

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

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

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

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

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

void QTreeWidgetItem::setHidden(bool hide)

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

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

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

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

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

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

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

void QTreeWidgetItem::setSelected(bool select)

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

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

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

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

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

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

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

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

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

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

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

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

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

QString QTreeWidgetItem::statusTip(int column) const

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

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

QTreeWidgetItem *QTreeWidgetItem::takeChild(int index)

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

QList<QTreeWidgetItem *> QTreeWidgetItem::takeChildren()

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

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

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.