QQuickItemGrabResult Class
QQuickItemGrabResult には、QQuickItem::grabToImage() の結果が含まれます。詳細...
| ヘッダー: | #include <QQuickItemGrabResult> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| QML内: | ItemGrabResult |
| 継承元: | QObject |
プロパティ
パブリック関数
| QImage | image() const |
| bool | saveToFile(const QString &fileName) const |
(since 6.2) bool | saveToFile(const QUrl &filePath) const |
| QUrl | url() const |
シグナル
| void | ready() |
関連項目： QQuickItem::grabToImage()。
プロパティのドキュメント
[read-only] image : const QImage
このプロパティには、グラブ操作の結果として得られたピクセルデータが格納されます。
グラブがまだ完了していない場合や、失敗した場合は、null 画像が返されます（image.isNull() はtrue を返します）。
アクセス関数：
| QImage | image() const |
[read-only] url : const QUrl
このプロパティには、QtQuick::Image 型などの URL ベースの画像コンシューマーと組み合わせて使用できる URL が格納されます。
この URL は、QQuickItemGrabResult オブジェクトが削除されるまで有効です。
この URL は、有効なファイルや読み込み元を表すものではなく、主にQt Quick の画像ベースの型を通じて画像にアクセスするためのキーとして機能します。
アクセス関数:
| QUrl | url() const |
メンバ関数のドキュメント
[signal] void QQuickItemGrabResult::ready()
この信号は、グラブが作業を完了したときに発信されます。
[invokable] bool QQuickItemGrabResult::saveToFile(const QString &fileName) const
キャプチャ結果を画像としてfileName に保存します。成功した場合はtrue を返し、失敗した場合はfalse を返します。
注： Qt 5.9 以前のバージョンでは 、この関数はconst としてマークされていません。
注：この関数は 、メタオブジェクトシステムや QML から呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable, since 6.2] bool QQuickItemGrabResult::saveToFile(const QUrl &filePath) const
キャプチャ結果を画像としてfilePath に保存します。このパスは、拡張子がsupported image format のlocal file name を指している必要があります。成功した場合はtrue を返し、失敗した場合はfalse を返します。
注：この関数は 、メタオブジェクトシステムや QML から呼び出すことができます。Q_INVOKABLE を参照してください。
この関数は Qt 6.2 で導入されました。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
