En esta página

QStandardItem Class

La clase `QStandardItem` proporciona un elemento para su uso con la clase ` QStandardItemModel `. Más información...

Encabezado: #include <QStandardItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Tipos públicos

enum ItemType { Type, UserType }

Funciones públicas

QStandardItem()
QStandardItem(const QString &text)
QStandardItem(const QIcon &icon, const QString &text)
QStandardItem(int rows, int columns = 1)
virtual ~QStandardItem()
QString accessibleDescription() const
QString accessibleText() const
void appendColumn(const QList<QStandardItem *> &items)
void appendRow(const QList<QStandardItem *> &items)
void appendRow(QStandardItem *item)
void appendRows(const QList<QStandardItem *> &items)
QBrush background() const
Qt::CheckState checkState() const
QStandardItem *child(int row, int column = 0) const
void clearData()
virtual QStandardItem *clone() const
int column() const
int columnCount() const
virtual QVariant data(int role = Qt::UserRole + 1) const
Qt::ItemFlags flags() const
QFont font() const
QBrush foreground() const
bool hasChildren() const
QIcon icon() const
QModelIndex index() const
void insertColumn(int column, const QList<QStandardItem *> &items)
void insertColumns(int column, int count)
void insertRow(int row, const QList<QStandardItem *> &items)
void insertRow(int row, QStandardItem *item)
void insertRows(int row, const QList<QStandardItem *> &items)
void insertRows(int row, int count)
bool isAutoTristate() const
bool isCheckable() const
bool isDragEnabled() const
bool isDropEnabled() const
bool isEditable() const
bool isEnabled() const
bool isSelectable() const
bool isUserTristate() const
QStandardItemModel *model() const
(since 6.0) virtual void multiData(QModelRoleDataSpan roleDataSpan) const
QStandardItem *parent() const
virtual void read(QDataStream &in)
void removeColumn(int column)
void removeColumns(int column, int count)
void removeRow(int row)
void removeRows(int row, int count)
int row() const
int rowCount() const
void setAccessibleDescription(const QString &accessibleDescription)
void setAccessibleText(const QString &accessibleText)
void setAutoTristate(bool tristate)
void setBackground(const QBrush &brush)
void setCheckState(Qt::CheckState state)
void setCheckable(bool checkable)
void setChild(int row, int column, QStandardItem *item)
void setChild(int row, QStandardItem *item)
void setColumnCount(int columns)
virtual void setData(const QVariant &value, int role = Qt::UserRole + 1)
void setDragEnabled(bool dragEnabled)
void setDropEnabled(bool dropEnabled)
void setEditable(bool editable)
void setEnabled(bool enabled)
void setFlags(Qt::ItemFlags flags)
void setFont(const QFont &font)
void setForeground(const QBrush &brush)
void setIcon(const QIcon &icon)
void setRowCount(int rows)
void setSelectable(bool selectable)
void setSizeHint(const QSize &size)
void setStatusTip(const QString &statusTip)
void setText(const QString &text)
void setTextAlignment(Qt::Alignment alignment)
void setToolTip(const QString &toolTip)
void setUserTristate(bool tristate)
void setWhatsThis(const QString &whatsThis)
QSize sizeHint() const
void sortChildren(int column, Qt::SortOrder order = Qt::AscendingOrder)
QString statusTip() const
QStandardItem *takeChild(int row, int column = 0)
QList<QStandardItem *> takeColumn(int column)
QList<QStandardItem *> takeRow(int row)
QString text() const
Qt::Alignment textAlignment() const
QString toolTip() const
virtual int type() const
QString whatsThis() const
virtual void write(QDataStream &out) const
virtual bool operator<(const QStandardItem &other) const

Funciones protegidas

QStandardItem(const QStandardItem &other)
void emitDataChanged()
QStandardItem &operator=(const QStandardItem &other)
QDataStream &operator<<(QDataStream &out, const QStandardItem &item)
QDataStream &operator>>(QDataStream &in, QStandardItem &item)

Descripción detallada

