QtShellSurface QML Type

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

Import Statement:	`import QtWayland.Compositor.QtShell`
Since:	Qt 6.3

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

속성

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

이 프로퍼티는 현재 서페이스가 활성으로 간주되는지 여부를 저장합니다.

참고: QtShellSurface 에는 여러 개의 서페이스가 동시에 활성화되는 것을 막는 제한이 없습니다. 이러한 로직은 컴포저 자체에서 구현하거나 표면의 활성화 상태를 자동으로 관리하는 QtShellChrome 유형을 사용하여 구현해야 합니다.

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 의 창 상태를 보유합니다.

참고: requestWindowGeometry()를 호출하여 서페이스의 상태를 업데이트하면 클라이언트가 상태 변경을 승인할 때까지 windowState 속성은 업데이트되지 않습니다.

windowTitle : string [read-only]

이 프로퍼티는 QtShellSurface 의 창 제목을 보유합니다.

신호 문서

void startMove()

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

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

capabilities 를참조하세요 .

void startResize(enum edges)

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

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

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

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

capabilities 를참조하십시오 .

메서드 문서

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

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

void requestWindowGeometry(int windowState, rect windowGeometry)

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

void sendClose()

클라이언트 애플리케이션이 자체적으로 닫히도록 요청합니다.

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