QTreeWidgetItem Class
La clase QTreeWidgetItem proporciona un elemento para su uso con la clase de conveniencia QTreeWidget. Más...
| Cabecera: | #include <QTreeWidgetItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
Tipos públicos
| enum | ChildIndicatorPolicy { ShowIndicator, DontShowIndicator, DontShowIndicatorWhenChildless } |
| enum | ItemType { Type, UserType } |
Funciones Públicas
| QTreeWidgetItem(int type = Type) | |
| QTreeWidgetItem(QTreeWidget *parent, int type = Type) | |
| QTreeWidgetItem(QTreeWidgetItem *parent, int type = Type) | |
| QTreeWidgetItem(const QStringList &strings, int type = Type) | |
| QTreeWidgetItem(QTreeWidget *parent, QTreeWidgetItem *preceding, int type = Type) | |
| QTreeWidgetItem(QTreeWidget *parent, const QStringList &strings, int type = Type) | |
| QTreeWidgetItem(QTreeWidgetItem *parent, QTreeWidgetItem *preceding, int type = Type) | |
| QTreeWidgetItem(QTreeWidgetItem *parent, const QStringList &strings, int type = Type) | |
| QTreeWidgetItem(const QTreeWidgetItem &other) | |
| virtual | ~QTreeWidgetItem() |
| void | addChild(QTreeWidgetItem *child) |
| void | addChildren(const QList<QTreeWidgetItem *> &children) |
| QBrush | background(int column) const |
| Qt::CheckState | checkState(int column) const |
| QTreeWidgetItem * | child(int index) const |
| int | childCount() const |
| QTreeWidgetItem::ChildIndicatorPolicy | childIndicatorPolicy() const |
| virtual QTreeWidgetItem * | clone() const |
| int | columnCount() const |
| virtual QVariant | data(int column, int role) const |
| Qt::ItemFlags | flags() const |
| QFont | font(int column) const |
| QBrush | foreground(int column) const |
| QIcon | icon(int column) const |
| int | indexOfChild(QTreeWidgetItem *child) const |
| void | insertChild(int index, QTreeWidgetItem *child) |
| void | insertChildren(int index, const QList<QTreeWidgetItem *> &children) |
| bool | isDisabled() const |
| bool | isExpanded() const |
| bool | isFirstColumnSpanned() const |
| bool | isHidden() const |
| bool | isSelected() const |
| QTreeWidgetItem * | parent() const |
| virtual void | read(QDataStream &in) |
| void | removeChild(QTreeWidgetItem *child) |
| void | setBackground(int column, const QBrush &brush) |
| void | setCheckState(int column, Qt::CheckState state) |
| void | setChildIndicatorPolicy(QTreeWidgetItem::ChildIndicatorPolicy policy) |
| virtual void | setData(int column, int role, const QVariant &value) |
| void | setDisabled(bool disabled) |
| void | setExpanded(bool expand) |
| void | setFirstColumnSpanned(bool span) |
| void | setFlags(Qt::ItemFlags flags) |
| void | setFont(int column, const QFont &font) |
| void | setForeground(int column, const QBrush &brush) |
| void | setHidden(bool hide) |
| void | setIcon(int column, const QIcon &icon) |
| void | setSelected(bool select) |
| void | setSizeHint(int column, const QSize &size) |
| void | setStatusTip(int column, const QString &statusTip) |
| void | setText(int column, const QString &text) |
(since 6.4) void | setTextAlignment(int column, Qt::Alignment alignment) |
| void | setToolTip(int column, const QString &toolTip) |
| void | setWhatsThis(int column, const QString &whatsThis) |
| QSize | sizeHint(int column) const |
| void | sortChildren(int column, Qt::SortOrder order) |
| QString | statusTip(int column) const |
| QTreeWidgetItem * | takeChild(int index) |
| QList<QTreeWidgetItem *> | takeChildren() |
| QString | text(int column) const |
| int | textAlignment(int column) const |
| QString | toolTip(int column) const |
| QTreeWidget * | treeWidget() const |
| int | type() const |
| QString | whatsThis(int column) const |
| virtual void | write(QDataStream &out) const |
| virtual bool | operator<(const QTreeWidgetItem &other) const |
| QTreeWidgetItem & | operator=(const QTreeWidgetItem &other) |
Funciones protegidas
| void | emitDataChanged() |
No miembros relacionados
| QDataStream & | operator<<(QDataStream &out, const QTreeWidgetItem &item) |
| QDataStream & | operator>>(QDataStream &in, QTreeWidgetItem &item) |
Descripción detallada
Los elementos del widget de árbol se utilizan para contener filas de información para los widgets de árbol. Las filas suelen contener varias columnas de datos, cada una de las cuales puede contener una etiqueta de texto y un icono.
La clase QTreeWidgetItem es una clase de conveniencia que sustituye a la clase QListViewItem en Qt 3. Proporciona un elemento para su uso con la clase QTreeWidget.
Los ítems se construyen normalmente con un padre que es o bien un QTreeWidget (para ítems de nivel superior) o un QTreeWidgetItem (para ítems en niveles inferiores del árbol). Por ejemplo, el siguiente código construye un elemento de nivel superior para representar las ciudades del mundo, y añade una entrada para Oslo como elemento hijo:
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"));
Los elementos pueden añadirse en un orden determinado especificando el elemento al que siguen cuando se construyen:
QTreeWidgetItem *planets = new QTreeWidgetItem(treeWidget, cities); planets->setText(0, tr("Planets"));
Cada columna de un elemento puede tener su propio pincel de fondo que se establece con la función setBackground(). El pincel de fondo actual puede encontrarse con background(). La etiqueta de texto de cada columna puede representarse con su propia fuente y pincel. Estos se especifican con las funciones setFont() y setForeground(), y se leen con font() y foreground().
La principal diferencia entre los elementos de nivel superior y los de niveles inferiores del árbol es que un elemento de nivel superior no tiene parent(). Esta información se puede utilizar para diferenciar entre elementos, y es útil conocerla al insertar y eliminar elementos del árbol. Los hijos de un elemento pueden eliminarse con takeChild() e insertarse en un índice determinado de la lista de hijos con la función insertChild().
Por defecto, los elementos están habilitados, son seleccionables, comprobables y pueden ser el origen de una operación de arrastrar y soltar. Los indicadores de cada elemento pueden cambiarse llamando a setFlags() con el valor apropiado (véase Qt::ItemFlags). Los elementos seleccionables se pueden marcar y desmarcar con la función setCheckState(). La función checkState() correspondiente indica si el elemento está actualmente marcado.
Subclase
Al subclasificar QTreeWidgetItem para proporcionar elementos personalizados, es posible definir nuevos tipos para ellos, de forma que puedan distinguirse de los elementos estándar. Los constructores de las subclases que requieran esta característica necesitan llamar al constructor de la clase base con un valor de tipo nuevo igual o mayor que UserType.
Véase también QTreeWidget, QTreeWidgetItemIterator, Model/View Programming, QListWidgetItem, y QTableWidgetItem.
Documentación de tipos miembros
enum QTreeWidgetItem::ChildIndicatorPolicy
| Constante | Valor | Descripción |
|---|---|---|
QTreeWidgetItem::ShowIndicator | 0 | Los controles para expandir y contraer se mostrarán para este ítem incluso si no hay niños. |
QTreeWidgetItem::DontShowIndicator | 1 | Los controles para expandir y colapsar nunca se mostrarán aunque haya hijos. Si se fuerza la apertura del nodo, el usuario no podrá expandir o contraer el elemento. |
QTreeWidgetItem::DontShowIndicatorWhenChildless | 2 | Los controles para expandir y contraer se mostrarán si el elemento contiene hijos. |
enum QTreeWidgetItem::ItemType
Este enum describe los tipos que se utilizan para describir los elementos del widget de árbol.
| Constante | Valor | Descripción |
|---|---|---|
QTreeWidgetItem::Type | 0 | El tipo por defecto para los elementos del widget de árbol. |
QTreeWidgetItem::UserType | 1000 | El valor mínimo para tipos personalizados. Los valores por debajo de UserType están reservados por Qt. |
Puede definir nuevos tipos de usuario en las subclases de QTreeWidgetItem para asegurarse de que los elementos personalizados reciben un tratamiento especial; por ejemplo, cuando se ordenan los elementos.
Véase también type().
Documentación de funciones miembro
[explicit] QTreeWidgetItem::QTreeWidgetItem(int type = Type)
Construye un elemento de widget de árbol con la dirección type especificada. El elemento debe estar insertado en un widget de árbol.
Véase también type().
[explicit] QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, int type = Type)
Construye un elemento de widget de árbol del type especificado y lo añade a los elementos del parent dado.
Véase también type().
[explicit] QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, int type = Type)
Construye un elemento del widget de árbol y lo añade a la dirección parent.
Véase también type().
[explicit] QTreeWidgetItem::QTreeWidgetItem(const QStringList &strings, int type = Type)
Construye un elemento de widget de árbol con la dirección type especificada. El elemento debe insertarse en un widget de árbol. La lista dada de strings se establecerá como el texto del elemento para cada columna del elemento.
Véase también type().
QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, QTreeWidgetItem *preceding, int type = Type)
Construye un elemento de widget de árbol del type especificado y lo inserta en el parent dado después del elemento preceding.
Véase también type().
QTreeWidgetItem::QTreeWidgetItem(QTreeWidget *parent, const QStringList &strings, int type = Type)
Construye un elemento de widget de árbol del type especificado y lo añade a los elementos del parent dado. La lista dada de strings se establecerá como el texto del elemento para cada columna del elemento.
Véase también type().
QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, QTreeWidgetItem *preceding, int type = Type)
Construye un elemento widget de árbol del type especificado que se inserta en el parent después del elemento hijo preceding.
Véase también type().
QTreeWidgetItem::QTreeWidgetItem(QTreeWidgetItem *parent, const QStringList &strings, int type = Type)
Crea un elemento de widget de árbol y lo añade a la dirección parent. La lista dada de strings se establecerá como el texto del elemento para cada columna del elemento.
Véase también type().
QTreeWidgetItem::QTreeWidgetItem(const QTreeWidgetItem &other)
Construye una copia de other. Tenga en cuenta que type() y treeWidget() no se copian.
Esta función es útil cuando se reimplementa clone().
Véase también data() y flags().
[virtual noexcept] QTreeWidgetItem::~QTreeWidgetItem()
Destruye este elemento del widget de árbol.
El elemento se eliminará de QTreeWidgets al que se haya añadido. Esto hace que sea seguro eliminar un elemento en cualquier momento.
void QTreeWidgetItem::addChild(QTreeWidgetItem *child)
Añade el elemento child a la lista de hijos.
Véase también insertChild() y takeChild().
void QTreeWidgetItem::addChildren(const QList<QTreeWidgetItem *> &children)
Añade la lista dada de children al elemento.
Véase también insertChildren() y takeChildren().
QBrush QTreeWidgetItem::background(int column) const
Devuelve el pincel utilizado para representar el fondo de la página column especificada.
Véase también setBackground() y foreground().
Qt::CheckState QTreeWidgetItem::checkState(int column) const
Devuelve el estado de comprobación de la etiqueta en la dirección column.
Véase también setCheckState() y Qt::CheckState.
QTreeWidgetItem *QTreeWidgetItem::child(int index) const
Devuelve el elemento en el index dado en la lista de los hijos del elemento.
Véase también parent().
int QTreeWidgetItem::childCount() const
Devuelve el número de elementos hijos.
QTreeWidgetItem::ChildIndicatorPolicy QTreeWidgetItem::childIndicatorPolicy() const
Devuelve la política del indicador de elemento. Esta política decide cuándo se muestra el indicador de expansión/colapso de la rama del árbol.
Véase también setChildIndicatorPolicy().
[virtual] QTreeWidgetItem *QTreeWidgetItem::clone() const
Crea una copia en profundidad del elemento y de sus hijos.
int QTreeWidgetItem::columnCount() const
Devuelve el número de columnas del elemento.
[virtual] QVariant QTreeWidgetItem::data(int column, int role) const
Devuelve el valor de los elementos column y role.
Véase también setData().
[protected] void QTreeWidgetItem::emitDataChanged()
Hace que el modelo asociado a este elemento emita una señal dataChanged() para este elemento.
Normalmente sólo es necesario llamar a esta función si se ha subclasificado QTreeWidgetItem y reimplementado data() y/o setData().
Véase también setData().
Qt::ItemFlags QTreeWidgetItem::flags() const
Devuelve los indicadores utilizados para describir el elemento. Éstas determinan si el elemento se puede comprobar, editar y seleccionar.
El valor predeterminado de los indicadores es Qt::ItemIsSelectable | Qt::ItemIsUserCheckable | Qt::ItemIsEnabled | Qt::ItemIsDragEnabled | Qt::ItemIsDropEnabled.
Véase también setFlags().
QFont QTreeWidgetItem::font(int column) const
Devuelve la fuente utilizada para representar el texto en la dirección column especificada.
Véase también setFont().
QBrush QTreeWidgetItem::foreground(int column) const
Devuelve el pincel utilizado para representar el primer plano (por ejemplo, texto) de la página column especificada. Establecer un pincel construido por defecto permitirá a la vista utilizar el color por defecto del estilo.
Véase también setForeground() y background().
QIcon QTreeWidgetItem::icon(int column) const
Devuelve el icono que se muestra en la dirección column especificada.
Véase también setIcon() y iconSize.
int QTreeWidgetItem::indexOfChild(QTreeWidgetItem *child) const
Devuelve el índice del child dado en la lista de hijos del elemento.
void QTreeWidgetItem::insertChild(int index, QTreeWidgetItem *child)
Inserta el elemento child en index en la lista de hijos.
Si el hijo ya se ha insertado en otro lugar, no se volverá a insertar.
void QTreeWidgetItem::insertChildren(int index, const QList<QTreeWidgetItem *> &children)
Inserta la lista dada de children en la lista de los hijos del elemento en index.
Los hijos que ya se hayan insertado en otro lugar no se insertarán.
bool QTreeWidgetItem::isDisabled() const
Devuelve true si el elemento está desactivado; en caso contrario, devuelve false.
Véase también setFlags().
bool QTreeWidgetItem::isExpanded() const
Devuelve true si el elemento está expandido, en caso contrario devuelve false.
Véase también setExpanded().
bool QTreeWidgetItem::isFirstColumnSpanned() const
Devuelve true si el elemento abarca todas las columnas de una fila; en caso contrario, devuelve false.
Véase también setFirstColumnSpanned().
bool QTreeWidgetItem::isHidden() const
Devuelve true si el elemento está oculto, en caso contrario devuelve false.
Véase también setHidden().
bool QTreeWidgetItem::isSelected() const
Devuelve true si el elemento está seleccionado; en caso contrario, devuelve false.
Véase también setSelected().
QTreeWidgetItem *QTreeWidgetItem::parent() const
Devuelve el elemento padre.
Véase también child().
[virtual] void QTreeWidgetItem::read(QDataStream &in)
Lee el elemento del flujo in. Esto sólo lee datos en un único elemento.
Véase también write().
void QTreeWidgetItem::removeChild(QTreeWidgetItem *child)
Elimina el elemento indicado por child. El elemento eliminado no se borrará.
void QTreeWidgetItem::setBackground(int column, const QBrush &brush)
Establece el pincel de fondo de la etiqueta en el column dado al brush especificado. Establecer un pincel construido por defecto permitirá a la vista usar el color por defecto del estilo.
Nota: Si se usan Hojas de Estilo Qt en el mismo widget que setBackground(), las hojas de estilo tendrán preferencia si los ajustes entran en conflicto.
Véase también background() y setForeground().
void QTreeWidgetItem::setCheckState(int column, Qt::CheckState state)
Establece el elemento en el estado de comprobación column dado como state.
Véase también checkState().
void QTreeWidgetItem::setChildIndicatorPolicy(QTreeWidgetItem::ChildIndicatorPolicy policy)
Establece el indicador de elemento policy. Esta política decide cuándo se muestra el indicador de expansión/colapso de la rama del árbol. El valor por defecto es DontShowIndicatorWhenChildless.
Véase también childIndicatorPolicy().
[virtual] void QTreeWidgetItem::setData(int column, int role, const QVariant &value)
Establece el valor de column y role del elemento en value.
role describe el tipo de datos especificado por value, y está definido por el enum Qt::ItemDataRole.
Nota: La implementación por defecto considera que Qt::EditRole y Qt::DisplayRole se refieren a los mismos datos.
Véase también data().
void QTreeWidgetItem::setDisabled(bool disabled)
Desactiva el elemento si disabled es verdadero; en caso contrario, lo activa.
Véase también isDisabled() y setFlags().
void QTreeWidgetItem::setExpanded(bool expand)
Expande el ítem si expand es verdadero, de lo contrario lo colapsa.
Advertencia: El QTreeWidgetItem debe añadirse al QTreeWidget antes de llamar a esta función.
Véase también isExpanded().
void QTreeWidgetItem::setFirstColumnSpanned(bool span)
Establece la primera sección para que abarque todas las columnas si span es verdadero; en caso contrario, se muestran todas las secciones de elementos.
Véase también isFirstColumnSpanned().
void QTreeWidgetItem::setFlags(Qt::ItemFlags flags)
Establece los indicadores del elemento en la dirección flags. Esto determina si el elemento puede ser seleccionado o modificado. Esto se utiliza a menudo para desactivar un elemento.
Véase también flags().
void QTreeWidgetItem::setFont(int column, const QFont &font)
Establece el tipo de letra utilizado para mostrar el texto en el column dado al font dado.
Véase también font(), setText() y setForeground().
void QTreeWidgetItem::setForeground(int column, const QBrush &brush)
Establece el pincel de primer plano de la etiqueta en el column dado al brush especificado.
Véase también foreground() y setBackground().
void QTreeWidgetItem::setHidden(bool hide)
Oculta el elemento si hide es verdadero, en caso contrario lo muestra.
Nota: Una llamada a esta función no tiene efecto si el elemento no está actualmente en una vista. En particular, si se llama a setHidden(true) en un elemento y sólo después se añade a una vista, el resultado será un elemento visible.
Véase también isHidden().
void QTreeWidgetItem::setIcon(int column, const QIcon &icon)
Establece el icono que se mostrará en el column dado a icon.
Véase también icon(), setText() y iconSize.
void QTreeWidgetItem::setSelected(bool select)
Establece el estado seleccionado del elemento en select.
Véase también isSelected().
void QTreeWidgetItem::setSizeHint(int column, const QSize &size)
Establece el tamaño del elemento del árbol en column como size. Si no se establece ninguna indicación de tamaño o size no es válido, el delegado del elemento calculará la indicación de tamaño basándose en los datos del elemento.
Véase también sizeHint().
void QTreeWidgetItem::setStatusTip(int column, const QString &statusTip)
Establece la punta de estado para el column dado al statusTip dado. QTreeWidget el seguimiento del ratón necesita estar habilitado para que esta característica funcione.
Véase también statusTip(), setToolTip(), y setWhatsThis().
void QTreeWidgetItem::setText(int column, const QString &text)
Establece el texto que se mostrará en el column dado en el text dado.
Véase también text(), setFont() y setForeground().
[since 6.4] void QTreeWidgetItem::setTextAlignment(int column, Qt::Alignment alignment)
Ajusta la alineación del texto de la etiqueta en la dirección column a la dirección alignment especificada.
Esta función se introdujo en Qt 6.4.
Véase también textAlignment().
void QTreeWidgetItem::setToolTip(int column, const QString &toolTip)
Establece la información sobre herramientas de column en toolTip.
Véase también toolTip(), setStatusTip() y setWhatsThis().
void QTreeWidgetItem::setWhatsThis(int column, const QString &whatsThis)
Establece la ayuda "¿Qué es esto?" para el column dado en whatsThis.
Véase también whatsThis(), setStatusTip() y setToolTip().
QSize QTreeWidgetItem::sizeHint(int column) const
Devuelve la sugerencia de tamaño establecida para el elemento del árbol en el column dado (véase QSize).
Véase también setSizeHint().
void QTreeWidgetItem::sortChildren(int column, Qt::SortOrder order)
Ordena los hijos del ítem usando el order dado , por los valores en el column dado .
Nota: Esta función no hace nada si el elemento no está asociado a un QTreeWidget.
QString QTreeWidgetItem::statusTip(int column) const
Devuelve la punta de estado para el contenido del column dado .
Véase también setStatusTip().
QTreeWidgetItem *QTreeWidgetItem::takeChild(int index)
Elimina el elemento en index y lo devuelve, de lo contrario devuelve 0.
QList<QTreeWidgetItem *> QTreeWidgetItem::takeChildren()
Elimina la lista de hijos y la devuelve, en caso contrario devuelve una lista vacía.
QString QTreeWidgetItem::text(int column) const
Devuelve el texto en la dirección column especificada.
Véase también setText().
int QTreeWidgetItem::textAlignment(int column) const
Devuelve la alineación del texto de la etiqueta en la dirección column.
Nota: Esta función devuelve un int por razones históricas. Será corregida para devolver Qt::Alignment en Qt 7.
Véase también setTextAlignment() y Qt::Alignment.
QString QTreeWidgetItem::toolTip(int column) const
Devuelve la punta de la herramienta para el column dado.
Véase también setToolTip().
QTreeWidget *QTreeWidgetItem::treeWidget() const
Devuelve el widget de árbol que contiene el elemento.
int QTreeWidgetItem::type() const
Devuelve el tipo pasado al constructor QTreeWidgetItem.
QString QTreeWidgetItem::whatsThis(int column) const
Devuelve la ayuda "¿Qué es esto?" para el contenido de la dirección column.
Véase también setWhatsThis().
[virtual] void QTreeWidgetItem::write(QDataStream &out) const
Escribe el elemento en el flujo out. Esto sólo escribe datos de un único elemento.
Véase también read().
[virtual] bool QTreeWidgetItem::operator<(const QTreeWidgetItem &other) const
Devuelve true si el texto del elemento es menor que el texto del elemento other, en caso contrario devuelve false.
QTreeWidgetItem &QTreeWidgetItem::operator=(const QTreeWidgetItem &other)
Asigna los datos y banderas de other a este elemento. Tenga en cuenta que type() y treeWidget() no se copian.
Esta función es útil cuando se reimplementa clone().
No miembros relacionados
QDataStream &operator<<(QDataStream &out, const QTreeWidgetItem &item)
Escribe el elemento del widget de árbol item en el flujo out.
Este operador utiliza QTreeWidgetItem::write().
Véase también Serializar tipos de datos Qt.
QDataStream &operator>>(QDataStream &in, QTreeWidgetItem &item)
Lee un elemento del widget de árbol del flujo in a item.
Este operador utiliza QTreeWidgetItem::read().
Véase también Serializar tipos de datos Qt.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.