Los elementos suelen contener texto, iconos o casillas de selección.

Cada elemento puede tener su propio pincel de fondo, que se establece con la función « setBackground()». El pincel de fondo actual se puede obtener con « background()». La etiqueta de texto de cada elemento se puede representar con su propia fuente y pincel. Estos se especifican con las funciones « setFont()» y « setForeground()», y se leen con « font()» y « foreground()».

Por defecto, los elementos están habilitados, son editables, seleccionables y marcables, y pueden utilizarse tanto como origen de una operación de arrastrar y soltar como destino de dicha operación. Los indicadores de cada elemento pueden modificarse llamando a setFlags(). Los elementos marcables se pueden marcar y desmarcar con la función setCheckState(). La función correspondiente checkState() indica si el elemento está marcado actualmente.

Se pueden almacenar datos específicos de la aplicación en un elemento llamando a ` setData()`.

Cada elemento puede tener una tabla bidimensional de elementos secundarios. Esto permite crear jerarquías de elementos. La jerarquía típica es el árbol; en ese caso, la tabla secundaria es una tabla con una sola columna (una lista).

Las dimensiones de la tabla de elementos secundarios se pueden establecer con ` setRowCount()` y ` setColumnCount()`. Los elementos se pueden colocar en la tabla de elementos secundarios con ` setChild()`. Se obtiene un puntero a un elemento secundario con child(). También se pueden insertar nuevas filas y columnas de elementos secundarios con insertRow() y insertColumn(), o añadirse al final con appendRow() y appendColumn(). Al utilizar las funciones de inserción y adición, las dimensiones de la tabla secundaria aumentarán según sea necesario.

Una fila de elementos secundarios ya existente se puede eliminar con removeRow() o takeRow(); del mismo modo, una columna se puede eliminar con removeColumn() o takeColumn().

Los elementos secundarios de un elemento se pueden ordenar llamando a sortChildren().

Subclasificación

Al crear subclases de `QStandardItem` para proporcionar elementos personalizados, es posible definir nuevos tipos para ellos, de modo que se puedan distinguir de la clase base. La función ` type()` debe reimplementarse para que devuelva un valor de tipo nuevo igual o mayor que ` UserType`.

Reimplementa data() y setData() si deseas realizar un manejo personalizado de las consultas de datos y/o controlar cómo se representan los datos de un elemento.

Reimplementa ` clone()` si deseas que ` QStandardItemModel ` pueda crear instancias de tu clase de elemento personalizada bajo demanda (véase ` QStandardItemModel::setItemPrototype()`).

Reimplementa ` read()` y ` write()` si deseas controlar cómo se representan los elementos en su forma serializada.

Reimplementa operator<() si deseas controlar la semántica de la comparación de elementos. operator<() determina el orden de clasificación al ordenar elementos con sortChildren() o con QStandardItemModel::sort().

Véase también QStandardItemModel, Clases de conveniencia de la vista de elementos y Programación de modelo/vista.

Documentación sobre tipos de miembros

enum QStandardItem::ItemType

Esta enumeración describe los tipos que se utilizan para definir los elementos estándar.

ConstanteValorDescripción
QStandardItem::Type0El tipo predeterminado para los elementos estándar.
QStandardItem::UserType1000El valor mínimo para los tipos personalizados. Los valores inferiores a UserType están reservados por Qt.

Puedes definir nuevos tipos de usuario en subclases de ` QStandardItem ` para garantizar que los elementos personalizados reciban un tratamiento especial; por ejemplo, a la hora de ordenar los elementos.

Véase también type().

Documentación de las funciones miembro

QStandardItem::QStandardItem()

Crea un elemento.

[explicit] QStandardItem::QStandardItem(const QString &text)

Crea un elemento con el ` text` indicado.

QStandardItem::QStandardItem(const QIcon &icon, const QString &text)

Crea un elemento con los valores indicados en « icon » y « text ».

[explicit] QStandardItem::QStandardItem(int rows, int columns = 1)

Crea un elemento con rows filas y columns columnas de elementos secundarios.

