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.
