Spec-Zone.ru › Qt 6.1

Класс 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API