[protected] QStandardItem::QStandardItem(const QStandardItem &other)

Crea una copia de ` other`. Ten en cuenta que ` model()` no se copia.

Esta función resulta útil a la hora de reimplementar clone().

[virtual noexcept] QStandardItem::~QStandardItem()

Destruye el elemento. Esto hace que los elementos secundarios de dicho elemento también se destruyan.

QString QStandardItem::accessibleDescription() const

Devuelve la descripción accesible del elemento.

La descripción accesible es utilizada por las tecnologías de apoyo (es decir, para usuarios que no pueden utilizar los medios convencionales de interacción).

Véase también setAccessibleDescription() y accessibleText().

QString QStandardItem::accessibleText() const

Devuelve el texto accesible del elemento.

El texto accesible es utilizado por las tecnologías de asistencia (es decir, para usuarios que no pueden utilizar los medios convencionales de interacción).

Véase también setAccessibleText() y accessibleDescription().

void QStandardItem::appendColumn(const QList<QStandardItem *> &items)

Añade una columna que contiene « items ». Si es necesario, el número de filas se incrementa hasta alcanzar el tamaño de « items ».

Véase también insertColumn().

void QStandardItem::appendRow(const QList<QStandardItem *> &items)

Añade una fila que contiene items. Si es necesario, el número de columnas se amplía hasta alcanzar el tamaño de items.

Véase también insertRow().

void QStandardItem::appendRow(QStandardItem *item)

Añade una fila que contiene « item ».

Al crear una lista o un árbol que solo tenga una columna, esta función ofrece una forma cómoda de añadir un único elemento nuevo.

Se trata de una función sobrecargada.

void QStandardItem::appendRows(const QList<QStandardItem *> &items)

Añade filas que contengan items. El número de columnas no variará.

Véase también insertRow().

QBrush QStandardItem::background() const

Devuelve el pincel utilizado para dibujar el fondo del elemento.

Véase también foreground() y setBackground().

Qt::CheckState QStandardItem::checkState() const

Devuelve si el elemento está marcado.

Véase también setCheckState() y isCheckable().

QStandardItem *QStandardItem::child(int row, int column = 0) const

Devuelve el elemento secundario en (row, column) si se ha establecido alguno; en caso contrario, devuelve nullptr.

Véanse también setChild(), takeChild() y parent().

void QStandardItem::clearData()

Elimina todos los datos de todos los roles configurados anteriormente.

Véase también data() y setData().

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

Devuelve una copia de este elemento. Los elementos secundarios del elemento no se copian.

Al crear una subclase de ` QStandardItem`, puedes reimplementar esta función para proporcionar a ` QStandardItemModel ` una fábrica que pueda utilizar para crear nuevos elementos bajo demanda.

Véase también ` QStandardItemModel::setItemPrototype()` y ` operator=()`.

int QStandardItem::column() const

Devuelve la columna en la que se encuentra el elemento en la tabla hija de su elemento padre, o -1 si el elemento no tiene elemento padre.

Véase también row() y parent().

int QStandardItem::columnCount() const

Devuelve el número de columnas de elementos secundarios que tiene el elemento.

Véase también setColumnCount() y rowCount().

[virtual] QVariant QStandardItem::data(int role = Qt::UserRole + 1) const

Devuelve los datos del elemento correspondientes a la « role » indicada, o un « QVariant » no válido si no hay datos para ese rol.

Si reimplementas esta función, tu reimplementación debe llamar a la implementación base para los roles que no gestionas; de lo contrario, la obtención de indicadores, por ejemplo, llamando a flags(), isCheckable(), isEditable() etc., no funcionará.

Nota: La implementación por defecto trata Qt::EditRole y Qt::DisplayRole como si hicieran referencia a los mismos datos.

Véase también setData().

[protected] void QStandardItem::emitDataChanged()

Hace que el modelo asociado a este elemento emita una señal « dataChanged()» para este elemento.

Normalmente, solo es necesario llamar a esta función si se ha creado una subclase de ` QStandardItem ` y se han reimplementado ` data()` y/o ` setData()`.

