QtShellChrome QML Type
qt-shell
확장자와 함께 사용할 수 있는 기본 창 관리자 기능을 제공합니다. 더 보기...
Import Statement: | import QtWayland.Compositor.QtShell |
Since: | Qt 6.3 |
속성
- bottomLeftResizeHandle : Item
- bottomResizeHandle : Item
- bottomRightResizeHandle : Item
- frameMarginBottom : int
- frameMarginLeft : int
- frameMarginRight : int
- frameMarginTop : int
- hasDecorations : bool
- leftResizeHandle : Item
- maximizedRect : rect
- rightResizeHandle : Item
- shellSurfaceItem : ShellSurfaceItem
- titleBar : Item
- topLeftResizeHandle : Item
- topResizeHandle : Item
- topRightResizeHandle : Item
- windowFlags : int
- windowState : int
방법
- void activate()
- void deactivate()
- void lower()
- void raise()
- void toggleFullScreen()
- void toggleMaximized()
- void toggleMinimized()
상세 설명
QtShellChrome은 qt-shell
셸 확장 프로토콜을 통해 클라이언트와의 상호작용에 창 관리자 기능을 제공하는 데 사용할 수 있는 편의 유형입니다.
QtShellSurface 과 연결된 ShellSurfaceItem 이 주어지면 항목의 크기가 서페이스에 맞게 자동으로 조정됩니다. 또한 다음과 같은 자동 처리 기능도 제공합니다:
- 최대화, 최소화 및 전체 화면과 같은 창 상태.
- 창 활성화.
- 크기 조정 핸들을 사용한 창 크기 조정(적절한 속성이 설정된 경우).
- 제목 표시줄 상호작용을 사용한 창 위치 변경( titleBar 속성이 설정된 경우).
QtShellChrome은 QtShell 및 QtShellSurface 과 함께 사용하도록 되어 있습니다.
QtShell 컴포저도참조하십시오 .
속성 문서
bottomLeftResizeHandle : Item |
이 속성은 QtShellChrome 의 기본 왼쪽 하단 크기 조정 핸들을 보유합니다. 설정하면 크기 조정 핸들에 DragHandler 이 설치되어 아래쪽과 왼쪽 가장자리를 같은 양으로 이동하여 창 크기를 조정합니다.
이 핸들은 창 플래그 및 창의 전체 화면 상태에 따라 자동으로 숨겨지거나 표시됩니다.
QtShellChrome { Rectangle { id: blrh anchors.bottom: parent.bottom anchors.left: parent.left height: 5 width: 5 color: "white" } bottomLeftResizeHandle: blrh }
bottomResizeHandle : Item |
이 속성은 QtShellChrome 의 기본 하단 크기 조정 핸들을 보유합니다. 이 속성을 설정하면 아래쪽 가장자리를 이동하여 창 크기를 조정하는 크기 조정 핸들에 DragHandler 이 설치됩니다.
이 핸들은 창 플래그와 창의 전체 화면 상태에 따라 자동으로 숨겨지거나 표시됩니다.
QtShellChrome { Rectangle { id: brh anchors.bottom: parent.bottom anchors.left: parent.left anchors.right: parent.right height: 5 color: "white" } bottomResizeHandle: brh }
참고: 명시적인 프레임 여백을 설정하지 않으면 핸들의 높이가 창의 아래쪽 프레임 여백에 포함됩니다.
bottomRightResizeHandle : Item |
이 속성은 QtShellChrome 의 기본 오른쪽 하단 크기 조정 핸들을 보유합니다. 설정하면 크기 조정 핸들에 DragHandler 이 설치되어 아래쪽과 오른쪽 가장자리를 같은 양으로 이동하여 창 크기를 조정합니다.
이 핸들은 창 플래그와 창의 전체 화면 상태에 따라 자동으로 숨겨지거나 표시됩니다.
QtShellChrome { Rectangle { id: brrh anchors.bottom: parent.bottom anchors.right: parent.right height: 5 width: 5 color: "white" } bottomRightResizeHandle: brrh }
frameMarginBottom : int |
창 장식을 위해 예약된 QtShellChrome 하단 여백의 크기를 설정합니다. 기본적으로 설정되어 있는 경우 bottomResizeHandle 의 높이와 같습니다. 그렇지 않으면 0이 됩니다.
참고: 이 속성을 명시적으로 설정하면 모든 기본 프레임 여백이 해당 속성으로 재정의됩니다.
frameMarginLeft : int |
창 장식을 위해 예약된 QtShellChrome 왼쪽 여백의 크기를 설정합니다. 기본적으로 설정되어 있는 경우 leftResizeHandle 의 너비와 같습니다. 그렇지 않으면 0이 됩니다.
참고: 이 속성을 명시적으로 설정하면 모든 기본 프레임 여백이 해당 속성으로 재정의됩니다.
frameMarginRight : int |
창 장식용으로 예약된 QtShellChrome 의 오른쪽 여백 크기를 설정합니다. 기본적으로 설정되어 있는 경우 rightResizeHandle 의 너비와 같습니다. 그렇지 않으면 0이 됩니다.
참고: 이 속성을 명시적으로 설정하면 모든 기본 프레임 여백이 해당 속성으로 재정의됩니다.
frameMarginTop : int |
창 장식용으로 예약된 QtShellChrome 의 상단 여백 크기를 설정합니다. 기본적으로 leftResizeHandle 및 titleBar 높이가 설정되어 있는 경우 두 높이의 합과 같습니다. 그렇지 않으면 0이 됩니다.
참고: 이 속성을 명시적으로 설정하면 모든 기본 프레임 여백이 해당 속성으로 재정의됩니다.
hasDecorations : bool |
이 속성은 창 상태 및 창 플래그에 따라 QtShellChrome 의 장식이 표시되어야 하는 경우 참입니다.
leftResizeHandle : Item |
이 속성은 QtShellChrome 의 기본 왼쪽 크기 조정 핸들을 보유합니다. 이 속성을 설정하면 왼쪽 가장자리를 이동하여 창 크기를 조정하는 DragHandler 이 크기 조정 핸들에 설치됩니다.
이 핸들은 창 플래그와 창의 전체 화면 상태에 따라 자동으로 숨겨지거나 표시됩니다.
QtShellChrome { Rectangle { id: lrh anchors.left: parent.left anchors.top: parent.top anchors.bottom: parent.bottom width: 5 color: "white" } leftResizeHandle: lrh }
참고: 명시적인 프레임 여백을 설정하지 않은 경우 핸들의 너비는 창의 왼쪽 프레임 여백에 포함됩니다.
maximizedRect : rect |
이 속성은 창이 최대화 상태일 때 창이 채울 수 있는 WaylandOutput 의 값을 보유합니다. 기본적으로 창이 최대화되면 WaylandOutput 의 전체 지오메트리가 채워집니다. 이 속성을 변경하면 컴포저에 작업 표시줄과 같이 최대화된 애플리케이션에 가려서는 안 되는 다른 시스템 UI가 있는 경우에 유용할 수 있습니다.
rightResizeHandle : Item |
이 속성은 QtShellChrome 의 기본 오른쪽 크기 조정 핸들을 보유합니다. 이 속성을 설정하면 오른쪽 가장자리를 이동하여 창 크기를 조정하는 DragHandler 이 크기 조정 핸들에 설치됩니다.
이 핸들은 창 플래그와 창의 전체 화면 상태에 따라 자동으로 숨겨지거나 표시됩니다.
QtShellChrome { Rectangle { id: rrh anchors.right: parent.right anchors.top: parent.top anchors.bottom: parent.bottom width: 5 color: "white" } rightResizeHandle: rrh }
참고: 명시적인 프레임 여백을 설정하지 않은 경우 핸들의 너비는 창의 오른쪽 프레임 여백에 포함됩니다.
shellSurfaceItem : ShellSurfaceItem |
이 프로퍼티는 이 QtShellChrome 와 관련된 셸 표면 항목을 보유합니다. 이 속성은 차례로 이 항목의 shellSurface
을 관리합니다. 항목의 shellSurface
은 QtShellSurface 유형으로 예상됩니다.
QtShellChrome { id: chrome ShellSurfaceItem { id: sfi anchors.fill: parent moveItem: chrome } shellSurfaceItem: sfi }
titleBar : Item |
이 속성은 QtShellChrome 의 기본 제목 표시줄 항목을 보유합니다. 이 속성을 설정하면 사용자 상호작용 시 창을 이동하는 DragHandler 이 제목 표시줄에 설치됩니다. 또한 제목 표시줄을 클릭하면 창이 자동으로 활성화됩니다.
제목 표시줄은 창 플래그와 창의 전체 화면 상태에 따라 자동으로 숨겨지거나 표시됩니다.
QtShellChrome { Rectangle { id: tb anchors.top: parent.top anchors.right: parent.right anchors.left: parent.left height: 50 color: "black" Text { color: "white" anchors.centerIn: parent text: shellSurfaceItem.shellSurface.windowTitle font.pixelSize: 25 } } titleBar: tb }
참고: 명시적인 프레임 여백을 설정하지 않으면 제목 표시줄의 높이가 창의 상단 프레임 여백에 포함됩니다.
topLeftResizeHandle : Item |
이 속성은 QtShellChrome 의 기본 왼쪽 상단 크기 조정 핸들을 보유합니다. 설정하면 크기 조정 핸들에 DragHandler 이 설치되어 창 상단과 왼쪽 가장자리를 같은 양으로 이동하여 창 크기를 조정합니다.
이 핸들은 창 플래그와 창의 전체 화면 상태에 따라 자동으로 숨겨지거나 표시됩니다.
QtShellChrome { Rectangle { id: tlrh anchors.top: parent.top anchors.left: parent.left height: 5 width: 5 color: "white" } topLeftResizeHandle: tlrh }
topResizeHandle : Item |
이 속성은 QtShellChrome 의 기본 상단 크기 조정 핸들을 보유합니다. 이 속성을 설정하면 위쪽 가장자리를 이동하여 창 크기를 조정하는 크기 조정 핸들에 DragHandler 이 설치됩니다.
이 핸들은 창 플래그와 창의 전체 화면 상태에 따라 자동으로 숨겨지거나 표시됩니다.
QtShellChrome { Rectangle { id: trh anchors.top: parent.top anchors.left: parent.left anchors.right: parent.right height: 5 color: "white" } topResizeHandle: trh }
참고: 명시적인 프레임 여백을 설정하지 않으면 핸들의 높이가 창의 상단 프레임 여백에 포함됩니다.
topRightResizeHandle : Item |
이 속성은 QtShellChrome 의 기본 오른쪽 상단 크기 조정 핸들을 보유합니다. 설정하면 크기 조정 핸들에 DragHandler 이 설치되어 창 상단과 오른쪽 가장자리를 같은 양으로 이동하여 창 크기를 조정합니다.
이 핸들은 창 플래그와 창의 전체 화면 상태에 따라 자동으로 숨겨지거나 표시됩니다.
QtShellChrome { Rectangle { id: trrh anchors.top: parent.top anchors.right: parent.right height: 5 width: 5 color: "white" } topRightResizeHandle: trrh }
windowFlags : int |
이 프로퍼티는 QtShellChrome 의 창 플래그를 보유합니다. Qt.Window 와 같은 경우를 제외하고는 연결된 QtShellSurface 의 windowFlags
프로퍼티와 일치합니다. 이 경우 기본 창 플래그 세트가 대신 사용됩니다. 기본 창 플래그는 Qt.Window, Qt.WindowMaximizeButtonHint, Qt.WindowMinimizeButtonHint 및 Qt.WindowCloseButtonHint입니다.
windowState : int |
이 프로퍼티는 셸 표면의 창 상태를 유지합니다. 컴포저 측에서 창 상태를 요청하면 클라이언트가 이를 인식하기 전에 즉시 업데이트됩니다. 따라서 클라이언트가 요청을 승인하면 업데이트되는 셸 표면의 windowState
프로퍼티와 짧은 기간 동안 다를 수 있습니다.
메서드 문서
void activate() |
이 창을 수동으로 활성화합니다. 이렇게 하면 창이 올라갑니다.
raise()도 참조하세요 .
void deactivate() |
이 창을 수동으로 비활성화합니다. 창이 활성화되어 있으면 스택의 다음 창이 대신 활성화됩니다.
void lower() |
이 창을 낮추면 다른 창 아래에 스택이 쌓입니다(다른 창의 창 플래그가 이를 금지하는 경우는 제외).
void raise() |
이 창을 올리면 다른 창 위에 쌓입니다(다른 창의 플래그가 이를 금지하는 경우 제외).
void toggleFullScreen() |
전체 화면과 일반 창 상태 사이를 전환합니다. 이 메서드는 최소화 또는 최대화 창 상태가 설정되어 있는 경우 이 상태도 지웁니다.
void toggleMaximized() |
최대화 상태와 일반 상태 사이를 전환합니다. 창 최소화 상태가 설정된 경우 이 메서드는 창 최소화 상태도 지웁니다.
void toggleMinimized() |
최소화 상태와 일반 상태 사이를 전환합니다. 최대 창 상태가 설정된 경우 이 메서드는 최대 창 상태도 지웁니다.
© 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.