The QQuickView class provides a window for displaying a Qt Quick user interface. More...

#include <qquickview.h>

Inheritance diagram for QQuickView:

Collaboration diagram for QQuickView:

Public Types
enum	ResizeMode { SizeViewToRootObject , SizeRootObjectToView }
	This enum specifies how to resize the view. More...

enum	Status { Null , Ready , Loading , Error }
	Specifies the loading status of the QQuickView. More...

Public Types inherited from QSurface
enum	SurfaceClass { Window , Offscreen }
	The SurfaceClass enum describes the actual subclass of the surface. More...

enum	SurfaceType { RasterSurface , OpenGLSurface , RasterGLSurface , OpenVGSurface , VulkanSurface , MetalSurface , Direct3DSurface }
	The SurfaceType enum describes what type of surface this is. More...

Public Slots
void	setSource (const QUrl &)
	Sets the source to the url, loads the QML component and instantiates it.

void	loadFromModule (QAnyStringView uri, QAnyStringView typeName)

void	setInitialProperties (const QVariantMap &initialProperties)
	Sets the initial properties initialProperties with which the QML component gets initialized after calling \l QQuickView::setSource().

void	setContent (const QUrl &url, QQmlComponent component, QObject item)

Public Slots inherited from QQuickWindow
void	update ()
	Schedules the window to render another frame.

void	releaseResources ()
	This function tries to release redundant resources currently held by the QML scene.

Public Slots inherited from QWindow
	Q_REVISION (2, 1) void requestActivate()

void	setVisible (bool visible)

void	show ()
	Shows the window.

void	hide ()
	Hides the window.

void	showMinimized ()
	Shows the window as minimized.

void	showMaximized ()
	Shows the window as maximized.

void	showFullScreen ()
	Shows the window as fullscreen.

void	showNormal ()
	Shows the window as normal, i.e.

bool	close ()
	Close the window.

void	raise ()
	Raise the window in the windowing system.

void	lower ()
	Lower the window in the windowing system.

bool	startSystemResize (Qt::Edges edges)
	Start a system-specific resize operation.

bool	startSystemMove ()
	Start a system-specific move operation.

void	setTitle (const QString &)

void	setX (int arg)

void	setY (int arg)

void	setWidth (int arg)

void	setHeight (int arg)

void	setGeometry (int posx, int posy, int w, int h)
	Sets the geometry of the window, excluding its window frame, to a rectangle constructed from posx, posy, w and h.

void	setGeometry (const QRect &rect)
	Sets the geometry of the window, excluding its window frame, to rect.

void	setMinimumWidth (int w)

void	setMinimumHeight (int h)

void	setMaximumWidth (int w)

void	setMaximumHeight (int h)

	Q_REVISION (2, 1) void alert(int msec)

	Q_REVISION (2, 3) void requestUpdate()

Public Slots inherited from QObject
void	deleteLater ()
	\threadsafe

Signals
void	statusChanged (QQuickView::Status)
	This signal is emitted when the component's current status changes.

Signals inherited from QQuickWindow
void	frameSwapped ()
	This signal is emitted when a frame has been queued for presenting.

void	sceneGraphInitialized ()
	\qmlsignal QtQuick::Window::frameSwapped()

void	sceneGraphInvalidated ()
	\qmlsignal QtQuick::Window::sceneGraphInitialized()

void	beforeSynchronizing ()
	This signal is emitted before the scene graph is synchronized with the QML state.

	Q_REVISION (2, 2) void afterSynchronizing()

void	beforeRendering ()
	\qmlsignal QtQuick::Window::afterSynchronizing()

void	afterRendering ()
	\qmlsignal QtQuick::Window::beforeRendering()

	Q_REVISION (2, 2) void afterAnimating()

	Q_REVISION (2, 2) void sceneGraphAboutToStop()

	Q_REVISION (2, 1) void closing(QQuickCloseEvent *close)

void	colorChanged (const QColor &)

	Q_REVISION (2, 1) void activeFocusItemChanged()

