Класс QTreeWidgetItem

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

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

Публичные типы

Публичные функции

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

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

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

Класс 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(int type = Type)

Конструирует элемент виджета дерева указанного type. Элемент должен быть вставлен в виджет дерева.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QTreeWidgetItem::QTreeWidgetItem(const QTreeWidgetItem &other)

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

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

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

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

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

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

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

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

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

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

QBrush QTreeWidgetItem::foreground(int column) const

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

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

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

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

Эта функция была добавлена в 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 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.

См. также 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. Если размер подсказки не установлен, делегат элемента вычислит размер подсказки на основе данных элемента.

Эта функция была добавлена в 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.

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

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

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

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