Класс QItemEditorFactory

Класс QItemEditorFactory предоставляет виджеты для редактирования данных элементов в представлениях и делегатах. Подробнее...

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

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

Статические открытые члены

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

При редактировании данных в представлении элементов, редакторы создаются и отображаются делегатом. QStyledItemDelegate, который по умолчанию установлен в представлениях элементов Qt, использует QItemEditorFactory для создания редакторов для него. По умолчанию используется единственный экземпляр, предоставляемый QItemEditorFactory, который используется всеми делегатами элементов. Если вы установите новый фабричный объект по умолчанию с помощью setDefaultFactory(), новый фабричный объект будет использоваться существующими и новыми делегатами.

Фабрика хранит коллекцию QItemEditorCreatorBase экземпляров, которые представляют собой специализированные редакторы, создающие редакторы для одного конкретного типа данных QVariant (все модели Qt хранят свои данные в QVariant).

Стандартные виджеты редактирования

Стандартная реализация фабрики предоставляет редакторы для различных типов данных. Они создаются всякий раз, когда делегату требуется предоставить редактор для данных, предоставляемых моделью. В следующей таблице показаны соотношения между типами и стандартными редакторами.

Дополнительные редакторы можно зарегистрировать с помощью функции 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.