QWaylandQuickItem Class
QWaylandQuickItem 클래스는 QWaylandView 을 나타내는 Qt Quick 항목을 제공합니다.. ..
| 헤더: | #include <QWaylandQuickItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
| QML에서: | WaylandQuickItem |
| 상속합니다: | QQuickItem |
| 상속 대상: |
속성
|
|
공용 함수
| QWaylandQuickItem(QQuickItem *parent = nullptr) | |
| virtual | ~QWaylandQuickItem() override |
| bool | allowDiscardFrontBuffer() const |
| QWaylandCompositor * | compositor() const |
| bool | focusOnClick() const |
| bool | inputEventsEnabled() const |
| bool | inputRegionContains(const QPointF &localPosition) const |
| bool | isBufferLocked() const |
| bool | isPaintEnabled() const |
| QPointF | mapFromSurface(const QPointF &point) const |
| QPointF | mapToSurface(const QPointF &point) const |
| QWaylandSurface::Origin | origin() const |
| QWaylandOutput * | output() const |
| void | setAllowDiscardFrontBuffer(bool discard) |
| void | setBufferLocked(bool locked) |
| void | setFocusOnClick(bool focus) |
| void | setInputEventsEnabled(bool enabled) |
| void | setOutput(QWaylandOutput *output) |
| void | setPrimary() |
| void | setSubsurfaceHandler(QObject *) |
| void | setSurface(QWaylandSurface *surface) |
| void | setTouchEventsEnabled(bool enabled) |
| QObject * | subsurfaceHandler() const |
| QWaylandSurface * | surface() const |
| bool | touchEventsEnabled() const |
| QWaylandView * | view() const |
재구현된 공용 함수
| virtual QSGTextureProvider * | textureProvider() const override |
공용 슬롯
| void | setPaintEnabled(bool paintEnabled) |
| virtual void | takeFocus(QWaylandSeat *device = nullptr) |
신호
| void | allowDiscardFrontBufferChanged() |
| void | bufferLockedChanged() |
| void | compositorChanged() |
| void | focusOnClickChanged() |
| void | inputEventsEnabledChanged() |
| void | originChanged() |
| void | outputChanged() |
| void | paintEnabledChanged() |
| void | subsurfaceHandlerChanged() |
| void | surfaceChanged() |
| void | surfaceDestroyed() |
| void | touchEventsEnabledChanged() |
상세 설명
Qt Quick 에 QWaylandCompositor 를 작성할 때 이 클래스는 클라이언트의 콘텐츠를 출력 장치에 표시하는 데 사용할 수 있으며, 사용자 입력을 클라이언트에 전달합니다.
프로퍼티 문서
allowDiscardFrontBuffer : bool
기본적으로 이 항목은 새 버퍼를 사용할 수 있고 updatePaintNode()가 호출될 때까지 현재 버퍼를 잠급니다. 이 속성을 true로 설정하면 스로틀링 뷰가 더 이상 버퍼를 사용하지 않을 때 Qt가 버퍼를 즉시 해제할 수 있습니다. 업데이트 간격이 느린 항목에 유용합니다.
함수 액세스:
| bool | allowDiscardFrontBuffer() const |
| void | setAllowDiscardFrontBuffer(bool discard) |
알림 신호:
| void | allowDiscardFrontBufferChanged() |
bufferLocked : bool
이 속성은 아이템의 버퍼가 현재 잠겨 있는지 여부를 저장합니다. 버퍼가 잠겨 있는 동안에는 해제되지 않고 클라이언트에 반환됩니다.
기본값은 false입니다.
액세스 함수:
| bool | isBufferLocked() const |
| void | setBufferLocked(bool locked) |
알림 신호:
| void | bufferLockedChanged() |
[read-only] compositor : QWaylandCompositor* const
이 프로퍼티는 이 QWaylandQuickItem 에 의해 렌더링된 표면의 컴포짓을 보유합니다.
함수에 액세스합니다:
| QWaylandCompositor * | compositor() const |
노티파이 신호:
| void | compositorChanged() |
focusOnClick : bool
이 속성은 QWaylandQuickItem 을 클릭하거나 터치할 때 포커스를 가져올지 여부를 지정합니다.
기본값은 true 입니다.
액세스 함수:
| bool | focusOnClick() const |
| void | setFocusOnClick(bool focus) |
알림 신호:
| void | focusOnClickChanged() |
[read-only] origin : const QWaylandSurface::Origin
이 속성은 QWaylandQuickItem 의 원본을 보유합니다.
액세스 함수입니다:
| QWaylandSurface::Origin | origin() const |
알림 신호:
| void | originChanged() |
output : QWaylandOutput*
이 속성은 이 항목이 표시되는 출력을 보유합니다.
함수에 액세스합니다:
| QWaylandOutput * | output() const |
| void | setOutput(QWaylandOutput *output) |
알림 신호:
| void | outputChanged() |
paintEnabled : bool
텍스처는 계속 업데이트되지만 항목이 숨겨져 있는 경우 true 을 유지합니다. visible 을 false 으로 설정하여 항목을 숨기는 것과 달리 이 속성을 false 으로 설정해도 마우스 또는 키보드 입력이 항목에 도달하는 것을 막지는 않습니다.
액세스 기능:
| bool | isPaintEnabled() const |
| void | setPaintEnabled(bool paintEnabled) |
알림 신호:
| void | paintEnabledChanged() |
surface : QWaylandSurface*
이 프로퍼티는 이 QWaylandQuickItem 에 의해 렌더링된 표면을 보유합니다.
함수에 액세스합니다:
| QWaylandSurface * | surface() const |
| void | setSurface(QWaylandSurface *surface) |
노티파이 신호:
| void | surfaceChanged() |
touchEventsEnabled : bool
이 프로퍼티는 터치 이벤트가 클라이언트 표면으로 전달되면 true, 그렇지 않으면 false 을 보유합니다.
액세스 함수:
| bool | touchEventsEnabled() const |
| void | setTouchEventsEnabled(bool enabled) |
알림 신호:
| void | touchEventsEnabledChanged() |
멤버 함수 문서
QWaylandQuickItem::QWaylandQuickItem(QQuickItem *parent = nullptr)
주어진 parent 으로 QWaylandQuickItem을 생성합니다.
[override virtual noexcept] QWaylandQuickItem::~QWaylandQuickItem()
QWaylandQuickItem 을 삭제합니다.
bool QWaylandQuickItem::inputRegionContains(const QPointF &localPosition) const
이 항목의 표면 입력 영역에 localPosition 에 지정된 위치가 포함된 경우 true 를 반환합니다.
[invokable] QPointF QWaylandQuickItem::mapFromSurface(const QPointF &point) const
웨이랜드 서페이스 좌표계에서 지정된 point 을 이 항목의 좌표계 내 등가 지점에 매핑하고 매핑된 좌표를 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
[invokable] QPointF QWaylandQuickItem::mapToSurface(const QPointF &point) const
이 항목의 좌표계에서 지정된 point 을 웨이랜드 서페이스의 좌표계 내의 등가 지점에 매핑하고 매핑된 좌표를 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
[invokable] void QWaylandQuickItem::setPrimary()
이 QWaylandQuickItem 의 뷰를 서페이스의 기본 뷰로 만듭니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
QWaylandSurface::primaryView도 참조하십시오 .
[signal] void QWaylandQuickItem::surfaceDestroyed()
이 신호는 클라이언트가 QWaylandQuickItem 과 연결된 wl_surface 을 파괴했을 때 발생합니다. 이 신호의 핸들러는 QWaylandQuickItem 을 즉시 파괴하거나 닫기 애니메이션을 시작한 다음 항목을 파괴할 것으로 예상됩니다.
애니메이션이 시작되면 애니메이션이 끝날 때까지 항목의 콘텐츠가 유지되도록 bufferLocked 을 설정해야 합니다.
QWaylandQuickItem::bufferLocked 를참조하세요 .
[virtual slot] void QWaylandQuickItem::takeFocus(QWaylandSeat *device = nullptr)
이 함수를 호출하면 항목이 입력의 포커스를 가져옵니다 device.
[override virtual] QSGTextureProvider *QWaylandQuickItem::textureProvider() const
재구현합니다: QQuickItem::textureProvider() const.
이 QWaylandQuickItem 의 텍스처 프로바이더를 반환합니다.
QWaylandView *QWaylandQuickItem::view() const
이 렌더링된 보기를 반환합니다 QWaylandQuickItem.
© 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.
