#include <qqmlcomponent_p.h>

Inheritance diagram for QQmlComponentPrivate:

Collaboration diagram for QQmlComponentPrivate:

Classes
struct	AnnotatedQmlError

struct	ConstructionState

Public Types
enum	CreateBehavior { CreateDefault , CreateWarnAboutRequiredProperties }

using	DeferredState = std::vector<ConstructionState>

Public Types inherited from QObjectPrivate
typedef void(*	StaticMetaCallFunction) (QObject , QMetaObject::Call, int, void *)

using	ConnectionDataPointer = QExplicitlySharedDataPointer<ConnectionData>

Public Member Functions
	QQmlComponentPrivate ()

void	loadUrl (const QUrl &newUrl, QQmlComponent::CompilationMode mode=QQmlComponent::PreferSynchronous)

QObject *	beginCreate (QQmlRefPointer< QQmlContextData >)

void	completeCreate ()

void	initializeObjectWithInitialProperties (QV4::QmlContext qmlContext, const QV4::Value &valuemap, QObject toCreate, RequiredProperties *requiredProperties)

virtual void	incubateObject (QQmlIncubator incubationTask, QQmlComponent component, QQmlEngine *engine, const QQmlRefPointer< QQmlContextData > &context, const QQmlRefPointer< QQmlContextData > &forContext)

void	typeDataReady (QQmlTypeData *) override

void	typeDataProgress (QQmlTypeData *, qreal) override

void	fromTypeData (const QQmlRefPointer< QQmlTypeData > &data)

bool	hadTopLevelRequiredProperties () const

void	clear ()

QObject *	doBeginCreate (QQmlComponent q, QQmlContext context)

bool	setInitialProperty (QObject *component, const QString &name, const QVariant &value)

QObject *	createWithProperties (QObject parent, const QVariantMap &properties, QQmlContext context, CreateBehavior behavior=CreateDefault)

bool	isBound () const

LoadHelper::ResolveTypeResult	prepareLoadFromModule (QAnyStringView uri, QAnyStringView typeName)

void	completeLoadFromModule (QAnyStringView uri, QAnyStringView typeName, QQmlType type, LoadHelper::ResolveTypeResult::Status moduleStatus, QQmlComponent::CompilationMode mode=QQmlComponent::PreferSynchronous)

Public Member Functions inherited from QObjectPrivate
void	ensureExtraData ()

	QObjectPrivate (int version=QObjectPrivateVersion)

virtual	~QObjectPrivate ()

void	deleteChildren ()

void	clearBindingStorage ()

void	checkForIncompatibleLibraryVersion (int version) const

void	setParent_helper (QObject *)

void	moveToThread_helper ()

void	setThreadData_helper (QThreadData currentData, QThreadData targetData, QBindingStatus *status)

QObjectList	receiverList (const char *signal) const

void	ensureConnectionData ()

void	addConnection (int signal, Connection *c)

int	signalIndex (const char signalName, const QMetaObject *meta=nullptr) const

bool	isSignalConnected (uint signalIdx, bool checkDeclarative=true) const

bool	maybeSignalConnected (uint signalIndex) const

bool	isDeclarativeSignalConnected (uint signalIdx) const

void	connectNotify (const QMetaMethod &signal)

void	disconnectNotify (const QMetaMethod &signal)

void	reinitBindingStorageAfterThreadMove ()

virtual std::string	flagsForDumping () const

virtual void	writeToDebugStream (QDebug &) const

QtPrivate::QPropertyAdaptorSlotObject *	getPropertyAdaptorSlotObject (const QMetaProperty &property)

Public Member Functions inherited from QObjectData
	QObjectData ()=default

virtual	~QObjectData ()=0

QMetaObject *	dynamicMetaObject () const

Public Member Functions inherited from QQmlTypeData::TypeDataCallback
virtual	~TypeDataCallback ()

Static Public Member Functions
static void	setInitialProperties (QV4::ExecutionEngine engine, QV4::QmlContext qmlContext, const QV4::Value &o, const QV4::Value &v, RequiredProperties requiredProperties, QObject createdComponent, QQmlObjectCreator *creator)
	\qmlmethod QtObject Component::createObject(QtObject parent, object properties)

