WaylandQuickItem QML Type
WaylandView...을 나타내는 Qt Quick 항목을 제공합니다... .
| Import Statement: | import QtWayland.Compositor |
| In C++: | QWaylandQuickItem |
| Inherited By: |
속성
- bufferLocked : bool
- compositor : WaylandCompositor
- focusOnClick : bool
- inputEventsEnabled : bool
- origin : enum
- output : WaylandOutput
- paintEnabled : bool
- subsurfaceHandler : object
- surface : WaylandSurface
- touchEventsEnabled : bool
신호
- void surfaceDestroyed()
방법
- point mapFromSurface(point point)
- point mapToSurface(point point)
- void setPrimary()
상세 설명
Qt Quick-기반 웨이랜드 컴포저는 이 유형을 사용하여 클라이언트의 콘텐츠를 출력 장치에 표시할 수 있습니다. 사용자 입력을 클라이언트에 전달합니다.
프로퍼티 문서
bufferLocked : bool
이 속성은 아이템의 버퍼가 현재 잠겨 있는지 여부를 저장합니다. 버퍼가 잠겨 있는 동안에는 해제되지 않고 클라이언트에 반환됩니다.
기본값은 false입니다.
compositor : WaylandCompositor [read-only]
이 프로퍼티는 이 WaylandQuickItem 에 의해 렌더링된 표면의 컴포저를 보유합니다.
focusOnClick : bool
이 속성은 WaylandQuickItem 을 클릭하거나 터치할 때 포커스를 가져올지 여부를 지정합니다.
기본값은 true 입니다.
inputEventsEnabled : bool
이 속성은 이 항목에 대한 입력 이벤트 활성화 여부를 저장합니다.
true 이면 항목이 키보드 및 마우스 이벤트와 같은 입력 이벤트를 처리하고 처리하며, false 이면 입력 이벤트가 무시됩니다.
origin : enum [read-only]
이 속성은 QWaylandQuickItem 의 출처를 보유합니다.
output : WaylandOutput
이 프로퍼티에는 이 항목이 표시되는 출력이 저장됩니다.
paintEnabled : bool
텍스처는 계속 업데이트되지만 항목이 숨겨져 있으면 true를 반환합니다. visible 을 false 으로 설정하여 항목을 숨기는 것과 달리 이 속성을 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 을 웨이랜드 서페이스의 좌표계 내의 등가 지점에 매핑하고 매핑된 좌표를 반환합니다.
void setPrimary()
이 WaylandQuickItem 을 서페이스의 기본 보기로 설정합니다.
© 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.