Q_REVISION(2, 2) void sceneGraphError(QQuickWindow	Q_REVISION (2, 14) void beforeRenderPassRecording()

	Q_REVISION (2, 14) void afterRenderPassRecording()

	Q_REVISION (6, 0) void paletteChanged()

	Q_REVISION (6, 0) void paletteCreated()

	Q_REVISION (6, 0) void beforeFrameBegin()

	Q_REVISION (6, 0) void afterFrameEnd()

Signals inherited from QWindow
void	screenChanged (QScreen *screen)
	This signal is emitted when a window's screen changes, either by being set explicitly with setScreen(), or automatically when the window's screen is removed.

void	modalityChanged (Qt::WindowModality modality)
	This signal is emitted when the Qwindow::modality property changes to modality.

void	windowStateChanged (Qt::WindowState windowState)
	This signal is emitted when the windowState changes, either by being set explicitly with setWindowStates(), or automatically when the user clicks one of the titlebar buttons or by other means.

	Q_REVISION (2, 2) void windowTitleChanged(const QString &title)

void	xChanged (int arg)

void	yChanged (int arg)

void	widthChanged (int arg)

void	heightChanged (int arg)

void	minimumWidthChanged (int arg)

void	minimumHeightChanged (int arg)

void	maximumWidthChanged (int arg)

void	maximumHeightChanged (int arg)

void	visibleChanged (bool arg)

Q_REVISION(2, 1) void visibilityChanged(QWindow	Q_REVISION (2, 1) void activeChanged()

void	contentOrientationChanged (Qt::ScreenOrientation orientation)

void	focusObjectChanged (QObject *object)
	This signal is emitted when the final receiver of events tied to focus is changed to object.

	Q_REVISION (2, 1) void opacityChanged(qreal opacity)

	Q_REVISION (2, 13) void transientParentChanged(QWindow *transientParent)

Signals inherited from QObject
void	destroyed (QObject *=nullptr)
	This signal is emitted immediately before the object obj is destroyed, after any instances of QPointer have been notified, and cannot be blocked.

void	objectNameChanged (const QString &objectName, QPrivateSignal)
	This signal is emitted after the object's name has been changed.

Public Member Functions
	QQuickView (QWindow *parent=nullptr)
	Constructs a QQuickView with the given parent.

	QQuickView (QQmlEngine engine, QWindow parent)
	Constructs a QQuickView with the given QML engine and parent.

	QQuickView (const QUrl &source, QWindow *parent=nullptr)
	Constructs a QQuickView with the given QML source and parent.

	QQuickView (QAnyStringView uri, QAnyStringView typeName, QWindow *parent=nullptr)

	QQuickView (const QUrl &source, QQuickRenderControl *renderControl)

	~QQuickView () override
	Destroys the QQuickView.

QUrl	source () const
	Returns the source URL, if set.

QQmlEngine *	engine () const
	Returns a pointer to the QQmlEngine used for instantiating QML Components.

QQmlContext *	rootContext () const
	This function returns the root of the context hierarchy.

QQuickItem *	rootObject () const
	Returns the view's root \l {QQuickItem} {item}.

ResizeMode	resizeMode () const

void	setResizeMode (ResizeMode)

Status	status () const

QList< QQmlError >	errors () const
	Return the list of errors that occurred during the last compile or create operation.

QSize	sizeHint () const

QSize	initialSize () const
	Returns the initial size of the root object.

Public Member Functions inherited from QObject
Q_INVOKABLE	QObject (QObject *parent=nullptr)
	Constructs an object with parent object parent.

virtual	~QObject ()
	Destroys the object, deleting all its child objects.

virtual bool	eventFilter (QObject watched, QEvent event)
	Filters events if this object has been installed as an event filter for the watched object.

QString	objectName () const

Q_WEAK_OVERLOAD void	setObjectName (const QString &name)
	Sets the object's name to name.

void	setObjectName (QAnyStringView name)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

QBindable< QString >	bindableObjectName ()

bool	isWidgetType () const
	Returns `true` if the object is a widget; otherwise returns `false`.

bool	isWindowType () const
	Returns `true` if the object is a window; otherwise returns `false`.

bool	isQuickItemType () const
	Returns `true` if the object is a QQuickItem; otherwise returns `false`.

bool	signalsBlocked () const noexcept
	Returns `true` if signals are blocked; otherwise returns `false`.

bool	blockSignals (bool b) noexcept
	If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it).

QThread *	thread () const
	Returns the thread in which the object lives.

bool	moveToThread (QThread *thread QT6_DECL_NEW_OVERLOAD_TAIL)
	Changes the thread affinity for this object and its children and returns `true` on success.

int	startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer)
	This is an overloaded function that will start a timer of type timerType and a timeout of interval milliseconds.

