QStandardItem Class

Documentación de funciones miembro

QStandardItem::QStandardItem()

Construye un elemento.

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

Construye un elemento con la dirección text.

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

Construye un elemento con los datos icon y text.

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

Construye un ítem con rows filas y columns columnas de ítems hijos.

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

Construye una copia de other. Tenga en cuenta que model() no se copia.

Esta función es útil cuando se reimplementa clone().

[virtual noexcept] QStandardItem::~QStandardItem()

Destruye el elemento. Esto provoca que los elementos hijos también se destruyan.

QString QStandardItem::accessibleDescription() const

Devuelve la descripción accesible del elemento.

La descripción accesible la utilizan las tecnologías de asistencia (es decir, para usuarios que no pueden utilizar 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 lo utilizan las tecnologías de asistencia (es decir, para usuarios que no pueden utilizar 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 recuento de filas se incrementa hasta 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 recuento de columnas se incrementa hasta el tamaño de items.

Véase también insertRow().

void QStandardItem::appendRow(QStandardItem *item)

Añade una fila que contiene item.

Cuando se construye una lista o un árbol que sólo tiene una columna, esta función proporciona una manera conveniente de añadir un solo elemento nuevo.

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

Añade las filas que contienen items. El recuento de columnas no cambiará.

Véase también insertRow().

QBrush QStandardItem::background() const

Devuelve el pincel utilizado para representar el fondo del elemento.

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

Qt::CheckState QStandardItem::checkState() const

Devuelve el estado comprobado del elemento.

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

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

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

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

void QStandardItem::clearData()

Elimina todos los datos de todos los roles establecidos previamente.

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

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

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

Cuando subclase QStandardItem, puede 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 donde se encuentra el elemento en la tabla hija de su padre, o -1 si el elemento no tiene padre.

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

int QStandardItem::columnCount() const

Devuelve el número de columnas de elementos hijo 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 para el role dado , o un QVariant inválido si no hay datos para el rol.

Si reimplementa esta función, su reimplementación debe llamar a la implementación base para los roles que no maneje, de lo contrario no funcionará la obtención de banderas, por ejemplo, llamando a flags(), isCheckable(), isEditable(), etc.

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 sólo es necesario llamar a esta función si se ha subclasificado QStandardItem y reimplementado data() y/o setData().

Véase también setData().

Qt::ItemFlags QStandardItem::flags() const

Devuelve los indicadores del elemento.

Los indicadores de elemento determinan cómo puede interactuar el usuario con el elemento.

Por defecto, los ítems están habilitados, son editables, seleccionables, comprobables, y pueden ser utilizados como origen de una operación de arrastrar y soltar y como destino de una operación de soltar.

Véase también setFlags().

QFont QStandardItem::font() const

Devuelve la fuente utilizada para representar el texto del elemento.

Véase también setFont().

QBrush QStandardItem::foreground() const

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

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

bool QStandardItem::hasChildren() const

Devuelve true si este elemento tiene algún hijo; 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 QModelIndex asociado a este elemento.

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

Si el elemento no está asociado a un 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 contiene items. Si es necesario, el recuento de filas se incrementa hasta el tamaño de items.

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

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

Inserta count columnas de elementos hijos 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, el recuento de columnas se incrementa hasta 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 contiene item.

Cuando se construye una lista o un árbol que sólo tiene una columna, esta función proporciona una manera conveniente de insertar un solo elemento nuevo.

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

Inserta items en row. El recuento de columnas no se modificará.

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

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

Inserta count filas de elementos hijos en la fila row.

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

bool QStandardItem::isAutoTristate() const

Devuelve si el elemento es tristate y está controlado por QTreeWidget.

El valor por defecto es false.

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

bool QStandardItem::isCheckable() const

Devuelve si el elemento es comprobable por el usuario.

El valor por defecto es false.

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

bool QStandardItem::isDragEnabled() const

Devuelve si el elemento está habilitado para arrastrar. Un elemento habilitado para arrastrar puede ser arrastrado por el usuario.

El valor por defecto es true.

Tenga en cuenta que el arrastre de elementos debe estar habilitado en la vista para que funcione; consulte QAbstractItemView::dragEnabled.

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

bool QStandardItem::isDropEnabled() const

Devuelve si el elemento está habilitado para soltar. Cuando un ítem está habilitado para drop, puede ser usado como objetivo de drop.

El valor por defecto es true.

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

bool QStandardItem::isEditable() const

Devuelve si el elemento puede ser editado por el usuario.

Cuando un elemento es editable (y está habilitado), el usuario puede editarlo invocando uno de los activadores de edición de la vista; consulte 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 se especifican mediante los otros indicadores de elemento, como isEditable() y isSelectable().

El valor por defecto es true.

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

bool QStandardItem::isSelectable() const

Devuelve si el elemento es seleccionable por el usuario.

El valor por defecto es true.

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

bool QStandardItem::isUserTristate() const

Devuelve si el elemento es tristate; es decir, si es comprobable con tres estados separados y el usuario puede recorrer los tres estados.

El valor por defecto es false.

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

QStandardItemModel *QStandardItem::model() const

Devuelve el QStandardItemModel al que pertenece este elemento.

Si el elemento no es hijo 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 en el 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.

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

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

Lee el elemento del flujo in. Sólo se leen los datos y las banderas del ítem, no los ítems hijos.

Véase también write().

void QStandardItem::removeColumn(int column)

Elimina la columna column. Se eliminan 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. Los elementos que estaban en esas columnas se eliminan.

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

void QStandardItem::removeRow(int row)

Elimina la dirección row. Se eliminan 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 de 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 hija de su padre, o -1 si el elemento no tiene padre.

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

int QStandardItem::rowCount() const

Devuelve el número de filas de elementos hijo 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 asistencia (es decir, para los usuarios que no pueden utilizar 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 los usuarios que no pueden utilizar medios convencionales de interacción).

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

void QStandardItem::setAutoTristate(bool tristate)

Determina que el elemento es tristate y está controlado por QTreeWidget si tristate es true. Esto permite la gestión automática del estado de los elementos padre en QTreeWidget (marcado si todos los hijos están marcados, desmarcado si todos los hijos están desmarcados, o parcialmente marcado si sólo algunos hijos 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 comprobación del elemento en state.

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

void QStandardItem::setCheckable(bool checkable)

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

El delegado de elemento mostrará un elemento comprobable con una casilla de verificació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 hijo en (row, column) como item. Este elemento (el elemento padre) toma posesión de item. Si es necesario, el recuento de filas y columnas se incrementa para ajustarse al elemento.

Véase también child().

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

Establece el hijo en row a item.

void QStandardItem::setColumnCount(int columns)

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

Véase 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 subclasificas QStandardItem y reimplementas esta función, tu reimplementación debería

• llamar a emitDataChanged() si no llama a la implementación base de setData(). Esto asegurará 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 maneje, de lo contrario no funcionará la configuración de banderas, por ejemplo, llamando a setFlags(), setCheckable(), setEditable(), etc.

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

void QStandardItem::setDragEnabled(bool dragEnabled)

Establece si el elemento puede ser arrastrado. Si dragEnabled es verdadero, el elemento puede ser arrastrado por el usuario; en caso contrario, el usuario no puede arrastrar el elemento.

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

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

void QStandardItem::setDropEnabled(bool dropEnabled)

Establece si el objeto se puede soltar. Si dropEnabled es verdadero, el elemento puede utilizarse como objetivo de drop; 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 admite 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 elemento puede ser editado por el usuario; en caso contrario, el usuario no puede editar el elemento.

El modo en que el usuario puede editar elementos en una vista viene determinado por los activadores 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 verdadero, el elemento está habilitado, lo que significa que el usuario puede interactuar con el elemento; si enabled es falso, el usuario no puede interactuar con el elemento.

Por ejemplo, si un elemento no está habilitado, no podrá ser seleccionado por el usuario, aunque se haya activado la opción Qt::ItemIsSelectable.

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

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

Establece los indicadores del elemento en flags.

Los indicadores de elemento determinan cómo puede interactuar el usuario con el elemento. Esto se utiliza a menudo para desactivar un elemento.

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

void QStandardItem::setFont(const QFont &font)

Establece el tipo de letra utilizado para mostrar el texto del elemento en font.

Véase 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, texto) en el brush dado.

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

void QStandardItem::setIcon(const QIcon &icon)

Establece el icono del elemento en la dirección icon especificada.

Véase también icon().

void QStandardItem::setRowCount(int rows)

Establece el número de filas de elementos secundarios en rows. Si 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 se puede seleccionar. Si selectable es verdadero, el elemento puede ser seleccionado por el usuario; en caso contrario, el usuario no puede seleccionar el elemento.

Puedes controlar el comportamiento y el modo de selección manipulando sus propiedades de vista; consulta QAbstractItemView::selectionMode y QAbstractItemView::selectionBehavior.

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

void QStandardItem::setSizeHint(const QSize &size)

Establece el tamaño del elemento que se va a mostrar en size. Si no se especifica, el delegado del elemento calculará el tamaño basándose en los datos del elemento.

Véase también sizeHint().

void QStandardItem::setStatusTip(const QString &statusTip)

Establece la información de estado del elemento en la cadena especificada por 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)

Ajusta la alineación del texto del elemento a la dirección alignment especificada.

Véase también textAlignment().

void QStandardItem::setToolTip(const QString &toolTip)

Establece la información sobre herramientas del elemento en la cadena especificada por toolTip.

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

void QStandardItem::setUserTristate(bool tristate)

Establece si el elemento es triestado y controlado por el usuario. Si tristate es verdadero, el usuario puede pasar por tres estados separados; en caso contrario, el elemento es controlable con dos estados. (Tenga en cuenta que esto también requiere que el elemento sea controlable; consulte isCheckable().)

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

void QStandardItem::setWhatsThis(const QString &whatsThis)

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

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

QSize QStandardItem::sizeHint() const

Devuelve la sugerencia de tamaño establecida para el elemento, o un QSize no válido si no se ha establecido ninguna sugerencia de tamaño.

Si no se ha establecido ninguna indicación de tamaño, el delegado del elemento calculará la indicación 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 hijos del ítem usando el order dado , por los valores en el column dado.

Véase también operator<().

QString QStandardItem::statusTip() const

Devuelve el consejo de estado del elemento.

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

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

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

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

Véase 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. Para los elementos de la columna que no se hayan eliminado, los punteros correspondientes de la lista serán nullptr.

Véase 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. Para los elementos de la fila que no se hayan eliminado, 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. Es el texto que se presenta 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 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 subclasificar QStandardItem, debe 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. Sólo se escriben los datos y las banderas del elemento, no los elementos hijos.

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 del rol de ordenación del elemento (ver QStandardItemModel::sortRole) para realizar la comparación si el elemento pertenece a un modelo; en caso contrario, se utilizan los datos del rol de ordenación del elemento Qt::DisplayRole (text()) para realizar la comparación.

sortChildren() y QStandardItemModel::sort() utilizan esta función para ordenar los elementos. Si desea una ordenación personalizada, puede subclasificar QStandardItem y reimplementar esta función.

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

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

Esta función es útil cuando se reimplementa clone().