Класс QItemEditorFactory
Класс QItemEditorFactory предоставляет виджеты для редактирования данных элементов в представлениях и делегатах. Подробнее...
| Заголовок: | #include <QItemEditorFactory> |
| CMake: | find_package(Qt6 COMPONENTS Widgets REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
Открытые функции
| QItemEditorFactory() | |
| virtual | ~QItemEditorFactory() |
| virtual QWidget * | createEditor(int userType, QWidget *parent) const |
| void | registerEditor(int userType, QItemEditorCreatorBase *creator) |
| virtual QByteArray | valuePropertyName(int userType) const |
Статические открытые члены
| const QItemEditorFactory * | defaultFactory() |
| void | setDefaultFactory(QItemEditorFactory *factory) |
Подробное описание
При редактировании данных в представлении элементов, редакторы создаются и отображаются делегатом. QStyledItemDelegate, который по умолчанию устанавливается в представлениях элементов Qt, использует QItemEditorFactory для создания редакторов для него. По умолчанию используется уникальная экземпляр, предоставляемая QItemEditorFactory, который используется всеми делегатами элементов. Если вы установите новый фабричный объект по умолчанию с помощью setDefaultFactory(), новый фабричный объект будет использоваться существующими и новыми делегатами.
Фабрика хранит коллекцию экземпляров QItemEditorCreatorBase, которые представляют собой специализированные редакторы, производящие редакторы для одного определенного типа данных QVariant (все модели Qt хранят свои данные в QVariant).
Стандартные виджеты редактирования
Стандартная реализация фабрики предоставляет редакторы для различных типов данных. Они создаются всякий раз, когда делегат должен предоставить редактор для данных, предоставляемых моделью. В следующей таблице показаны отношения между типами и стандартными редакторами.
| Тип | Виджет редактора |
|---|---|
| bool | QComboBox |
| double | QDoubleSpinBox |
| int | QSpinBox |
| unsigned int | |
| QDate | QDateEdit |
| QDateTime | QDateTimeEdit |
| QPixmap | QLabel |
| QString | QLineEdit |
| QTime | QTimeEdit |
Дополнительные редакторы можно зарегистрировать с помощью функции registerEditor().
См. также QStyledItemDelegate, Программирование с использованием моделей и представлений и Пример фабрики редактора цвета.
Документация по членам-функциям
QItemEditorFactory::QItemEditorFactory()
Конструирует новый фабричный объект редакторов элементов.
[virtual] QItemEditorFactory::~QItemEditorFactory()
Уничтожает фабричный объект редакторов элементов.
[virtual] QWidget *QItemEditorFactory::createEditor(int userType, QWidget *parent) const
Создает виджет редактора с заданным parent для указанного userType данных и возвращает его как QWidget.
См. также registerEditor().
[static] const QItemEditorFactory *QItemEditorFactory::defaultFactory()
Возвращает фабрику редакторов элементов по умолчанию.
См. также setDefaultFactory().
void QItemEditorFactory::registerEditor(int userType, QItemEditorCreatorBase *creator)
Регистрирует создателя редактора элементов, заданного creator, для указанного userType данных.
Примечание: Фабрика принимает на себя владение создателем редактора элементов и уничтожит его, если позже будет зарегистрирован новый создатель для того же типа.
См. также createEditor().
[static] void QItemEditorFactory::setDefaultFactory(QItemEditorFactory *factory)
Устанавливает фабрику редакторов элементов по умолчанию на заданный factory. И новые, и существующие делегаты будут использовать новый фабричный объект.
См. также defaultFactory().
[virtual] QByteArray QItemEditorFactory::valuePropertyName(int userType) const
Возвращает имя свойства, используемого для доступа к данным для заданного userType данных.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qitemeditorfactory.html