QTableWidget Class

Documentación de las funciones miembro

[explicit] QTableWidget::QTableWidget(QWidget *parent = nullptr)

Crea una nueva vista de tabla con la dirección parent.

QTableWidget::QTableWidget(int rows, int columns, QWidget *parent = nullptr)

Crea una nueva vista de tabla con los datos rows y columns, y con el dato parent.

[virtual noexcept] QTableWidget::~QTableWidget()

Destruye este QTableWidget.

[signal] void QTableWidget::cellActivated(int row, int column)

Esta señal se emite cuando se ha activado la célula especificada por row y column

[signal] void QTableWidget::cellChanged(int row, int column)

Esta señal se emite siempre que han cambiado los datos del elemento en la celda especificada por row y column.

[signal] void QTableWidget::cellClicked(int row, int column)

Esta señal se emite cada vez que se hace clic en una celda de la tabla. Las direcciones row y column especificadas son la celda sobre la que se ha hecho clic.

[signal] void QTableWidget::cellDoubleClicked(int row, int column)

Esta señal se emite cada vez que se hace doble clic en una celda de la tabla. Las direcciones row y column especificadas son la celda sobre la que se ha hecho doble clic.

[signal] void QTableWidget::cellEntered(int row, int column)

Esta señal se emite cuando el cursor del ratón entra en una celda. La celda está especificada por row y column.

Esta señal sólo se emite cuando mouseTracking está activado, o cuando se pulsa un botón del ratón al entrar en un elemento.

[signal] void QTableWidget::cellPressed(int row, int column)

Esta señal se emite cada vez que se pulsa una celda de la tabla. Las direcciones row y column especificadas son la celda que se ha pulsado.

QWidget *QTableWidget::cellWidget(int row, int column) const

Devuelve el widget que aparece en la celda de row y column.

Véase también setCellWidget().

[slot] void QTableWidget::clear()

Elimina todos los elementos de la vista. Esto también eliminará todas las selecciones y cabeceras. Si no desea eliminar los encabezados, utilice QTableWidget::clearContents(). Las dimensiones de la tabla no cambian.

[slot] void QTableWidget::clearContents()

Elimina de la vista todos los elementos que no aparecen en las cabeceras. Esto también eliminará todas las selecciones. Las dimensiones de la tabla no cambian.

void QTableWidget::closePersistentEditor(QTableWidgetItem *item)

Cierra el editor persistente para item.

Véase también openPersistentEditor() y isPersistentEditorOpen().

int QTableWidget::column(const QTableWidgetItem *item) const

Devuelve la columna de item.

int QTableWidget::columnCount() const

Devuelve el número de columnas.

Véase también setColumnCount().

[signal] void QTableWidget::currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn)

Esta señal se emite cada vez que cambia la celda actual. La celda especificada por previousRow y previousColumn es la celda que anteriormente tenía el foco, la celda especificada por currentRow y currentColumn es la nueva celda actual.

int QTableWidget::currentColumn() const

Devuelve la columna del elemento actual.

Véase también currentRow() y setCurrentCell().

QTableWidgetItem *QTableWidget::currentItem() const

Devuelve el elemento actual.

Véase también setCurrentItem().

[signal] void QTableWidget::currentItemChanged(QTableWidgetItem *current, QTableWidgetItem *previous)

Esta señal se emite cada vez que cambia el elemento actual. El elemento previous es el elemento que anteriormente tenía el foco, current es el nuevo elemento actual.

int QTableWidget::currentRow() const

Devuelve la fila del elemento actual.

Véase también currentColumn() y setCurrentCell().

[override virtual protected] void QTableWidget::dropEvent(QDropEvent *event)

Reimplementa: QTableView::dropEvent(QDropEvent *event).

[virtual protected] bool QTableWidget::dropMimeData(int row, int column, const QMimeData *data, Qt::DropAction action)

Maneja el data suministrado por una operación de arrastrar y soltar que terminó con el action dado en los row y column dados . Devuelve true si los datos y la acción pueden ser manejados por el modelo; en caso contrario devuelve false.

Véase también supportedDropActions() y supportedDragActions.

void QTableWidget::editItem(QTableWidgetItem *item)

Inicia la edición de item si es editable.

[override virtual protected] bool QTableWidget::event(QEvent *e)

Reimplementa: QAbstractItemView::event(QEvent *event).

QList<QTableWidgetItem *> QTableWidget::findItems(const QString &text, Qt::MatchFlags flags) const

Busca elementos que coincidan con la dirección text utilizando la dirección flags.

QTableWidgetItem *QTableWidget::horizontalHeaderItem(int column) const

Devuelve el elemento de cabecera horizontal de la columna, column, si se ha establecido uno; en caso contrario devuelve nullptr.

Véase también setHorizontalHeaderItem().

QModelIndex QTableWidget::indexFromItem(const QTableWidgetItem *item) const

Devuelve el QModelIndex asociado con el item dado.

[slot] void QTableWidget::insertColumn(int column)

Inserta una columna vacía en la tabla en column.

[slot] void QTableWidget::insertRow(int row)

Inserta una fila vacía en la tabla en row.