int	startTimer (std::chrono::nanoseconds time, Qt::TimerType timerType=Qt::CoarseTimer)

void	killTimer (int id)
	Kills the timer with timer identifier, id.

void	killTimer (Qt::TimerId id)

template<typename T >
T	findChild (QAnyStringView aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
	Returns the child of this object that can be cast into type T and that is called name, or \nullptr if there is no such object.

template<typename T >
QList< T >	findChildren (QAnyStringView aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
	Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects.

template<typename T >
T	findChild (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

template<typename T >
QList< T >	findChildren (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

const QObjectList &	children () const
	Returns a list of child objects.

void	setParent (QObject *parent)
	Makes the object a child of parent.

void	installEventFilter (QObject *filterObj)
	Installs an event filter filterObj on this object.

void	removeEventFilter (QObject *obj)
	Removes an event filter object obj from this object.

QMetaObject::Connection	connect (const QObject sender, const char signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const

bool	disconnect (const char signal=nullptr, const QObject receiver=nullptr, const char *member=nullptr) const

bool	disconnect (const QObject receiver, const char member=nullptr) const

void	dumpObjectTree () const
	Dumps a tree of children to the debug output.

void	dumpObjectInfo () const
	Dumps information about signal connections, etc.

bool	setProperty (const char *name, const QVariant &value)
	Sets the value of the object's name property to value.

bool	setProperty (const char *name, QVariant &&value)

QVariant	property (const char *name) const
	Returns the value of the object's name property.

QList< QByteArray >	dynamicPropertyNames () const

QBindingStorage *	bindingStorage ()

const QBindingStorage *	bindingStorage () const

QObject *	parent () const
	Returns a pointer to the parent object.

bool	inherits (const char *classname) const
	Returns `true` if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns `false`.

Public Member Functions inherited from QSurface
virtual	~QSurface ()
	Destroys the surface.

SurfaceClass	surfaceClass () const
	Returns the surface class of this surface.

virtual QPlatformSurface *	surfaceHandle () const =0
	Returns a handle to the platform-specific implementation of the surface.

bool	supportsOpenGL () const
	Returns true if the surface is OpenGL compatible and can be used in conjunction with QOpenGLContext; otherwise returns false.

Protected Member Functions
void	resizeEvent (QResizeEvent *) override

void	timerEvent (QTimerEvent *) override

void	keyPressEvent (QKeyEvent *) override
	\reimp

void	keyReleaseEvent (QKeyEvent *) override
	\reimp

void	mousePressEvent (QMouseEvent *) override
	\reimp

void	mouseReleaseEvent (QMouseEvent *) override
	\reimp

void	mouseMoveEvent (QMouseEvent *) override
	\reimp

Protected Member Functions inherited from QQuickWindow
	QQuickWindow (QQuickWindowPrivate &dd, QWindow *parent=nullptr)

	QQuickWindow (QQuickWindowPrivate &dd, QQuickRenderControl *control)

void	exposeEvent (QExposeEvent *) override
	\reimp

void	resizeEvent (QResizeEvent *) override
	\reimp

void	showEvent (QShowEvent *) override
	\reimp

void	hideEvent (QHideEvent *) override
	\reimp

void	closeEvent (QCloseEvent *) override
	\reimp

void	focusInEvent (QFocusEvent *) override
	\reimp

void	focusOutEvent (QFocusEvent *) override
	\reimp

bool	event (QEvent *) override
	\reimp

void	keyPressEvent (QKeyEvent *) override
	\reimp

void	keyReleaseEvent (QKeyEvent *) override
	\reimp

void	mousePressEvent (QMouseEvent *) override
	\reimp

void	mouseReleaseEvent (QMouseEvent *) override
	\reimp

void	mouseDoubleClickEvent (QMouseEvent *) override
	\reimp

void	mouseMoveEvent (QMouseEvent *) override
	\reimp

Protected Member Functions inherited from QWindow
virtual void	paintEvent (QPaintEvent *)
	The paint event (ev) is sent by the window system whenever an area of the window needs a repaint, for example when initially showing the window, or due to parts of the window being uncovered by moving another window.

virtual void	moveEvent (QMoveEvent *)
	Override this to handle window move events (ev).

virtual void	touchEvent (QTouchEvent *)
	Override this to handle touch events (ev).

virtual bool	nativeEvent (const QByteArray &eventType, void message, qintptr result)
	Override this to handle platform dependent events.

	QWindow (QWindowPrivate &dd, QWindow *parent)
	Creates a window as a child of the given parent window with the dd private implementation.

Protected Member Functions inherited from QObject
QObject *	sender () const
	Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns \nullptr.

int	senderSignalIndex () const

int	receivers (const char *signal) const
	Returns the number of receivers connected to the signal.

bool	isSignalConnected (const QMetaMethod &signal) const

virtual void	childEvent (QChildEvent *event)
	This event handler can be reimplemented in a subclass to receive child events.

virtual void	customEvent (QEvent *event)
	This event handler can be reimplemented in a subclass to receive custom events.

virtual void	connectNotify (const QMetaMethod &signal)

virtual void	disconnectNotify (const QMetaMethod &signal)

	QObject (QObjectPrivate &dd, QObject *parent=nullptr)

Protected Member Functions inherited from QSurface
	QSurface (SurfaceClass type)
	Creates a surface with the given type.

Properties
ResizeMode	resizeMode
	whether the view should resize the window contents

Status	status
	The component's current \l{QQuickView::Status} {status}.

QUrl	source
	The URL of the source of the QML component.

Properties inherited from QQuickWindow
QColor	color
	\qmlproperty color Window::color

QQuickItem *	contentItem
	\qmlattachedproperty Item Window::contentItem

QQuickItem *	activeFocusItem
	The item which currently has active focus or `null` if there is no item with active focus.

Properties inherited from QWindow
QString	title
	the window's title in the windowing system

Qt::WindowModality	modality
	the modality of the window

Qt::WindowFlags	flags
	the window flags of the window

int	x
	the x position of the window's geometry

int	y
	the y position of the window's geometry

int	width
	the width of the window's geometry

int	height
	the height of the window's geometry

int	minimumWidth
	the minimum width of the window's geometry

int	minimumHeight
	the minimum height of the window's geometry

int	maximumWidth
	the maximum width of the window's geometry

int	maximumHeight
	the maximum height of the window's geometry

bool	visible
	whether the window is visible or not

bool	active
	the active status of the window

Visibility	visibility
	the screen-occupation state of the window

Qt::ScreenOrientation	contentOrientation
	the orientation of the window's contents

qreal	opacity
	The opacity of the window in the windowing system.

Properties inherited from QObject
QString	objectName
	the name of this object

Additional Inherited Members
Static Public Member Functions inherited from QObject
static QMetaObject::Connection	connect (const QObject sender, const char signal, const QObject receiver, const char member, Qt::ConnectionType=Qt::AutoConnection)
	\threadsafe

static QMetaObject::Connection	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)

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

template<typename Func1 , typename Func2 >
static QMetaObject::Connection	connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 &&slot)

static bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char member)
	\threadsafe

static bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &member)

static bool	disconnect (const QMetaObject::Connection &)
	Disconnect a connection.

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

template<typename Func1 >
static bool	disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object sender, Func1 signal, const QObject receiver, void **zero)

