WaylandQuickItem QML Type

WaylandQuickItem 유형은 Wayland 클라이언트의 화면을 나타내는 ‘ Qt Quick ’ 항목을 제공합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• 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 QuickWayland 기반 컴포지터는 이 유형을 사용하여 클라이언트의 콘텐츠를 출력 장치에 표시할 수 있습니다. 이 유형은 사용자 입력을 클라이언트로 전달합니다.

속성 설명

bufferLocked : bool

이 속성은 항목의 버퍼가 현재 잠겨 있는지 여부를 나타냅니다. 버퍼가 잠겨 있는 동안에는 해제되지 않으며 클라이언트로 반환되지 않습니다.

기본값은 false입니다.

compositor : WaylandCompositor [read-only]

이 속성은 이 ` WaylandQuickItem`에 의해 렌더링된 표면의 컴포지터를 저장합니다.

focusOnClick : bool

이 속성은 ‘ WaylandQuickItem ’을 클릭하거나 터치했을 때 포커스가 해당 요소로 이동할지 여부를 지정합니다.

기본값은 ` true`입니다.

inputEventsEnabled : bool

이 속성은 해당 항목에 대해 입력 이벤트가 활성화되어 있는지 여부를 나타냅니다.

true 인 경우, 해당 항목은 키보드 및 마우스 이벤트와 같은 입력 이벤트를 처리하고 대응합니다. false 인 경우, 입력 이벤트는 무시됩니다.

origin : enum [read-only]

이 속성은 표면의 현재 버퍼의 원점을 나타내며, 즉 버퍼의 어느 모서리가 좌표 (0, 0)에 해당하는지를 나타냅니다.

WaylandSurface::origin도 참조하십시오 .

output : WaylandOutput

이 속성은 해당 항목이 표시되는 출력 대상을 지정합니다.

paintEnabled : bool [default: true]

이 속성을 ` false `로 설정하면 해당 항목의 렌더링이 중지됩니다. ` visible `를 ` 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 을 즉시 파기하거나, 닫힘 애니메이션을 시작한 후 Item을 파기해야 합니다.

애니메이션이 시작되면, 애니메이션이 끝날 때까지 아이템이 콘텐츠를 유지하도록 bufferLocked 을 설정해야 합니다.

bufferLocked도 참조하십시오 .

메서드 문서

point mapFromSurface(point point)

Wayland 표면의 좌표계에 있는 주어진 point 를 이 항목의 좌표계 내의 해당 지점으로 매핑하고, 매핑된 좌표를 반환합니다.

point mapToSurface(point point)

이 항목의 좌표계에서 주어진 point 를 Wayland 표면의 좌표계 내 해당 지점으로 매핑하고, 매핑된 좌표를 반환합니다.

void setPrimary()

이 WaylandQuickItem 를 서피스의 기본 보기로 설정합니다.