Struct qt_qml::q_qml_engine::ObjectOwnership

#[repr(transparent)]pub struct ObjectOwnership(_);

ObjectOwnership controls whether or not QML automatically destroys the QObject when the corresponding JavaScript object is garbage collected by the engine. The two ownership options are:

C++ enum: QQmlEngine::ObjectOwnership.

C++ documentation:

ObjectOwnership controls whether or not QML automatically destroys the QObject when the corresponding JavaScript object is garbage collected by the engine. The two ownership options are:

Generally an application doesn't need to set an object's ownership explicitly. QML uses a heuristic to set the default ownership. By default, an object that is created by QML has JavaScriptOwnership. The exception to this are the root objects created by calling QQmlComponent::create() or QQmlComponent::beginCreate(), which have CppOwnership by default. The ownership of these root-level objects is considered to have been transferred to the C++ caller.

Objects not-created by QML have CppOwnership by default. The exception to this are objects returned from C++ method calls; their ownership will be set to JavaScriptOwnership. This applies only to explicit invocations of Q_INVOKABLE methods or slots, but not to property getter invocations.

Calling setObjectOwnership() overrides the default ownership heuristic used by QML.

Methods

impl ObjectOwnership

pub fn to_int(&self) -> c_int

impl ObjectOwnership

pub const CppOwnership: ObjectOwnership

The object is owned by C++ code and QML will never delete it. The JavaScript destroy() method cannot be used on these objects. This option is similar to QScriptEngine::QtOwnership. (C++ enum variant: CppOwnership = 0)

pub const JavaScriptOwnership: ObjectOwnership

The object is owned by JavaScript. When the object is returned to QML as the return value of a method call, QML will track it and delete it if there are no remaining JavaScript references to it and it has no QObject::parent(). An object tracked by one QQmlEngine will be deleted during that QQmlEngine's destructor. Thus, JavaScript references between objects with JavaScriptOwnership from two different engines will not be valid if one of these engines is deleted. This option is similar to QScriptEngine::ScriptOwnership. (C++ enum variant: JavaScriptOwnership = 1)

Trait Implementations

impl Clone for ObjectOwnership

fn clone(&self) -> ObjectOwnership

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ObjectOwnership

impl Debug for ObjectOwnership

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Eq for ObjectOwnership

impl From<ObjectOwnership> for c_int

fn from(value: ObjectOwnership) -> Self

Performs the conversion.

impl From<i32> for ObjectOwnership

fn from(value: c_int) -> Self

Performs the conversion.

impl PartialEq<ObjectOwnership> for ObjectOwnership

fn eq(&self, other: &ObjectOwnership) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &ObjectOwnership) -> bool

This method tests for !=.

impl StructuralEq for ObjectOwnership

impl StructuralPartialEq for ObjectOwnership