En esta página

QItemEditorFactory Class

La clase QItemEditorFactory proporciona widgets para editar los datos de los elementos en vistas y delegados. Más información...

Encabezado: #include <QItemEditorFactory>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets

Funciones públicas

QItemEditorFactory()
virtual ~QItemEditorFactory()
virtual QWidget *createEditor(int userType, QWidget *parent) const
void registerEditor(int userType, QItemEditorCreatorBase *creator)
virtual QByteArray valuePropertyName(int userType) const

Miembros públicos estáticos

const QItemEditorFactory *defaultFactory()
void setDefaultFactory(QItemEditorFactory *factory)

Descripción detallada

Al editar datos en una vista de elemento, un delegado se encarga de crear y mostrar los editores. ` QStyledItemDelegate`, que es el delegado instalado por defecto en las vistas de elemento de Qt, utiliza una `QItemEditorFactory` para crear los editores correspondientes. Todos los delegados de elementos utilizan una instancia única predeterminada proporcionada por QItemEditorFactory. Si se establece una nueva fábrica predeterminada con setDefaultFactory(), tanto los delegados existentes como los nuevos utilizarán la nueva fábrica.

Una fábrica mantiene una colección de instancias de ` QItemEditorCreatorBase `, que son editores especializados que generan editores para un tipo de datos concreto de ` QVariant ` (todos los modelos de Qt XML almacenan sus datos en ` QVariant`).

Widgets de edición estándar

La implementación estándar de la fábrica proporciona editores para una variedad de tipos de datos. Estos se crean cada vez que un delegado necesita proporcionar un editor para los datos suministrados por un modelo. La siguiente tabla muestra la relación entre los tipos y los editores estándar proporcionados.

Se pueden registrar editores adicionales mediante la función ` registerEditor()`.

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

Documentación de funciones miembro

QItemEditorFactory::QItemEditorFactory()

Crea una nueva fábrica de editores de elementos.

[virtual noexcept] QItemEditorFactory::~QItemEditorFactory()

Destruye la fábrica del editor de elementos.

[virtual] QWidget *QItemEditorFactory::createEditor(int userType, QWidget *parent) const

Crea un widget de editor con el « parent » indicado para el « userType » de datos especificado, y lo devuelve como un « QWidget ».

Véase también registerEditor().

[static] const QItemEditorFactory *QItemEditorFactory::defaultFactory()

Devuelve la fábrica predeterminada del editor de elementos.

Véase también ` setDefaultFactory()`.

void QItemEditorFactory::registerEditor(int userType, QItemEditorCreatorBase *creator)

Registra un creador de editor de elementos especificado por creator para el userType de datos indicado.

Nota: La fábrica asume la propiedad del creador del editor de elementos y lo eliminará si posteriormente se registra un nuevo creador para el mismo tipo.

Véase también createEditor().

[static] void QItemEditorFactory::setDefaultFactory(QItemEditorFactory *factory)

Establece la fábrica predeterminada del editor de elementos en la especificada en factory. Tanto los delegados nuevos como los ya existentes utilizarán la nueva fábrica.

Véase también defaultFactory().

[virtual] QByteArray QItemEditorFactory::valuePropertyName(int userType) const

Devuelve el nombre de la propiedad que se utiliza para acceder a los datos de la « userType » especificada.

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