static QQmlError	unsetRequiredPropertyToQQmlError (const RequiredPropertyInfo &unsetRequiredProperty)

static void	beginDeferred (QQmlEnginePrivate enginePriv, QObject object, DeferredState *deferredState)

static void	completeDeferred (QQmlEnginePrivate enginePriv, DeferredState deferredState)

static void	complete (QQmlEnginePrivate enginePriv, ConstructionState state)

static QQmlProperty	removePropertyFromRequired (QObject createdComponent, const QString &name, RequiredProperties requiredProperties, QQmlEngine engine, bool wasInRequiredProperties=nullptr)

static QQmlComponentPrivate *	get (QQmlComponent *c)

Static Public Member Functions inherited from QObjectPrivate
static bool	removeConnection (Connection *c)

static QObjectPrivate *	get (QObject *o)

static const QObjectPrivate *	get (const QObject *o)

template<typename Func1 , typename Func2 >
static QMetaObject::Connection	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object receiverPrivate, Func2 slot, Qt::ConnectionType type=Qt::AutoConnection)

template<typename Func1 , typename Func2 >
static bool	disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object receiverPrivate, Func2 slot)

static QMetaObject::Connection	connectImpl (const QObject sender, int signal_index, const QObject receiver, void *slot, QtPrivate::QSlotObjectBase slotObj, int type, const int types, const QMetaObject senderMetaObject)

static QMetaObject::Connection	connect (const QObject sender, int signal_index, QtPrivate::QSlotObjectBase slotObj, Qt::ConnectionType type)

static QMetaObject::Connection	connect (const QObject sender, int signal_index, const QObject receiver, QtPrivate::QSlotObjectBase *slotObj, Qt::ConnectionType type)

static bool	disconnect (const QObject sender, int signal_index, void *slot)

static bool	disconnect (const QObject sender, int signal_index, const QObject receiver, void **slot)

Public Attributes
QQmlRefPointer< QQmlTypeData >	typeData

QUrl	url

qreal	progress

std::unique_ptr< QString >	inlineComponentName

int	start

QQmlRefPointer< QV4::ExecutableCompilationUnit >	compilationUnit

QQmlType	loadedType

ConstructionState	state

QQmlEngine *	engine

QQmlGuardedContextData	creationContext

Public Attributes inherited from QObjectPrivate
ExtraData *	extraData

QAtomicPointer< QThreadData >	threadData

QAtomicPointer< ConnectionData >	connections

union {

QObject * currentChildBeingDeleted

QAbstractDeclarativeData * declarativeData

};

QAtomicPointer< QtSharedPointer::ExternalRefCountData >	sharedRefcount

Public Attributes inherited from QObjectData
QObject *	q_ptr

QObject *	parent

QObjectList	children

uint	isWidget: 1

uint	blockSig: 1

uint	wasDeleted: 1

uint	isDeletingChildren: 1

uint	sendChildEvents: 1

uint	receiveChildEvents: 1

uint	isWindow: 1

uint	deleteLaterCalled: 1

uint	isQuickItem: 1

uint	willBeWidget: 1

uint	wasWidget: 1

uint	receiveParentEvents: 1

uint	unused: 20

QAtomicInt	postedEvents

QDynamicMetaObjectData *	metaObject

QBindingStorage	bindingStorage

Detailed Description

Definition at line 39 of file qqmlcomponent_p.h.

Member Typedef Documentation

◆ DeferredState

using QQmlComponentPrivate::DeferredState = std::vector<ConstructionState>

Definition at line 143 of file qqmlcomponent_p.h.

Member Enumeration Documentation

◆ CreateBehavior

enum QQmlComponentPrivate::CreateBehavior

Enumerator
CreateDefault
CreateWarnAboutRequiredProperties

Definition at line 163 of file qqmlcomponent_p.h.

Constructor & Destructor Documentation

◆ QQmlComponentPrivate()

QQmlComponentPrivate::QQmlComponentPrivate ( )

inline

Definition at line 44 of file qqmlcomponent_p.h.

Member Function Documentation

◆ beginCreate()

QObject * QQmlComponentPrivate::beginCreate ( QQmlRefPointer< QQmlContextData > context )