Protected Attributes inherited from QObject
QScopedPointer< QObjectData >	d_ptr

Protected Attributes inherited from QSurface
SurfaceClass	m_type

QSurfacePrivate *	m_reserved

Related Symbols inherited from QObject
template< class T > T	qobject_cast (const QObject *object)
	Returns the given object cast to type T if the object is of type T (or of a subclass); otherwise returns \nullptr.

template< typename T > T	qFindChildqFindChildren (const QObject *obj, const QString &name)()

template< typename T > QList< T >	qFindChildrenqFindChildren (const QObject *obj, const QString &name)()

	QObjectList
	\macro Q_CLASSINFO(Name, Value)

Detailed Description

The QQuickView class provides a window for displaying a Qt Quick user interface.

Since: 5.0

\inmodule QtQuick

This is a convenience subclass of QQuickWindow which will automatically load and display a QML scene when given the URL of the main source file. Alternatively, you can instantiate your own objects using QQmlComponent and place them in a manually setup QQuickWindow.

Typical usage:

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);
 
    QQuickView *view = new QQuickView;
    view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
    view->show();
    return app.exec();
}

To receive errors related to loading and executing QML with QQuickView, you can connect to the statusChanged() signal and monitor for QQuickView::Error. The errors are available via QQuickView::errors().

