XdgToplevel QML Type

XdgToplevel은 xdg 서페이스의 토플 레벨 창 특정 부분을 나타냅니다. 더 보기...

Import Statement: import QtWayland.Compositor.XdgShell
In C++: QWaylandXdgToplevel

속성

방법

상세 설명

이 유형은 XdgShell 확장의 일부이며 데스크톱 스타일 창에 특화된 기능으로 XdgSurface 의 기능을 확장하는 방법을 제공합니다.

이는 Wayland 인터페이스 xdg_toplevel 에 해당합니다.

속성 문서

activated : bool [read-only]

이 프로퍼티는 토플 레벨이 입력 포커스가 있는 것으로 그리는지 여부를 보유합니다.


appId : string [read-only]

이 프로퍼티는 XdgToplevel 의 앱 ID를 보유합니다.


decorationMode : enumeration [read-only]

이 프로퍼티는 이 토플 레벨의 현재 창 장식 모드를 보유합니다.

가능한 값은 다음과 같습니다:

Constant설명
XdgToplevel.ServerSideDecoration컴포저가 창 장식을 그려야 합니다.
XdgToplevel.ClientSideDecoration클라이언트가 창 장식을 그려야 합니다.

XdgDecorationManagerV1참조하십시오 .


fullscreen : bool [read-only]

이 속성은 클라이언트가 전체 화면으로 표시해야 하는지 여부를 저장합니다.


maxSize : size [read-only]

이 속성은 클라이언트가 요청한 XdgToplevel 의 최대 크기를 보유합니다.

컴포저는 이 값을 무시하고 더 큰 크기를 요청할 수 있습니다.


maximized : bool [read-only]

이 프로퍼티는 클라이언트가 최대화해야 한다는 것을 확인했는지 여부를 저장합니다.


minSize : size [read-only]

이 속성은 클라이언트가 요청한 XdgToplevel 의 최소 크기를 보유합니다.

컴포저는 이 값을 무시하고 더 작은 크기를 요청할 수 있습니다.


이 프로퍼티는 토플 레벨이 다른 창이 입력을 받지 못하도록 차단할지 여부를 보유합니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.


parentToplevel : XdgToplevel [read-only]

이 프로퍼티는 XdgToplevelXdgToplevel 부모를 보유합니다.


resizing : bool [read-only]

이 속성은 클라이언트가 크기가 조정되고 있음을 확인했는지 여부를 보유합니다.


title : string [read-only]

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


xdgSurface : XdgSurface [read-only]

이 프로퍼티는 XdgToplevel 에 대한 XdgSurface 을 보유합니다.


메서드 문서

void sendClose()

클라이언트에게 닫기 이벤트를 전송합니다. 클라이언트는 이벤트를 무시하도록 선택할 수 있습니다.


int sendConfigure(size size, list<int> states)

클라이언트에 구성 이벤트를 보냅니다. size 에는 표면의 픽셀 크기가 포함됩니다. 크기가 0이면 클라이언트가 자유롭게 크기를 결정할 수 있습니다. 알려진 states 은 XdgToplevel::State에 열거됩니다.


void sendFullscreen(size size)

전체 화면 상태가 설정되고 최대화 및 크기 조정이 제거된 상태에서 구성 이벤트를 전송하는 데 편리합니다. 활성화된 상태는 현재 상태로 유지됩니다.

size 는 창의 새 크기입니다.

sendUnmaximized참조하세요 .


void sendMaximized(size size)

최대화 상태가 설정되고 전체 화면 및 크기 조정이 제거된 상태에서 구성 이벤트를 보내는 데 편리합니다. 활성화된 상태는 현재 상태로 유지됩니다.

size 는 창의 새 크기입니다.


void sendResizing(size maxSize)

크기 조정 상태가 설정되고 최대화 및 전체 화면이 제거된 상태에서 구성 이벤트를 전송할 때 편리합니다. 활성화된 상태는 현재 상태로 유지됩니다.

maxSize 는 창의 새 크기입니다.


void sendUnmaximized(size size)

최대화, 전체 화면 및 크기 조정 상태가 제거되고 전체 화면 및 크기 조정이 제거된 상태에서 구성 이벤트를 전송할 때 편리합니다. 활성화된 상태는 현재 상태로 유지됩니다.

size 는 창의 새 크기입니다. size 이 0이면 클라이언트가 크기를 결정합니다.


size sizeForResize(size size, point delta, uint edges)

현재 size, delta, 그리고 드래그에서 활성화된 edges 이 주어지면 새 크기를 계산하는 데 편리합니다.


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