Definition at line 1020 of file qqmlcomponent.cpp.

Here is the call graph for this function:

◆ beginDeferred()

void QQmlComponentPrivate::beginDeferred	(	QQmlEnginePrivate *	enginePriv,
		QObject *	object,
		DeferredState *	deferredState )

static

Definition at line 1132 of file qqmlcomponent.cpp.

References QQmlComponentPrivate::ConstructionState::appendCreatorErrors(), creator, QQmlData::get(), QQmlComponentPrivate::ConstructionState::initCreator(), QQmlEnginePrivate::inProgressCreations, Q_ASSERT, QQmlComponentPrivate::ConstructionState::setCompletePending(), and state.

Referenced by qmlExecuteDeferred().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ clear()

void QQmlComponentPrivate::clear ( )

Definition at line 318 of file qqmlcomponent.cpp.

References compilationUnit, inlineComponentName, loadedType, QQmlRefPointer< T >::reset(), typeData, and QQmlTypeData::unregisterCallback().

Referenced by completeLoadFromModule(), and loadUrl().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ complete()

void QQmlComponentPrivate::complete	(	QQmlEnginePrivate *	enginePriv,
		ConstructionState *	state )

static

Definition at line 1165 of file qqmlcomponent.cpp.

References QQmlComponentPrivate::ConstructionState::creator(), QQmlEnginePrivate::erroredBindings, QQmlObjectCreator::finalize(), QQmlEnginePrivate::inProgressCreations, QQmlComponentPrivate::ConstructionState::isCompletePending(), QQmlDelayedError::removeError(), QQmlComponentPrivate::ConstructionState::setCompletePending(), state, and QQmlEnginePrivate::warning().

Referenced by completeCreate(), completeDeferred(), and createWithProperties().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ completeCreate()

void QQmlComponentPrivate::completeCreate ( )

Definition at line 1255 of file qqmlcomponent.cpp.

References complete(), engine, error, QQmlComponentPrivate::ConstructionState::errors, QQmlEnginePrivate::get(), QQmlComponentPrivate::ConstructionState::hasUnsetRequiredProperties(), QQmlComponentPrivate::ConstructionState::isCompletePending(), QQmlType::isValid(), loadedType, QQmlComponentPrivate::ConstructionState::requiredProperties(), QQmlComponentPrivate::ConstructionState::setCompletePending(), state, and unsetRequiredPropertyToQQmlError().

Here is the call graph for this function:

◆ completeDeferred()

void QQmlComponentPrivate::completeDeferred	(	QQmlEnginePrivate *	enginePriv,
		QQmlComponentPrivate::DeferredState *	deferredState )

static

Definition at line 1159 of file qqmlcomponent.cpp.

References complete(), and state.

Referenced by QQmlBindPrivate::buildBindEntries(), QtQuickPrivate::completeDeferred(), and qmlExecuteDeferred().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ completeLoadFromModule()

void QQmlComponentPrivate::completeLoadFromModule	(	QAnyStringView	uri,
		QAnyStringView	typeName,
		QQmlType	type,
		LoadHelper::ResolveTypeResult::Status	moduleStatus,
		QQmlComponent::CompilationMode	mode = QQmlComponent::PreferSynchronous )

Definition at line 1351 of file qqmlcomponent.cpp.

References arg, baseUrl, blockSignals(), clear(), compilationUnit, emit, error, errorMessage(), QQmlComponentPrivate::ConstructionState::errors, QV4::ExecutableCompilationUnit::inlineComponentId(), inlineComponentName, loadedType, loadUrl(), LoadHelper::ResolveTypeResult::NoSuchModule, QQmlComponent::PreferSynchronous, progress, QUrl::setFragment(), state, QAnyStringView::toString(), and typeName.

Here is the call graph for this function:

◆ createWithProperties()

QObject * QQmlComponentPrivate::createWithProperties	(	QObject *	parent,
		const QVariantMap &	properties,
		QQmlContext *	context,
		CreateBehavior	behavior = CreateDefault )

Definition at line 940 of file qqmlcomponent.cpp.