bool QTableWidget::isPersistentEditorOpen(QTableWidgetItem *item) const

Devuelve si hay un editor persistente abierto para el elemento item.

Véase también openPersistentEditor() y closePersistentEditor().

QTableWidgetItem *QTableWidget::item(int row, int column) const

Devuelve el elemento para el row dado y column si se ha establecido uno; en caso contrario devuelve nullptr.

Véase también setItem().

[signal] void QTableWidget::itemActivated(QTableWidgetItem *item)

Esta señal se emite cuando se ha activado el item especificado

QTableWidgetItem *QTableWidget::itemAt(const QPoint &point) const

Devuelve un puntero al elemento en el point dado , o devuelve nullptr si point no está cubierto por un elemento en el widget de tabla.

Véase también item().

QTableWidgetItem *QTableWidget::itemAt(int ax, int ay) const

Devuelve el elemento en la posición equivalente a QPoint(ax, ay) en el sistema de coordenadas del widget de tabla, o devuelve nullptr si el punto especificado no está cubierto por un elemento del widget de tabla.

Véase también item().

[signal] void QTableWidget::itemChanged(QTableWidgetItem *item)

Esta señal se emite cuando cambian los datos de item.

[signal] void QTableWidget::itemClicked(QTableWidgetItem *item)

Esta señal se emite cada vez que se hace clic en un elemento de la tabla. El item especificado es el elemento sobre el que se ha hecho clic.

[signal] void QTableWidget::itemDoubleClicked(QTableWidgetItem *item)

Esta señal se emite cada vez que se hace doble clic sobre un elemento de la tabla. El item especificado es el elemento sobre el que se ha hecho doble clic.

[signal] void QTableWidget::itemEntered(QTableWidgetItem *item)

Esta señal se emite cuando el cursor del ratón entra en un elemento. El item es el elemento introducido.

Esta señal sólo se emite cuando mouseTracking está activado, o cuando se pulsa un botón del ratón mientras se mueve en un elemento.

QTableWidgetItem *QTableWidget::itemFromIndex(const QModelIndex &index) const

Devuelve un puntero a la dirección QTableWidgetItem asociada a la dirección index.

[signal] void QTableWidget::itemPressed(QTableWidgetItem *item)

Esta señal se emite cada vez que se pulsa un elemento de la tabla. El item especificado es el elemento que se ha pulsado.

const QTableWidgetItem *QTableWidget::itemPrototype() const

Devuelve el prototipo de elemento utilizado por la tabla.

Véase también setItemPrototype().

[signal] void QTableWidget::itemSelectionChanged()

Esta señal se emite cada vez que cambia la selección.

Véase también selectedItems() y QTableWidgetItem::isSelected().

QList<QTableWidgetItem *> QTableWidget::items(const QMimeData *data) const

Devuelve una lista de punteros a los elementos contenidos en el objeto data. Si el objeto no fue creado por un QTreeWidget en el mismo proceso, la lista está vacía.

[virtual protected] QMimeData *QTableWidget::mimeData(const QList<QTableWidgetItem *> &items) const

Devuelve un objeto que contiene una descripción serializada del items especificado. El formato utilizado para describir los elementos se obtiene de la función mimeTypes().

Si la lista de elementos está vacía, se devuelve nullptr en lugar de una lista vacía serializada.

[virtual protected] QStringList QTableWidget::mimeTypes() const

Devuelve una lista de tipos MIME que pueden utilizarse para describir una lista de elementos tablewidget.

Véase también mimeData().

void QTableWidget::openPersistentEditor(QTableWidgetItem *item)

Abre un editor para dar item. El editor permanece abierto después de la edición.

Véase también closePersistentEditor() y isPersistentEditorOpen().

void QTableWidget::removeCellWidget(int row, int column)

Elimina el widget establecido en la celda indicada por row y column.

[slot] void QTableWidget::removeColumn(int column)

Elimina la columna column y todos sus elementos de la tabla.

[slot] void QTableWidget::removeRow(int row)

Elimina la fila row y todos sus elementos de la tabla.

int QTableWidget::row(const QTableWidgetItem *item) const

Devuelve la fila de item.

int QTableWidget::rowCount() const

Devuelve el número de filas.

Véase también setRowCount().

[slot] void QTableWidget::scrollToItem(const QTableWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible)

Desplaza la vista si es necesario para garantizar la visibilidad de item. El parámetro hint especifica con mayor precisión dónde debe situarse item tras la operación.

QList<QTableWidgetItem *> QTableWidget::selectedItems() const

Devuelve una lista de todos los elementos seleccionados.

Esta función devuelve una lista de punteros al contenido de las celdas seleccionadas. Utilice la función selectedIndexes() para recuperar la selección completa , incluidas las celdas vacías.

Véase también selectedIndexes().

QList<QTableWidgetSelectionRange> QTableWidget::selectedRanges() const

Devuelve una lista de todos los rangos seleccionados.

Véase también QTableWidgetSelectionRange.

void QTableWidget::setCellWidget(int row, int column, QWidget *widget)

Establece el widget dado para que se muestre en la celda en los row y column dados , pasando la propiedad del widget a la tabla.