Véase también setData().

Qt::ItemFlags QStandardItem::flags() const

Devuelve los indicadores del elemento.

Los indicadores del elemento determinan cómo puede interactuar el usuario con él.

Por defecto, los elementos están habilitados, son editables, seleccionables y marcables, y pueden utilizarse tanto como origen de una operación de arrastrar y soltar como destino de dicha operación.

Véase también setFlags().

QFont QStandardItem::font() const

Devuelve la fuente utilizada para mostrar el texto del elemento.

Véase también setFont().

QBrush QStandardItem::foreground() const

Devuelve el pincel utilizado para renderizar el primer plano del elemento (por ejemplo, el texto).

Véase también setForeground() y background().

bool QStandardItem::hasChildren() const

Devuelve ` true ` si este elemento tiene hijos; en caso contrario, devuelve ` false`.

Véase también rowCount(), columnCount() y child().

QIcon QStandardItem::icon() const

Devuelve el icono del elemento.

Véase también setIcon() y iconSize.

QModelIndex QStandardItem::index() const

Devuelve el objeto ` QModelIndex ` asociado a este elemento.

Cuando necesites invocar la funcionalidad de un elemento en una API basada en « QModelIndex » (por ejemplo, QAbstractItemView), puedes llamar a esta función para obtener un índice que corresponda a la ubicación del elemento en el modelo.

Si el elemento no está asociado a ningún modelo, se devuelve un ` QModelIndex ` no válido.

Véase también model() y QStandardItemModel::itemFromIndex().

void QStandardItem::insertColumn(int column, const QList<QStandardItem *> &items)

Inserta una columna en column que contenga items. Si es necesario, se aumenta el número de filas hasta alcanzar el tamaño de items.

Véase también insertColumns() y insertRow().

void QStandardItem::insertColumns(int column, int count)

Inserta count columnas de elementos secundarios en la columna column.

Véase también insertColumn() y insertRows().

void QStandardItem::insertRow(int row, const QList<QStandardItem *> &items)

Inserta una fila en row que contiene items. Si es necesario, se aumenta el número de columnas hasta alcanzar el tamaño de items.

Véase también insertRows() y insertColumn().

void QStandardItem::insertRow(int row, QStandardItem *item)

Inserta una fila en « row » que contenga « item ».

Al crear una lista o un árbol que solo tenga una columna, esta función ofrece una forma cómoda de insertar un único elemento nuevo.

Esta es una función sobrecargada.

void QStandardItem::insertRows(int row, const QList<QStandardItem *> &items)

Inserta « items » en « row ». El número de columnas no se modificará.

Véase también insertRow() y insertColumn().

void QStandardItem::insertRows(int row, int count)

Inserta count filas de elementos secundarios en la fila row.

Véase también insertRow() y insertColumns().

bool QStandardItem::isAutoTristate() const

Devuelve si el elemento es de tres estados y está controlado por QTreeWidget.

El valor por defecto es «false».

Véase también setAutoTristate(), isCheckable() y checkState().

bool QStandardItem::isCheckable() const

Indica si el elemento puede ser marcado por el usuario.

El valor por defecto es «false».

Véase también setCheckable(), checkState(), isUserTristate() y isAutoTristate().

bool QStandardItem::isDragEnabled() const

Indica si el elemento permite el arrastre. Un elemento que permite el arrastre puede ser arrastrado por el usuario.

El valor por defecto es «true».

Ten en cuenta que, para que el arrastre funcione, debe estar habilitado en la vista; consulta QAbstractItemView::dragEnabled.

Véase también setDragEnabled(), isDropEnabled() y flags().

bool QStandardItem::isDropEnabled() const

Indica si se puede soltar el objeto. Cuando se puede soltar un objeto, este puede utilizarse como destino de arrastre.

El valor por defecto es «true».

Véase también setDropEnabled(), isDragEnabled() y flags().

bool QStandardItem::isEditable() const

Indica si el usuario puede editar el elemento.

