En esta página

QSqlRelationalDelegate Class

La clase `QSqlRelationalDelegate` proporciona un delegado que se utiliza para mostrar y editar datos procedentes de un ` QSqlRelationalTableModel`. Más información...

Encabezado: #include <QSqlRelationalDelegate>
CMake: find_package(Qt6 REQUIRED COMPONENTS Sql)
target_link_libraries(mytarget PRIVATE Qt6::Sql)
qmake: QT += sql
Heredado de: QStyledItemDelegate

Funciones públicas

QSqlRelationalDelegate(QObject *parent = nullptr)
virtual ~QSqlRelationalDelegate()

Funciones públicas reimplementadas

virtual QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const override
virtual void setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const override

Descripción detallada

A diferencia del delegado predeterminado, QSqlRelationalDelegate proporciona un cuadro combinado para los campos que son claves externas en otras tablas. Para utilizar la clase, basta con llamar a ` QAbstractItemView::setItemDelegate()` en la vista con una instancia de `QSqlRelationalDelegate`:

    std::unique_ptr<QTableView> view{new QTableView};
    view->setModel(model);
    view->setItemDelegate(new QSqlRelationalDelegate(view.get()));

El ejemplo «Modelo de tabla relacional» (que se muestra a continuación) ilustra cómo utilizar QSqlRelationalDelegate junto con QSqlRelationalTableModel para dotar a las tablas de compatibilidad con claves externas.

El usuario puede modificar una clave externa en una tabla relacional

Véase también QSqlRelationalTableModel y Programación de modelos y vistas.

Documentación de las funciones de miembro

[explicit] QSqlRelationalDelegate::QSqlRelationalDelegate(QObject *parent = nullptr)

Crea un objeto `QSqlRelationalDelegate` con el ` parent` especificado.

[virtual noexcept] QSqlRelationalDelegate::~QSqlRelationalDelegate()

Destruye el objeto ` QSqlRelationalDelegate ` y libera todos los recursos asignados.

[override virtual] QWidget *QSqlRelationalDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const

Reimplementa: ` QStyledItemDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const`.

[override virtual] void QSqlRelationalDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const

Reimplementa: ` QStyledItemDelegate::setModelData` (`QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const`.

© 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.