QQuickView also manages sizing of the view and root object. By default, the \l resizeMode is SizeViewToRootObject, which will load the component and resize it to the size of the view. Alternatively the resizeMode may be set to SizeRootObjectToView which will resize the view to the size of the root object.

See also: {Exposing Attributes of C++ Types to QML}, QQuickWidget

Definition at line 19 of file qquickview.h.

Member Enumeration Documentation

◆ ResizeMode

enum QQuickView::ResizeMode

This enum specifies how to resize the view.

\value SizeViewToRootObject The view resizes with the root item in the QML. \value SizeRootObjectToView The view will automatically resize the root item to the size of the view.

Enumerator
SizeViewToRootObject
SizeRootObjectToView

Definition at line 40 of file qquickview.h.

◆ Status

enum QQuickView::Status

Specifies the loading status of the QQuickView.

\value Null This QQuickView has no source set. \value Ready This QQuickView has loaded and created the QML component. \value Loading This QQuickView is loading network data. \value Error One or more errors has occurred. Call errors() to retrieve a list of errors.

Enumerator
Null
Ready
Loading
Error

Definition at line 45 of file qquickview.h.

Constructor & Destructor Documentation

◆ QQuickView() [1/5]

QQuickView::QQuickView ( QWindow * parent = nullptr )

explicit

Constructs a QQuickView with the given parent.

The default value of parent is 0.

Definition at line 148 of file qquickview.cpp.

◆ QQuickView() [2/5]

QQuickView::QQuickView	(	QQmlEngine *	engine,
		QWindow *	parent )

Constructs a QQuickView with the given QML engine and parent.

Note: In this case, the QQuickView does not own the given engine object; it is the caller's responsibility to destroy the engine. If the engine is deleted before the view, status() will return QQuickView::Error.

See also: Status, status(), errors()

Definition at line 187 of file qquickview.cpp.

◆ QQuickView() [3/5]

QQuickView::QQuickView	(	const QUrl &	source,
		QWindow *	parent = nullptr )

explicit

Constructs a QQuickView with the given QML source and parent.

The default value of parent is {nullptr}.

Definition at line 159 of file qquickview.cpp.

◆ QQuickView() [4/5]

QQuickView::QQuickView	(	QAnyStringView	uri,
		QAnyStringView	typeName,
		QWindow *	parent = nullptr )

explicit

Since: 6.7 Constructs a QQuickView with the element specified by uri and typeName and parent parent. The default value of parent is {nullptr}.

See also: loadFromModule

Definition at line 172 of file qquickview.cpp.

◆ QQuickView() [5/5]

QQuickView::QQuickView	(	const QUrl &	source,
		QQuickRenderControl *	control )

Definition at line 197 of file qquickview.cpp.

◆ ~QQuickView()