Cuando un elemento es editable (y está habilitado), el usuario puede editarlo activando uno de los desencadenantes de edición de la vista; véase QAbstractItemView::editTriggers.

El valor por defecto es «true».

Véase también setEditable() y flags().

bool QStandardItem::isEnabled() const

Devuelve si el elemento está habilitado.

Cuando un elemento está habilitado, el usuario puede interactuar con él. Los posibles tipos de interacción vienen determinados por los demás indicadores del elemento, como isEditable() y isSelectable().

El valor por defecto es true.

Véanse también setEnabled() y flags().

bool QStandardItem::isSelectable() const

Indica si el usuario puede seleccionar el elemento.

El valor por defecto es «true».

Véase también setSelectable() y flags().

bool QStandardItem::isUserTristate() const

Indica si el elemento es de tres estados; es decir, si se puede marcar con tres estados distintos y el usuario puede alternar entre los tres.

El valor por defecto es false.

Véase también setUserTristate(), isCheckable() y checkState().

QStandardItemModel *QStandardItem::model() const

Devuelve el objeto ` QStandardItemModel ` al que pertenece este elemento.

Si el elemento no es un elemento secundario de otro elemento que pertenezca al modelo, esta función devuelve ` nullptr`.

Véase también index().

[virtual, since 6.0] void QStandardItem::multiData(QModelRoleDataSpan roleDataSpan) const

Rellena el span « roleDataSpan » con los datos de este elemento.

La implementación por defecto simplemente llama a ` data()` para cada rol del span.

Esta función se introdujo en Qt 6.0.

Véase también ` data()`.

QStandardItem *QStandardItem::parent() const

Devuelve el elemento padre del elemento, o ` nullptr ` si el elemento no tiene padre.

Nota: Para los elementos de nivel superior, la función `parent()` devuelve ` nullptr`. Para obtener el elemento padre de un elemento de nivel superior, utiliza en su lugar ` QStandardItemModel::invisibleRootItem()`.

Véase también child() y QStandardItemModel::invisibleRootItem().

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

Lee el elemento del flujo in. Solo se leen los datos y los indicadores del elemento, no los elementos secundarios.

Véase también write().

void QStandardItem::removeColumn(int column)

Elimina el column especificado. Se borran los elementos que había en la columna.

Véase también takeColumn(), removeColumns() y removeRow().

void QStandardItem::removeColumns(int column, int count)

Elimina las columnas « count » en la columna « column ». Se eliminan los elementos que había en esas columnas.

Véase también removeColumn() y removeRows().

void QStandardItem::removeRow(int row)

Elimina el row indicado. Se borran los elementos que había en la fila.

Véase también takeRow(), removeRows() y removeColumn().

void QStandardItem::removeRows(int row, int count)

Elimina las filas « count » en la fila « row ». Se eliminan los elementos que había en esas filas.

Véase también removeRow() y removeColumn().

int QStandardItem::row() const

Devuelve la fila en la que se encuentra el elemento en la tabla secundaria de su elemento principal, o -1 si el elemento no tiene elemento principal.

Véase también column() y parent().

int QStandardItem::rowCount() const

Devuelve el número de filas de elementos secundarios que tiene el elemento.

Véase también setRowCount() y columnCount().

void QStandardItem::setAccessibleDescription(const QString &accessibleDescription)

Establece la descripción accesible del elemento en la cadena especificada por ` accessibleDescription`.

La descripción accesible es utilizada por las tecnologías de apoyo (es decir, para usuarios que no pueden utilizar los medios convencionales de interacción).

Véase también accessibleDescription() y setAccessibleText().

void QStandardItem::setAccessibleText(const QString &accessibleText)

Establece el texto accesible del elemento en la cadena especificada por ` accessibleText`.

El texto accesible es utilizado por las tecnologías de asistencia (es decir, para usuarios que no pueden utilizar los medios de interacción convencionales).

Véanse también accessibleText() y setAccessibleDescription().

void QStandardItem::setAutoTristate(bool tristate)

