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
이 프로퍼티에는 URL 기반 이미지 소비자(예: QtQuick::Image 유형)와 함께 사용할 수 있는 URL이 저장됩니다.
URL은 QQuickItemGrabResult 객체가 삭제될 때까지 유효합니다.
URL은 유효한 파일이나 읽을 위치를 나타내지 않으며, 주로 Qt Quick 의 이미지 기반 유형을 통해 이미지에 액세스하기 위한 키입니다.
액세스 함수:
| QUrl | url() const |
멤버 함수 문서
[signal] void QQuickItemGrabResult::ready()
이 신호는 그랩이 완료되면 발산됩니다.
[invokable] bool QQuickItemGrabResult::saveToFile(const QString &fileName) const
수집 결과를 이미지로 fileName 에 저장합니다. 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
참고: 5.9 이전 Qt 버전에서 이 함수는 비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에 도입되었습니다.
© 2025 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.