QQuickView::~QQuickView ( )

override

Destroys the QQuickView.

Definition at line 207 of file qquickview.cpp.

Member Function Documentation

◆ engine()

QQmlEngine * QQuickView::engine ( ) const

Returns a pointer to the QQmlEngine used for instantiating QML Components.

Definition at line 322 of file qquickview.cpp.

◆ errors()

QList< QQmlError > QQuickView::errors ( ) const

Return the list of errors that occurred during the last compile or create operation.

When the status is not Error, an empty list is returned.

Definition at line 384 of file qquickview.cpp.

◆ initialSize()

QSize QQuickView::initialSize ( ) const

Returns the initial size of the root object.

If \l resizeMode is QQuickItem::SizeRootObjectToView the root object will be resized to the size of the view. initialSize contains the size of the root object before it was resized.

Definition at line 621 of file qquickview.cpp.

◆ keyPressEvent()

void QQuickView::keyPressEvent ( QKeyEvent * e )

overrideprotectedvirtual

\reimp

Reimplemented from QWindow.

Definition at line 651 of file qquickview.cpp.

◆ keyReleaseEvent()

void QQuickView::keyReleaseEvent ( QKeyEvent * e )

overrideprotectedvirtual

\reimp

Reimplemented from QWindow.

Definition at line 657 of file qquickview.cpp.

◆ loadFromModule

void QQuickView::loadFromModule	(	QAnyStringView	uri,
		QAnyStringView	typeName )

slot

Since: 6.7 Loads the QML component identified by uri and typeName. If the component is backed by a QML file, \l{source} will be set accordingly. For types defined in {C++}, {source} will be empty.

If any \l{source} was set before this method was called, it will be cleared.

Calling this method multiple times with the same uri and typeName will result in the QML component being reinstantiated.

See also: setSource, QQmlComponent::loadFromModule, QQmlApplicationEngine::loadFromModule

Definition at line 255 of file qquickview.cpp.

◆ mouseMoveEvent()

void QQuickView::mouseMoveEvent ( QMouseEvent * e )

overrideprotectedvirtual

\reimp

Reimplemented from QWindow.

Definition at line 663 of file qquickview.cpp.

◆ mousePressEvent()

void QQuickView::mousePressEvent ( QMouseEvent * e )

overrideprotectedvirtual

\reimp

Reimplemented from QWindow.

Definition at line 669 of file qquickview.cpp.

◆ mouseReleaseEvent()

void QQuickView::mouseReleaseEvent ( QMouseEvent * e )

overrideprotectedvirtual

\reimp

Reimplemented from QWindow.

Definition at line 675 of file qquickview.cpp.

◆ resizeEvent()

void QQuickView::resizeEvent ( QResizeEvent * e )

overrideprotectedvirtual

This function handles the \l {QResizeEvent} {resize event} e.

Reimplemented from QWindow.

Definition at line 641 of file qquickview.cpp.

◆ resizeMode()

QQuickView::ResizeMode QQuickView::resizeMode ( ) const

Definition at line 490 of file qquickview.cpp.

◆ rootContext()

QQmlContext * QQuickView::rootContext ( ) const

This function returns the root of the context hierarchy.

Each QML component is instantiated in a QQmlContext. QQmlContext's are essential for passing data to QML components. In QML, contexts are arranged hierarchically and this hierarchy is managed by the QQmlEngine.

Definition at line 335 of file qquickview.cpp.

◆ rootObject()

QQuickItem * QQuickView::rootObject ( ) const

Returns the view's root \l {QQuickItem} {item}.

Definition at line 630 of file qquickview.cpp.

◆ setContent

void QQuickView::setContent	(	const QUrl &	url,
		QQmlComponent *	component,
		QObject *	item )

slot

Set the source url, component and content item (root of the QML object hierarchy) directly.

Definition at line 286 of file qquickview.cpp.

◆ setInitialProperties

void QQuickView::setInitialProperties ( const QVariantMap & initialProperties )

slot