Determina que el elemento es de tres estados y está controlado por QTreeWidget si tristate es true. Esto permite la gestión automática del estado de los elementos principales en QTreeWidget (marcado si todos los elementos secundarios están marcados, desmarcado si todos los elementos secundarios están desmarcados, o parcialmente marcado si solo algunos elementos secundarios están marcados).

Véase también isAutoTristate(), setCheckable() y setCheckState().

void QStandardItem::setBackground(const QBrush &brush)

Establece el pincel de fondo del elemento en el brush especificado.

Véase también background() y setForeground().

void QStandardItem::setCheckState(Qt::CheckState state)

Establece el estado de selección del elemento en « state ».

Véase también checkState() y setCheckable().

void QStandardItem::setCheckable(bool checkable)

Establece si el elemento puede ser marcado por el usuario. Si « checkable » es verdadero, el usuario puede marcar el elemento; en caso contrario, no puede hacerlo.

El delegado del elemento mostrará un elemento marcable con una casilla de selección junto al texto del elemento.

Véase también ` isCheckable()`, ` setCheckState()`, ` setUserTristate()` y ` setAutoTristate()`.

void QStandardItem::setChild(int row, int column, QStandardItem *item)

Establece el elemento secundario situado en (row, column) como item. Este elemento (el elemento principal) asume la propiedad de item. Si es necesario, se aumentan el número de filas y el número de columnas para dar cabida al elemento.

Nota: Al pasar nullptr como item, se elimina el elemento.

Véase también child().

void QStandardItem::setChild(int row, QStandardItem *item)

Establece el elemento secundario de row en item.

Esta es una función sobrecargada.

void QStandardItem::setColumnCount(int columns)

Establece el número de columnas de elementos secundarios en columns. Si este valor es inferior a columnCount(), se descartan los datos de las columnas no deseadas.

Véanse también columnCount() y setRowCount().

[virtual] void QStandardItem::setData(const QVariant &value, int role = Qt::UserRole + 1)

Establece los datos del elemento para el ` role ` dado en el ` value` especificado.

Si creas una subclase de ` QStandardItem ` y reimplementas esta función, tu reimplementación debería:

  • llamar a ` emitDataChanged()` si no se llama a la implementación base de `setData()`. Esto garantizará que, por ejemplo, las vistas que utilicen el modelo sean notificadas de los cambios
  • llamar a la implementación base para los roles que no gestiones; de lo contrario, establecer indicadores, por ejemplo, llamando a setFlags(), setCheckable(), setEditable() etc., no funcionará.

Nota: La implementación por defecto considera que Qt::EditRole y Qt::DisplayRole hacen referencia a los mismos datos.

Véase también Qt::ItemDataRole, data() y setFlags().

void QStandardItem::setDragEnabled(bool dragEnabled)

Establece si se permite arrastrar el elemento. Si dragEnabled es «true», el usuario puede arrastrar el elemento; en caso contrario, no puede hacerlo.

Ten en cuenta que también debes asegurarte de que el arrastre de elementos esté habilitado en la vista; consulta QAbstractItemView::dragEnabled.

Véanse también isDragEnabled(), setDropEnabled() y setFlags().

void QStandardItem::setDropEnabled(bool dropEnabled)

Establece si se permite soltar elementos en el elemento. Si dropEnabled es «true», el elemento puede utilizarse como destino para soltar elementos; en caso contrario, no.

Ten en cuenta que también debes asegurarte de que las acciones de soltar estén habilitadas en la vista; consulta QWidget::acceptDrops(); y de que el modelo admita las acciones de soltar deseadas; consulta QAbstractItemModel::supportedDropActions().

Véase también isDropEnabled(), setDragEnabled() y setFlags().

void QStandardItem::setEditable(bool editable)

Establece si el elemento es editable. Si editable es verdadero, el usuario puede editar el elemento; en caso contrario, no puede hacerlo.

La forma en que el usuario puede editar los elementos de una vista viene determinada por los desencadenantes de edición de la vista; véase QAbstractItemView::editTriggers.

Véase también isEditable() y setFlags().