References complete(), context, CreateWarnAboutRequiredProperties, doBeginCreate(), engine, error, QQmlEnginePrivate::get(), QQmlComponentPrivate::ConstructionState::hasUnsetRequiredProperties(), QQmlComponentPrivate::ConstructionState::isCompletePending(), QObjectData::parent, properties, qmlWarning(), QQmlComponent_setQmlParent(), QQmlComponentPrivate::ConstructionState::requiredProperties(), state, and unsetRequiredPropertyToQQmlError().

Here is the call graph for this function:

◆ doBeginCreate()

QObject * QQmlComponentPrivate::doBeginCreate	(	QQmlComponent *	q,
		QQmlContext *	context )

Definition at line 330 of file qqmlcomponent.cpp.

References context, engine, qWarning, and QQmlEngine::rootContext().

Referenced by createWithProperties().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fromTypeData()

void QQmlComponentPrivate::fromTypeData ( const QQmlRefPointer< QQmlTypeData > & data )

Definition at line 300 of file qqmlcomponent.cpp.

References QQmlComponentPrivate::ConstructionState::appendErrors(), compilationUnit, engine, QQmlComponentPrivate::ConstructionState::errors, QV4::ExecutionEngine::executableCompilationUnit(), QJSEngine::handle(), Q_ASSERT, state, and url.

Referenced by loadUrl(), and typeDataReady().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ get()

static QQmlComponentPrivate * QQmlComponentPrivate::get ( QQmlComponent * c )

inlinestatic

Definition at line 156 of file qqmlcomponent_p.h.

References QObjectPrivate::get().

Referenced by TestCaseCollector::TestCaseCollector(), QQuickLoaderPrivate::_q_sourceLoaded(), QtObject::createComponent(), QtObject::createComponent(), QQmlObjectCreator::createComponent(), QtObject::createQmlObject(), QQuickListViewPrivate::getSectionItem(), QQmlIncubatorPrivate::incubateCppBasedComponent(), incubateObject(), QQuickStackElement::initialize(), QQDMIncubationTask::initializeRequiredProperties(), QQmlDelegateModelPrivate::object(), QQuickLoaderPrivate::setInitialState(), and QQmlApplicationEnginePrivate::startLoad().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hadTopLevelRequiredProperties()

bool QQmlComponentPrivate::hadTopLevelRequiredProperties ( ) const

Definition at line 313 of file qqmlcomponent.cpp.

References QQmlObjectCreator::componentHadTopLevelRequiredProperties(), QQmlComponentPrivate::ConstructionState::creator(), and state.

Here is the call graph for this function:

◆ incubateObject()

void QQmlComponentPrivate::incubateObject	(	QQmlIncubator *	incubationTask,
		QQmlComponent *	component,
		QQmlEngine *	engine,
		const QQmlRefPointer< QQmlContextData > &	context,
		const QQmlRefPointer< QQmlContextData > &	forContext )

virtual

Definition at line 1517 of file qqmlcomponent.cpp.

References compilationUnit, component(), context, engine, get(), QQmlEnginePrivate::get(), QQmlIncubatorPrivate::get(), QQmlEnginePrivate::incubate(), QV4::ExecutableCompilationUnit::inlineComponentId(), and Q_ASSERT.

Here is the call graph for this function:

◆ initializeObjectWithInitialProperties()

void QQmlComponentPrivate::initializeObjectWithInitialProperties	(	QV4::QmlContext *	qmlContext,
		const QV4::Value &	valuemap,
		QObject *	toCreate,
		RequiredProperties *	requiredProperties )

Definition at line 1980 of file qqmlcomponent.cpp.

References QQmlComponentPrivate::ConstructionState::creator(), engine, QJSEngine::handle(), Q_ASSERT, qmlContext(), setInitialProperties(), state, and QV4::QObjectWrapper::wrap().

Here is the call graph for this function:

◆ isBound()

bool QQmlComponentPrivate::isBound ( ) const

inline

Definition at line 170 of file qqmlcomponent_p.h.

Referenced by QQuickLoaderPrivate::_q_sourceLoaded().

Here is the caller graph for this function:

◆ loadUrl()

void QQmlComponentPrivate::loadUrl	(	const QUrl &	newUrl,
		QQmlComponent::CompilationMode	mode = QQmlComponent::PreferSynchronous )

