QtShellSurface QML Type

서페이스를 식별하고 크기를 조정할 수 있는 간단한 방법을 제공합니다. 더 보기...

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

속성

• active : bool
• capabilities : enum
• frameMarginBottom : int
• frameMarginLeft : int
• frameMarginRight : int
• frameMarginTop : int
• maximumSize : size
• minimumSize : size
• surface : WaylandSurface
• windowFlags : int
• windowGeometry : rect
• windowPosition : point
• windowState : int
• windowTitle : string

신호

• void startMove()
• void startResize(enum edges)

방법

• void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource)
• void requestWindowGeometry(int windowState, rect windowGeometry)
• void sendClose()

상세 설명

이 타입은 QtShell 확장 기능의 일부이며, 기존 WaylandSurface 에 창 관리 기능을 추가할 수 있는 방법을 제공합니다.

QtShellSurface 유형은 QtShell 확장을 지원하는 컴포지터를 생성하는 데 필요한 핵심 기능을 포함하고 있습니다. 컴포지터의 요구 사항에 따라 이 유형을 직접 사용하거나 QtShellChrome 유형을 통해 간접적으로 사용할 수 있습니다. QtShellChrome 유형은 QtShellSurface 객체를 다루기 위한 기본 동작과 편리한 API를 제공합니다.

속성 설명서

active : bool

이 속성은 표면이 현재 활성화된 것으로 간주되는지 여부를 나타냅니다.

capabilities : enum

이 속성은 컴포지터의 기능을 나타냅니다. 기본적으로 특별한 기능은 활성화되어 있지 않습니다.

• QtShellSurface.InteractiveMove 클라이언트는 QWindow::startSystemMove()를 사용하여 서버 측 대화형 이동 작업을 트리거할 수 있습니다. 이 작업은 startMove() 신호를 통해 컴포지터에 알림이 전달됩니다.
• QtShellSurface.InteractiveResize 클라이언트는 ` QWindow::startSystemResize()`를 사용하여 서버 측 대화형 크기 조정 작업을 트리거할 수 있습니다. 컴포지터는 ` startResize()` 신호를 통해 이에 대한 알림을 받게 됩니다.

frameMarginBottom : int

이것은 창틀의 여백을 표면 아래로 유지해 줍니다.

frameMarginLeft : int

이렇게 하면 창틀의 여백이 표면의 왼쪽에 위치하게 됩니다.

frameMarginRight : int

이렇게 하면 창틀의 여백이 표면의 오른쪽에 위치하게 됩니다.

frameMarginTop : int

이것은 창틀이 표면 위로 일정 간격을 유지하도록 합니다.

maximumSize : size [read-only]

클라이언트가 창 크기를 지정한 경우 해당 창의 최대 크기입니다. 그렇지 않은 경우 유효하지 않은 크기입니다.

minimumSize : size [read-only]

클라이언트가 창 크기를 지정한 경우, 해당 창의 최소 크기입니다. 그렇지 않은 경우 유효하지 않은 크기입니다.

surface : WaylandSurface [read-only]

이 속성은 이 QtShellSurface 에 연결된 표면을 포함합니다.

windowFlags : int [read-only]

이 속성은 QtShellSurface 의 창 플래그를 포함합니다.

windowGeometry : rect [read-only]

이 속성은 쉘 표면의 창 기하학적 정보를 담고 있습니다.

windowPosition : point

이 속성은 쉘 표면이 출력물에 대해 차지하는 위치를 나타냅니다.

windowState : int [read-only]

이 속성은 QtShellSurface 의 창 상태를 저장합니다.

windowTitle : string [read-only]

이 속성은 QtShellSurface 의 창 제목을 저장합니다.

Signal 문서

void startMove()

클라이언트가 QWindow::startSystemMove()를 호출하여 컴포지터에서 대화형 이동 작업을 요청했습니다.

capabilities도 참조하십시오 .

void startResize(enum edges)

클라이언트가 ` QWindow::startSystemResize()`를 호출하여 컴포지터에서 대화형 크기 조정 작업을 요청했습니다.

edges 는 크기 조정 중에 창의 어느 가장자리를 이동해야 하는지에 대한 정보를 제공합니다. 이는 다음 값들로 구성된 마스크입니다:

• Qt.TopEdge
• Qt.LeftEdge
• Qt.RightEdge
• Qt.BottomEdge

capabilities도 참조하십시오 .

메서드 문서

void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource)

QtShellSurface 를 초기화하고, 이를 주어진 qtShell, surface 및 resource 와 연결합니다.

void requestWindowGeometry(int windowState, rect windowGeometry)

QtShellSurface 에 대한 새로운 windowState 및 windowGeometry 를 요청합니다. 클라이언트가 요청을 수신 확인하면 상태와 지오메트리가 업데이트됩니다(이 시점에서 필요한 경우 서페이스의 버퍼 크기가 조정되었다고 가정해도 무방합니다).

void sendClose()

클라이언트 애플리케이션이 스스로 종료되도록 요청합니다.