QtShellChrome QML Type

qt-shell 확장 기능과 함께 사용할 수 있는 기본 창 관리자 기능을 제공합니다. 더 보기...

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

속성

• 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 Compositor도 참조하십시오 .

속성 문서

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 [read-only]

이 속성은 QtShellChrome 의 창 상태 및 창 플래그에 따라 해당 객체의 장식 요소가 표시되어야 하는 경우 true입니다.

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 [read-only]

이 속성은 ` QtShellChrome`의 창 플래그를 저장합니다. 이 플래그들은 연관된 ` QtShellSurface`의 ` windowFlags ` 속성과 일치하지만, 해당 속성이 `Qt.Window`와 동일한 경우는 예외입니다. 이 경우 대신 일련의 기본 창 플래그가 사용됩니다. 기본 창 플래그는 Qt.Window, Qt.WindowMaximizeButtonHint, Qt.WindowMinimizeButtonHint 및 Qt.WindowCloseButtonHint입니다.

windowState : int [read-only]

이 속성은 셸 표면의 창 상태를 저장합니다. 컴포지터 측에서 창 상태를 요청하면, 클라이언트가 이를 확인하기 전에 즉시 업데이트됩니다. 따라서 클라이언트가 요청을 확인한 후에 업데이트되는 셸 표면의 ` windowState ` 속성과는 잠시 동안 차이가 날 수 있습니다.

메서드 문서

void activate()

이 창을 수동으로 활성화하십시오. 이렇게 하면 창이 앞으로 표시됩니다.

raise()도 참조하십시오 .

void deactivate()

이 창을 수동으로 비활성화합니다. 해당 창이 활성 상태였던 경우, 대신 스택에 있는 다음 창을 활성화합니다.

void lower()

이 창을 아래로 내려 다른 창들 아래에 겹쳐지도록 하십시오(단, 다른 창의 창 플래그가 이를 허용하지 않는 경우는 제외합니다).

void raise()

이 창을 다른 창들 위에 겹쳐지도록 올립니다(다른 창의 설정에서 이를 금지한 경우는 제외).

void toggleFullScreen()

전체 화면 모드와 일반 창 모드 사이를 전환합니다. 또한 이 메서드는 창이 최소화되거나 최대화된 상태인 경우 해당 상태를 초기화합니다.

void toggleMaximized()

최대화 상태와 일반 상태 사이를 전환합니다. 또한 이 메서드는 창이 최소화된 상태인 경우 해당 상태를 초기화합니다.

void toggleMinimized()

최소화 상태와 일반 상태 사이를 전환합니다. 또한 이 메서드는 창이 최대화되어 있는 경우 해당 상태를 해제합니다.