void QStandardItem::setEnabled(bool enabled)

Establece si el elemento está habilitado. Si « enabled » es «true», el elemento está habilitado, lo que significa que el usuario puede interactuar con él; si « enabled » es «false», el usuario no puede interactuar con el elemento.

Este indicador tiene prioridad sobre los demás indicadores del elemento; por ejemplo, si un elemento no está habilitado, el usuario no puede seleccionarlo, aunque se haya establecido el indicador « Qt::ItemIsSelectable ».

Véanse también isEnabled(), Qt::ItemIsEnabled y setFlags().

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

Establece los indicadores del elemento en « flags ».

Los indicadores del elemento determinan cómo puede interactuar el usuario con él. Esto se suele utilizar para desactivar un elemento.

Véase también flags() y setData().

void QStandardItem::setFont(const QFont &font)

Establece la fuente utilizada para mostrar el texto del elemento en la fuente especificada font.

Véanse también font(), setText() y setForeground().

void QStandardItem::setForeground(const QBrush &brush)

Establece el pincel utilizado para mostrar el primer plano del elemento (por ejemplo, el texto) en el valor especificado brush.

Véase también foreground(), setBackground() y setFont().

void QStandardItem::setIcon(const QIcon &icon)

Establece el icono del elemento en el especificado en icon.

Véase también icon().

void QStandardItem::setRowCount(int rows)

Establece el número de filas de elementos secundarios en rows. Si este valor es inferior a rowCount(), se descartan los datos de las filas no deseadas.

Véase también ` rowCount()` y ` setColumnCount()`.

void QStandardItem::setSelectable(bool selectable)

Establece si el elemento es seleccionable. Si selectable es «true», el usuario puede seleccionar el elemento; en caso contrario, no puede seleccionarlo.

Puedes controlar el comportamiento y el modo de selección modificando las propiedades de vista correspondientes; consulta QAbstractItemView::selectionMode y QAbstractItemView::selectionBehavior.

Véase también isSelectable() y setFlags().

void QStandardItem::setSizeHint(const QSize &size)

Establece la indicación de tamaño del elemento en size. Si no se establece ninguna indicación de tamaño, el delegado del elemento calculará dicha indicación basándose en los datos del elemento.

Véase también sizeHint().

void QStandardItem::setStatusTip(const QString &statusTip)

Establece la descripción de estado del elemento en la cadena especificada en statusTip.

Véase también statusTip(), setToolTip() y setWhatsThis().

void QStandardItem::setText(const QString &text)

Establece el texto del elemento en el text especificado.

Véase también text(), setFont() y setForeground().

void QStandardItem::setTextAlignment(Qt::Alignment alignment)

Establece la alineación del texto del elemento según el valor especificado en ` alignment `.

Véase también textAlignment().

void QStandardItem::setToolTip(const QString &toolTip)

Establece la descripción emergente del elemento con la cadena especificada en toolTip.

Véase también toolTip(), setStatusTip() y setWhatsThis().

void QStandardItem::setUserTristate(bool tristate)

Establece si el elemento es de tres estados y está controlado por el usuario. Si « tristate » es «true», el usuario puede alternar entre tres estados distintos; en caso contrario, el elemento es marcable con dos estados. (Ten en cuenta que esto también requiere que el elemento sea marcable; véase « isCheckable » ().)

Véanse también isUserTristate(), setCheckable() y setCheckState().

void QStandardItem::setWhatsThis(const QString &whatsThis)

Establece la ayuda «¿Qué es esto?» del elemento en la cadena especificada en whatsThis.

Véase también whatsThis(), setStatusTip() y setToolTip().

QSize QStandardItem::sizeHint() const

Devuelve la indicación de tamaño establecida para el elemento o un objeto ` QSize ` no válido si no se ha establecido ninguna indicación de tamaño.

Si no se ha establecido ninguna sugerencia de tamaño, el delegado del elemento calculará la sugerencia de tamaño basándose en los datos del elemento.

Véase también setSizeHint().

