Класс QItemEditorCreatorBase

Класс QItemEditorCreatorBase предоставляет абстрактный базовый класс, который необходимо наследовать при реализации новых создателей редакторов элементов. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Подробное описание

Объекты QItemEditorCreatorBase представляют собой специализированные фабрики виджетов, которые предоставляют виджеты-редакторы для одного конкретного типа данных QVariant. Они используются классом QItemEditorFactory для создания редакторов для QStyledItemDelegate. Базовые классы создателей должны быть зарегистрированы с помощью QItemEditorFactory::registerEditor().

Редактор должен предоставить пользовательскую собственность для данных, которые он редактирует. QItemDelagates затем могут получить доступ к свойству, используя механизм метаобъектов Qt, для установки и получения данных редактирования. Свойство устанавливается как пользовательская собственность с ключевым словом USER:

Q_PROPERTY(QColor color READ color WRITE setColor USER true)

Если редактор не предоставляет пользовательскую собственность, он должен вернуть имя свойства из valuePropertyName(); делегаты затем будут использовать это имя для доступа к свойству. Если пользовательская собственность существует, делегаты элементов не будут вызывать valuePropertyName().

QStandardItemEditorCreator — это удобный шаблонный класс, который может использоваться для регистрации виджетов без необходимости наследования от QItemEditorCreatorBase.

См. также QStandardItemEditorCreator, QItemEditorFactory, Программирование с помощью моделей и представлений и Пример фабрики редакторов цвета.

Документация по функциям-членам

[virtual] QItemEditorCreatorBase::~QItemEditorCreatorBase()

Уничтожает объект создателя редактора.

[pure virtual] QWidget *QItemEditorCreatorBase::createWidget(QWidget *parent) const

Возвращает виджет редактора с указанным parent.

При реализации этой функции в подклассах этого класса, необходимо создать и вернуть новые виджеты-редакторы с указанным родительским виджетом.

[pure virtual] QByteArray QItemEditorCreatorBase::valuePropertyName() const

Возвращает имя свойства, используемого для получения и установки значений в виджетах-редакторах создателя.

При реализации этой функции в подклассах, необходимо убедиться, что свойство виджета-редактора, указанное этой функцией, может принимать тип, для которого зарегистрирован создатель. Например, создатель, который строит виджеты QCheckBox для редактирования логических значений, возвращает имя свойства checkable из этой функции и должен быть зарегистрирован в фабрике редакторов элементов для типа QMetaType::Bool.

Примечание: начиная с Qt 4.2, делегаты элементов запрошивают пользовательское свойство виджетов и вызывают эту функцию только в том случае, если у виджета нет пользовательского свойства. Вы можете изменить это поведение, переопределив QAbstractItemDelegate::setModelData() и QAbstractItemDelegate::setEditorData().

См. также QMetaObject::userProperty() и QItemEditorFactory::registerEditor().