QQuickItemGrabResult Class

The QQuickItemGrabResult contains the result from QQuickItem::grabToImage(). More...

Header: #include <QQuickItemGrabResult>
Instantiated By: ItemGrabResult
Inherits: QObject

Properties

Public Functions

QImage image() const
bool saveToFile(const QString &fileName) const
bool saveToFile(const QUrl &filePath) const
QUrl url() const

Signals

void ready()

Reimplemented Protected Functions

virtual bool event(QEvent *e) override

Detailed Description

\inmoduleQtQuick

See also QQuickItem::grabToImage().

Property Documentation

[read-only] image : const QImage

This property holds the pixel results from a grab.

If the grab is not yet complete or if it failed, a null image is returned (image.isNull() will return true).

Access functions:

QImage image() const

[read-only] url : const QUrl

This property holds a URL which can be used in conjunction with URL based image consumers, such as the QtQuick::Image type.

The URL is valid until the QQuickItemGrabResult object is deleted.

The URL does not represent a valid file or location to read it from, it is primarily a key to access images through Qt Quick's image-based types.

Access functions:

QUrl url() const

Member Function Documentation

[override virtual protected] bool QQuickItemGrabResult::event(QEvent *e)

Reimplements: QObject::event(QEvent *e).

\internal

[signal] void QQuickItemGrabResult::ready()

This signal is emitted when the grab has completed.

[invokable] bool QQuickItemGrabResult::saveToFile(const QString &fileName) const

Saves the grab result as an image to fileName. Returns true if successful; otherwise returns false.

Note: In Qt versions prior to 5.9, this function is marked as non-const.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[invokable] bool QQuickItemGrabResult::saveToFile(const QUrl &filePath) const

\since6.2 Saves the grab result as an image to filePath, which must refer to a local file name with a supported image format extension. Returns true if successful; otherwise returns false.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.