Definition at line 773 of file qqmlcomponent.cpp.

References QQmlComponent::Asynchronous, QQmlTypeLoader::Asynchronous, QQmlEngine::baseUrl(), clear(), emit, engine, error, QQmlComponentPrivate::ConstructionState::errors, fromTypeData(), QQmlEnginePrivate::get(), QDir::isAbsolutePath(), QUrl::isLocalFile(), QQmlTypeLoader::PreferSynchronous, progress, QQmlTypeData::registerCallback(), QUrl::resolved(), state, typeData, and url.

Referenced by completeLoadFromModule().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ prepareLoadFromModule()

LoadHelper::ResolveTypeResult QQmlComponentPrivate::prepareLoadFromModule	(	QAnyStringView	uri,
		QAnyStringView	typeName )

Definition at line 1341 of file qqmlcomponent.cpp.

References engine, QQmlEnginePrivate::get(), and typeName.

Here is the call graph for this function:

◆ removePropertyFromRequired()

QQmlProperty QQmlComponentPrivate::removePropertyFromRequired	(	QObject *	createdComponent,
		const QString &	name,
		RequiredProperties *	requiredProperties,
		QQmlEngine *	engine,
		bool *	wasInRequiredProperties = nullptr )

static

Finds the matching top-level property with name name of the component createdComponent. If it was a required property or an alias to a required property contained in requiredProperties, it is removed from it. requiredProperties must be non-null.

If wasInRequiredProperties is non-null, the referenced boolean is set to true iff the property was found in requiredProperties.

Returns the QQmlProperty with name name (which might be invalid if there is no such property), for further processing (for instance, actually setting the property value).

Note: This method is used in QQmlComponent and QQmlIncubator to manage required properties. Most classes which create components should not need it and should only need to call setInitialProperties.

Definition at line 1200 of file qqmlcomponent.cpp.

References QHash< Key, T >::cend(), QHash< Key, T >::constFind(), engine, QHash< Key, T >::erase(), QQmlPropertyPrivate::findAliasTarget(), QQmlPropertyPrivate::get(), QQmlData::get(), QQmlProperty::isValid(), it, and Q_ASSERT.

Referenced by QQmlIncubatorPrivate::incubate(), QQDMIncubationTask::initializeRequiredProperties(), setInitialProperties(), setInitialProperty(), and QQmlTableInstanceModel::setRequiredProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setInitialProperties()

void QQmlComponentPrivate::setInitialProperties	(	QV4::ExecutionEngine *	engine,
		QV4::QmlContext *	qmlContext,
		const QV4::Value &	o,
		const QV4::Value &	v,
		RequiredProperties *	requiredProperties,
		QObject *	createdComponent,
		QQmlObjectCreator *	creator )

static

\qmlmethod QtObject Component::createObject(QtObject parent, object properties)

Creates and returns an object instance of this component that will have the given parent and properties. The properties argument is optional. Returns null if object creation fails.

The object will be created in the same context as the one in which the component was created. This function will always return null when called on components which were not created in QML.

If you wish to create an object without setting a parent, specify null for the parent value. Note that if the returned object is to be displayed, you must provide a valid parent value or set the returned object's \l{Item::parent}{parent} property, otherwise the object will not be visible.

If a parent is not provided to createObject(), a reference to the returned object must be held so that it is not destroyed by the garbage collector. This is true regardless of whether \l{Item::parent} is set afterwards, because setting the Item parent does not change object ownership. Only the graphical parent is changed.

As of {QtQuick 1.1}, this method accepts an optional properties argument that specifies a map of initial property values for the created object. These values are applied before the object creation is finalized. This is more efficient than setting property values after object creation, particularly where large sets of property values are defined, and also allows property bindings to be set up (using \l{Qt::binding}{Qt.binding}) before the object is created.

The properties argument is specified as a map of property-value items. For example, the code below creates an object with initial x and y values of 100 and 100, respectively:

\qml const component = Qt.createComponent("Button.qml"); if (component.status === Component.Ready) { component.createObject(parent, { x: 100, y: 100 }); } \endqml

Dynamically created instances can be deleted with the destroy() method. See \l {Dynamic QML Object Creation from JavaScript} for more information.