QItemEditorCreatorBase Class
La clase QItemEditorCreatorBase provee una clase base abstracta que debe ser subclasificada cuando se implementan nuevos creadores de editores de items. Más...
| Cabecera: | #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 QVariant en particular. Son utilizados por QItemEditorFactory para crear editores para QStyledItemDelegates. Las bases creadoras deben ser registradas con QItemEditorFactory::registerEditor().
Un editor debe proporcionar una propiedad de usuario para los datos que edita. QItemDelagates puede entonces acceder a la propiedad utilizando el sistema de meta-objetos de Qt para establecer y recuperar los datos de edición. Una propiedad se establece como propiedad de usuario con 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 desde valuePropertyName(); los delegados utilizarán entonces el 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 que puede utilizarse para registrar widgets sin necesidad de subclasificar QItemEditorCreatorBase.
Ver también QStandardItemEditorCreator, QItemEditorFactory, y Programación Modelo/Vista.
Documentación de Funciones Miembro
[virtual noexcept] QItemEditorCreatorBase::~QItemEditorCreatorBase()
Destruye el objeto creador del editor.
[pure virtual] QWidget *QItemEditorCreatorBase::createWidget(QWidget *parent) const
Devuelve un widget editor con la dirección parent.
Cuando implemente esta función en subclases de esta clase, debe construir 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 de editor del creador.
Cuando implemente esta función en subclases, debe asegurarse de que la propiedad del widget editor especificada por esta función puede aceptar el tipo para el que está registrado el creador. Por ejemplo, un creador que construya widgets QCheckBox para editar valores booleanos devolvería el nombre de la propiedad checkable desde esta función, y debe estar registrado en la fábrica del editor de elementos para el tipo QMetaType::Bool.
Nota: Desde Qt 4.2 los delegados de ítems consultan la propiedad user de los widgets, y sólo llaman a esta función si el widget no tiene propiedad user. Puedes 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.