Sets the initial properties initialProperties with which the QML component gets initialized after calling \l QQuickView::setSource().

    QScopedPointer<QQuickView> view { new QQuickView };
    view->setInitialProperties({"x, 100"}, {"width", 50});
    view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
    view->show();

Note: You can only use this function to initialize top-level properties.; This function should always be called before setSource, as it has no effect once the component has become Ready.

See also: QQmlComponent::createWithInitialProperties()

Since: 5.14

Definition at line 275 of file qquickview.cpp.

◆ setResizeMode()

void QQuickView::setResizeMode ( ResizeMode mode )

Definition at line 418 of file qquickview.cpp.

◆ setSource

void QQuickView::setSource ( const QUrl & url )

slot

Sets the source to the url, loads the QML component and instantiates it.

Ensure that the URL provided is full and correct, in particular, use \l QUrl::fromLocalFile() when loading a file from the local filesystem.

Calling this method multiple times with the same url will result in the QML component being reinstantiated.

Definition at line 235 of file qquickview.cpp.

◆ sizeHint()

QSize QQuickView::sizeHint ( ) const

Preferred size follows the root object geometry.

Definition at line 603 of file qquickview.cpp.

◆ source()

QUrl QQuickView::source ( ) const

Returns the source URL, if set.

See also: setSource()

Definition at line 312 of file qquickview.cpp.

◆ status()

QQuickView::Status QQuickView::status ( ) const

Definition at line 365 of file qquickview.cpp.

◆ statusChanged

void QQuickView::statusChanged ( QQuickView::Status status )

signal

This signal is emitted when the component's current status changes.

◆ timerEvent()

void QQuickView::timerEvent ( QTimerEvent * e )

overrideprotectedvirtual

If the \l {QTimerEvent} {timer event} e is this view's resize timer, sceneResized() is emitted.

Reimplemented from QObject.

Definition at line 590 of file qquickview.cpp.

Property Documentation

◆ resizeMode

ResizeMode QQuickView::resizeMode

readwrite

whether the view should resize the window contents

If this property is set to SizeViewToRootObject (the default), the view resizes to the size of the root item in the QML.

If this property is set to SizeRootObjectToView, the view will automatically resize the root item to the size of the view.

See also: initialSize()

Definition at line 22 of file qquickview.h.

◆ source

QUrl QQuickView::source

readwrite

The URL of the source of the QML component.

Ensure that the URL provided is full and correct, in particular, use \l QUrl::fromLocalFile() when loading a file from the local filesystem.

Note that setting a source URL will result in the QML component being instantiated, even if the URL is unchanged from the current value.

Definition at line 24 of file qquickview.h.

◆ status

Status QQuickView::status

read

The component's current \l{QQuickView::Status} {status}.

Definition at line 23 of file qquickview.h.

The documentation for this class was generated from the following files:

qtdeclarative/src/quick/items/qquickview.h (bd131dcbf579f822ac8cee98324dc1355f7cd314)
qtdeclarative/src/quick/items/qquickview.cpp (82971e75b8e55ea14b6cbdb77ba6f280cd0c7bd5)

Public Types

Public Slots

Signals

Public Member Functions

Protected Member Functions

Properties

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ ResizeMode

◆ Status

Constructor & Destructor Documentation

◆ QQuickView() [1/5]

◆ QQuickView() [2/5]

◆ QQuickView() [3/5]

◆ QQuickView() [4/5]

◆ QQuickView() [5/5]

◆ ~QQuickView()

Member Function Documentation

◆ engine()

◆ errors()

◆ initialSize()

◆ keyPressEvent()

◆ keyReleaseEvent()

◆ loadFromModule

◆ mouseMoveEvent()

◆ mousePressEvent()

◆ mouseReleaseEvent()

◆ resizeEvent()

◆ resizeMode()

◆ rootContext()

◆ rootObject()

◆ setContent

◆ setInitialProperties

◆ setResizeMode()

◆ setSource

◆ sizeHint()

◆ source()

◆ status()

◆ statusChanged

◆ timerEvent()

Property Documentation

◆ resizeMode

◆ source

◆ status