void QStandardItem::sortChildren(int column, Qt::SortOrder order = Qt::AscendingOrder)

Ordena los elementos secundarios del elemento utilizando el ` order` proporcionado, según los valores del ` column` proporcionado.

Nota: Esta función es recursiva, por lo que ordena los hijos del elemento, sus nietos, etc.

Véase también operator<().

QString QStandardItem::statusTip() const

Devuelve la descripción del estado del elemento.

Véase también setStatusTip(), toolTip() y whatsThis().

QStandardItem *QStandardItem::takeChild(int row, int column = 0)

Elimina el elemento secundario situado en (row, column) sin borrarlo, y devuelve un puntero al elemento. Si no había ningún elemento secundario en la ubicación indicada, esta función devuelve nullptr.

Ten en cuenta que esta función, a diferencia de takeRow() y takeColumn(), no afecta a las dimensiones de la tabla secundaria.

Véanse también child(), takeRow() y takeColumn().

QList<QStandardItem *> QStandardItem::takeColumn(int column)

Elimina column sin borrar los elementos de la columna y devuelve una lista de punteros a los elementos eliminados. En el caso de los elementos de la columna que no se hayan establecido, los punteros correspondientes de la lista serán nullptr.

Véanse también removeColumn(), insertColumn() y takeRow().

QList<QStandardItem *> QStandardItem::takeRow(int row)

Elimina row sin borrar los elementos de la fila y devuelve una lista de punteros a los elementos eliminados. En el caso de los elementos de la fila que no se hayan establecido, los punteros correspondientes de la lista serán nullptr.

Véase también removeRow(), insertRow() y takeColumn().

QString QStandardItem::text() const

Devuelve el texto del elemento. Se trata del texto que se muestra al usuario en una vista.

Véase también setText().

Qt::Alignment QStandardItem::textAlignment() const

Devuelve la alineación del texto del elemento.

Véase también setTextAlignment().

QString QStandardItem::toolTip() const

Devuelve la descripción emergente del elemento.

Véase también setToolTip(), statusTip() y whatsThis().

[virtual] int QStandardItem::type() const

Devuelve el tipo de este elemento. El tipo se utiliza para distinguir los elementos personalizados de la clase base. Al crear una subclase de ` QStandardItem`, debes reimplementar esta función y devolver un nuevo valor mayor o igual que ` UserType`.

Véase también QStandardItem::Type.

QString QStandardItem::whatsThis() const

Devuelve la ayuda «¿Qué es esto?» del elemento.

Véase también setWhatsThis(), toolTip() y statusTip().

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

Escribe el elemento en el flujo out. Solo se escriben los datos y los indicadores del elemento, no los elementos secundarios.

Véase también read().

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

Devuelve « true » si este elemento es menor que « other »; en caso contrario, devuelve « false ».

La implementación por defecto utiliza los datos de la función de ordenación del elemento (véase QStandardItemModel::sortRole) para realizar la comparación si el elemento pertenece a un modelo; en caso contrario, se utilizan los datos de la función de ordenación Qt::DisplayRole del elemento (text()) para realizar la comparación.

sortChildren() y QStandardItemModel::sort() utilizan esta función al ordenar elementos. Si deseas una ordenación personalizada, puedes crear una subclase de QStandardItem y reimplementar esta función.

[protected] QStandardItem &QStandardItem::operator=(const QStandardItem &other)

Asigna los datos y los indicadores de ` other` a este elemento. Ten en cuenta que ` type()` y ` model()` no se copian.

Esta función resulta útil a la hora de reimplementar clone().

Elementos no miembros relacionados

QDataStream &operator<<(QDataStream &out, const QStandardItem &item)

Escribe el QStandardItem item para transmitir out.

Este operador utiliza QStandardItem::write().

Véase también «Serialización detipos de datos de Qt».

QDataStream &operator>>(QDataStream &in, QStandardItem &item)

Lee un objeto ` QStandardItem ` del flujo ` in ` y lo asigna a ` item`.

Este operador utiliza QStandardItem::read().

Véase también «Serialización detipos de datos de 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.