Si el widget de la celda A se sustituye por el widget de la celda B, el widget de la celda A se eliminará. Por ejemplo, en el fragmento de código siguiente, se eliminará el objeto QLineEdit.

setCellWidget(row, column, new QLineEdit);
...
setCellWidget(row, column, new QTextEdit);

Véase también cellWidget().

void QTableWidget::setColumnCount(int columns)

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

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

void QTableWidget::setCurrentCell(int row, int column)

Establece la celda actual en la posición (row, column).

Dependiendo de la selection mode actual, la celda también puede ser seleccionada.

Véase también setCurrentItem(), currentRow(), y currentColumn().

void QTableWidget::setCurrentCell(int row, int column, QItemSelectionModel::SelectionFlags command)

Establece que la celda actual sea la celda en la posición (row, column), usando el command dado.

Véase también setCurrentItem(), currentRow(), y currentColumn().

void QTableWidget::setCurrentItem(QTableWidgetItem *item)

Establece el elemento actual en item.

A menos que el modo de selección sea NoSelection, el elemento también se selecciona.

Véase también currentItem() y setCurrentCell().

void QTableWidget::setCurrentItem(QTableWidgetItem *item, QItemSelectionModel::SelectionFlags command)

Establece que el elemento actual sea item, utilizando el command dado.

Véase también currentItem() y setCurrentCell().

void QTableWidget::setHorizontalHeaderItem(int column, QTableWidgetItem *item)

Establece el elemento de cabecera horizontal para la columna column en item. Si es necesario, el recuento de columnas se incrementa para que quepa el elemento. El elemento de cabecera anterior (si existía) se elimina.

Véase también horizontalHeaderItem().

void QTableWidget::setHorizontalHeaderLabels(const QStringList &labels)

Establece las etiquetas de cabecera horizontales utilizando labels.

void QTableWidget::setItem(int row, int column, QTableWidgetItem *item)

Establece el elemento para los datos row y column en item.

La tabla toma posesión del elemento.

Tenga en cuenta que si la ordenación está activada (véase sortingEnabled) y column es la columna de ordenación actual, row se moverá a la posición ordenada determinada por item.

Si desea establecer varios elementos de una fila en particular (por ejemplo, llamando a setItem() en un bucle), puede desactivar la ordenación antes de hacerlo, y volver a activarla después; esto le permitirá utilizar el mismo argumento row para todos los elementos de la misma fila (es decir, setItem() no moverá la fila).

Véase también item() y takeItem().

void QTableWidget::setItemPrototype(const QTableWidgetItem *item)

Establece el prototipo de elemento de la tabla en la dirección item especificada.

El widget de tabla utilizará la función de clonación del prototipo de elemento cuando necesite crear un nuevo elemento de tabla. Por ejemplo cuando el usuario está editando en una celda vacía. Esto es útil cuando tienes una subclase QTableWidgetItem y quieres asegurarte de que QTableWidget crea instancias de tu subclase.

La tabla toma posesión del prototipo.

Véase también itemPrototype().

void QTableWidget::setRangeSelected(const QTableWidgetSelectionRange &range, bool select)

Selecciona o anula la selección de range en función de select.

void QTableWidget::setRowCount(int rows)

Establece el número de filas del modelo de esta tabla en rows. Si es inferior a rowCount(), se descartan los datos de las filas no deseadas.

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

void QTableWidget::setVerticalHeaderItem(int row, QTableWidgetItem *item)

Establece el elemento de cabecera vertical de la fila row en item.

Véase también verticalHeaderItem().

void QTableWidget::setVerticalHeaderLabels(const QStringList &labels)

Establece las etiquetas de cabecera verticales utilizando labels.

void QTableWidget::sortItems(int column, Qt::SortOrder order = Qt::AscendingOrder)

Ordena todas las filas del widget de tabla basándose en column y order.

[virtual protected] Qt::DropActions QTableWidget::supportedDropActions() const

Devuelve las acciones de soltar soportadas por esta vista.

Véase también Qt::DropActions, supportedDragActions, y dropMimeData().

QTableWidgetItem *QTableWidget::takeHorizontalHeaderItem(int column)

Elimina el elemento de cabecera horizontal en column de la cabecera sin borrarlo.

QTableWidgetItem *QTableWidget::takeItem(int row, int column)

Elimina el elemento en row y column de la tabla sin borrarlo.

QTableWidgetItem *QTableWidget::takeVerticalHeaderItem(int row)

Elimina el elemento de cabecera vertical en row de la cabecera sin borrarlo.

QTableWidgetItem *QTableWidget::verticalHeaderItem(int row) const

Devuelve el elemento de cabecera vertical de la fila row.

Véase también setVerticalHeaderItem().

int QTableWidget::visualColumn(int logicalColumn) const

Devuelve la columna visual de la dirección logicalColumn.

QRect QTableWidget::visualItemRect(const QTableWidgetItem *item) const

Devuelve el rectángulo de la ventana gráfica ocupado por el elemento en item.

int QTableWidget::visualRow(int logicalRow) const

Devuelve la fila visual de la dirección logicalRow.