QItemEditorCreatorBase Class
La clase `QItemEditorCreatorBase` proporciona una clase base abstracta de la que hay que crear una subclase al implementar nuevos creadores de editores de elementos. Más información...
| Encabezado: | #include <QItemEditorCreatorBase> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado por: |
Funciones públicas
| virtual | ~QItemEditorCreatorBase() |
| virtual QWidget * | createWidget(QWidget *parent) const = 0 |
| virtual QByteArray | valuePropertyName() const = 0 |
Descripción detallada
Los objetos `QItemEditorCreatorBase` son fábricas de widgets especializadas que proporcionan widgets de editor para un tipo de datos concreto de ` QVariant `. Son utilizados por ` QItemEditorFactory ` para crear editores para ` QStyledItemDelegate`. Las bases de creadores deben registrarse con ` QItemEditorFactory::registerEditor()` ().
Un editor debe proporcionar una propiedad de usuario para los datos que edita. De este modo, los QItemDelegates pueden acceder a la propiedad mediante el sistema de metaobjetos de Qt para establecer y recuperar los datos de edición. Una propiedad se establece como propiedad de usuario mediante la palabra clave USER:
Q_PROPERTY(QColor color READ color WRITE setColor USER true)Si el editor no proporciona una propiedad de usuario, debe devolver el nombre de la propiedad mediante ` valuePropertyName()`; los delegados utilizarán entonces ese nombre para acceder a la propiedad. Si existe una propiedad de usuario, los delegados de elementos no llamarán a ` valuePropertyName()`.
QStandardItemEditorCreator es una clase de plantilla de uso común que puede utilizarse para registrar widgets sin necesidad de crear una subclase de `QItemEditorCreatorBase`.
Véase también QStandardItemEditorCreator, QItemEditorFactory y Programación Modelo/Vista.
Documentación de las funciones miembro
[virtual noexcept] QItemEditorCreatorBase::~QItemEditorCreatorBase()
Elimina el objeto creador del editor.
[pure virtual] QWidget *QItemEditorCreatorBase::createWidget(QWidget *parent) const
Devuelve un widget de editor con el ` parent` indicado.
Al implementar esta función en subclases de esta clase, debes crear y devolver nuevos widgets de editor con el widget padre especificado.
[pure virtual] QByteArray QItemEditorCreatorBase::valuePropertyName() const
Devuelve el nombre de la propiedad utilizada para obtener y establecer valores en los widgets del editor del creador.
Al implementar esta función en subclases, debes asegurarte de que la propiedad del widget de editor especificada por esta función pueda aceptar el tipo para el que está registrado el creador. Por ejemplo, un creador que construya widgets de tipo ` QCheckBox ` para editar valores booleanos devolvería el nombre de propiedad ` checkable ` desde esta función, y debe estar registrado en la fábrica de editores de elementos para el tipo ` QMetaType::Bool `.
Nota: Desde Qt 4.2, los delegados de elementos consultan la propiedad de usuario de los widgets y solo llaman a esta función si el widget no tiene propiedad de usuario. Se puede anular este comportamiento reimplementando QAbstractItemDelegate::setModelData() y QAbstractItemDelegate::setEditorData().
Véase también QMetaObject::userProperty() y QItemEditorFactory::registerEditor().
© 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.