#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

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)

void	_q_reregisterTimers (void *pointer)

bool	isSender (const QObject receiver, const char signal) const

QObjectList	receiverList (const char *signal) const

QObjectList	senderList () 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

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 ()

virtual void	typeDataProgress (QQmlTypeData *, qreal)

virtual void	typeDataReady (QQmlTypeData *)

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	unused: 21

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 1007 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 1110 of file qqmlcomponent.cpp.

References QQmlComponentPrivate::ConstructionState::appendCreatorErrors(), creator, QQmlData::deferredData, 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 314 of file qqmlcomponent.cpp.

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

Referenced by 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 1143 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 1233 of file qqmlcomponent.cpp.

References complete(), engine, error, QQmlComponentPrivate::ConstructionState::errors, QQmlEnginePrivate::get(), QQmlComponentPrivate::ConstructionState::hasUnsetRequiredProperties(), QQmlEnginePrivate::inProgressCreations, 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 1137 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:

◆ createWithProperties()

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

Definition at line 936 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 326 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 297 of file qqmlcomponent.cpp.

References QQmlComponentPrivate::ConstructionState::appendErrors(), compilationUnit, QQmlComponentPrivate::ConstructionState::errors, Q_ASSERT, QQmlRefPointer< T >::reset(), state, and url.

Referenced by QtObject::createQmlObject(), 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(), and QQuickLoaderPrivate::setInitialState().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hadTopLevelRequiredProperties()

bool QQmlComponentPrivate::hadTopLevelRequiredProperties ( ) const

Definition at line 309 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 1457 of file qqmlcomponent.cpp.

References compilationUnit, QQmlIncubatorPrivate::compilationUnit, component(), context, creationContext, QQmlIncubatorPrivate::creator, engine, QQmlIncubatorPrivate::enginePriv, get(), QQmlEnginePrivate::get(), QQmlIncubatorPrivate::get(), QQmlEnginePrivate::incubate(), QV4::ExecutableCompilationUnit::inlineComponentId(), inlineComponentName, Q_ASSERT, QScopedPointer< T, Cleanup >::reset(), start, and QQmlIncubatorPrivate::subComponentToCreate.

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 1920 of file qqmlcomponent.cpp.

References QQmlComponentPrivate::ConstructionState::creator(), engine, QJSEngine::handle(), QV4::StaticValue::isUndefined(), 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.

References QV4::CompiledData::Unit::ComponentsBound.

Referenced by QQuickLoaderPrivate::_q_sourceLoaded(), and QQDMIncubationTask::initializeRequiredProperties().

Here is the caller graph for this function:

◆ loadUrl()

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

Definition at line 769 of file qqmlcomponent.cpp.

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

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 1178 of file qqmlcomponent.cpp.

References QQmlPropertyData::coreIndex(), QQmlPropertyIndex::coreIndex(), QHash< Key, T >::end(), engine, QHash< Key, T >::erase(), QHash< Key, T >::find(), QQmlPropertyPrivate::findAliasTarget(), QQmlPropertyPrivate::get(), QQmlData::get(), QQmlPropertyData::isAlias(), 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.