QWebEngineFullScreenRequest Class
QWebEngineFullScreenRequest 클래스는 전체 화면 모드 진입 및 종료 요청을 수락하거나 거부할 수 있습니다. 더 보기...
| Header: | #include <QWebEngineFullScreenRequest> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| QML에서: | FullScreenRequest |
속성
공공 기능
상세 설명
동영상과 같은 요소를 전체 화면 모드로 표시하려면 애플리케이션이 QWebEngineSettings::FullScreenSupportEnabled 를 설정하고 QWebEngineFullScreenRequest 인스턴스를 인수로 받는 QWebEnginePage::fullScreenRequested 에 연결해야 합니다.
웹 페이지의 요소가 전체 화면 모드로 표시되도록 요청하면 toggleOn()이 true 를 반환하는 QWebEngineFullScreenRequest 인스턴스를 인수로 사용하여 QWebEnginePage::fullScreenRequested 가 전송됩니다. 그런 다음 신호 처리기는 accept() 또는 reject()를 호출해야 합니다.
전체 화면 모드로 전환하라는 요청이 수락되면 전체 화면 모드를 요청하는 요소가 뷰포트를 채우지만 뷰를 전체 화면으로 만들거나 페이지를 전체 화면 모드에 있는 뷰로 이동하는 것은 애플리케이션의 몫입니다.
마찬가지로 사용자가 전체 화면 모드를 벗어나고 싶을 때(즉, QWebEnginePage::ExitFullScreen 컨텍스트 메뉴 동작을 통해) QWebEnginePage::fullScreenRequested 이 전송됩니다. 이 경우 toggleOn()는 false 을 반환하고 신호 처리기는 다시 accept() 또는 reject()로 요청을 보내야 합니다. 요청이 수락되면 애플리케이션은 전역 창 상태가 복원되었는지 확인해야 합니다.
속성 문서
[read-only] origin : const QUrl
이 속성에는 전체 화면 모드에서 열 URL이 저장됩니다.
액세스 기능:
| QUrl | origin() const |
[read-only] toggleOn : const bool
이 속성은 웹 페이지에서 전체 화면 모드로 전환하라는 요청을 발행했는지 여부를 저장합니다.
액세스 함수:
| bool | toggleOn() const |
멤버 함수 문서
[invokable] void QWebEngineFullScreenRequest::accept()
전체 화면 모드로 들어가거나 나가라는 요청을 수락합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
QUrl QWebEngineFullScreenRequest::origin() const
전체 화면 모드에서 열 URL을 반환합니다.
참고: 속성 원점에 대한 게터 함수입니다.
[invokable] void QWebEngineFullScreenRequest::reject()
전체 화면 모드로 들어가거나 나가라는 요청을 거부합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
bool QWebEngineFullScreenRequest::toggleOn() const
웹 페이지에서 전체 화면 모드로 전환하라는 요청이 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
참고: toggleOn 프로퍼티에 대한 게터 함수.
© 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.
