WaylandQuickItem QML Type

WaylandView...을 나타내는 Qt Quick 항목을 제공합니다... .

Import Statement: import QtWayland.Compositor
In C++: QWaylandQuickItem
Inherited By:

ShellSurfaceItem

속성

신호

방법

상세 설명

Qt Quick-기반 웨이랜드 컴포저는 이 유형을 사용하여 클라이언트의 콘텐츠를 출력 장치에 표시할 수 있습니다. 사용자 입력을 클라이언트에 전달합니다.

프로퍼티 문서

bufferLocked : bool

이 프로퍼티는 항목의 버퍼가 현재 잠겨 있는지 여부를 저장합니다. 버퍼가 잠겨 있는 한 해제되지 않고 클라이언트에 반환되지 않습니다.

기본값은 false입니다.


compositor : WaylandCompositor [read-only]

이 프로퍼티는 이 WaylandQuickItem 에 의해 렌더링된 표면의 컴포저를 보유합니다.


focusOnClick : bool

이 프로퍼티는 WaylandQuickItem 을 클릭하거나 터치할 때 포커스를 가져올지 여부를 지정합니다.

기본값은 true 입니다.


origin : enum [read-only]

이 속성은 QWaylandQuickItem 의 원점을 보유합니다.


output : WaylandOutput

이 속성은 이 항목이 표시되는 출력을 보유합니다.


paintEnabled : bool

텍스처는 계속 업데이트되지만 항목이 숨겨져 있으면 true를 반환합니다. visiblefalse 으로 설정하여 항목을 숨기는 것과 달리 이 속성을 false 으로 설정해도 마우스 또는 키보드 입력이 항목에 도달하지 못하도록 막지는 않습니다.


subsurfaceHandler : object

이 프로퍼티는 기본 서브서피스 동작을 재정의할 수 있는 방법을 제공합니다.

기본적으로 Qt는 이 항목의 자식으로 새 SurfaceItem을 생성하고 올바른 위치를 유지합니다.

기본값을 재정의하려면 이 프로퍼티에 핸들러 객체를 할당합니다. 핸들러는 handleSubsurfaceAdded(WaylandSurface) 함수를 구현해야 합니다.

ShellSurfaceItem {
    subsurfaceHandler: QtObject {
        function handleSubsurfaceAdded(child) {
          // create custom surface item, and connect the subsurfacePositionChanged signal
        }
    }
}

이 프로퍼티의 기본값은 null 입니다.


surface : WaylandSurface

이 프로퍼티는 이 WaylandQuickItem 에 의해 렌더링된 표면을 보유합니다.


touchEventsEnabled : bool

이 프로퍼티는 터치 이벤트가 클라이언트 표면으로 전달되는 경우 true, 그렇지 않은 경우 false 을 보유합니다.


신호 문서

void surfaceDestroyed()

이 신호는 클라이언트가 WaylandQuickItem 과 연결된 wl_surface 을 소멸했을 때 발생합니다. 이 신호의 핸들러는 WaylandQuickItem 을 즉시 소멸하거나 닫기 애니메이션을 시작한 다음 항목을 소멸할 것으로 예상됩니다.

애니메이션이 시작되면 애니메이션이 끝날 때까지 항목의 콘텐츠가 유지되도록 bufferLocked 을 설정해야 합니다.

참고: 해당 핸들러는 onSurfaceDestroyed 입니다.

bufferLocked참조하세요 .


메서드 문서

point mapFromSurface(point point)

웨이랜드 서페이스 좌표계의 지정된 point 을 이 항목의 좌표계 내의 해당 지점에 매핑하고 매핑된 좌표를 반환합니다.


point mapToSurface(point point)

이 항목의 좌표계에서 지정된 point 을 웨이랜드 서페이스의 좌표계 내의 등가 점으로 매핑하고 매핑된 좌표를 반환합니다.


setPrimary()

WaylandQuickItem 을 서페이스의 기본 뷰로 만듭니다.


© 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.