XdgToplevel QML Type

XdgToplevel은 xdg 표면의 최상위 창에 해당하는 부분을 나타냅니다. 더 보기...

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

속성

• activated : bool
• appId : string
• decorationMode : enumeration
• fullscreen : bool
• maxSize : size
• maximized : bool
• minSize : size
• modal : bool (since 6.8)
• parentToplevel : XdgToplevel
• resizing : bool
• title : string
• xdgSurface : XdgSurface

방법

• void sendClose()
• int sendConfigure(size size, list<int> states)
• void sendFullscreen(size size)
• void sendMaximized(size size)
• void sendResizing(size size)
• void sendUnmaximized(size size)
• size sizeForResize(size size, point delta, uint edges)

상세 설명

이 타입은 XdgShell 확장 기능의 일부이며, 데스크톱 스타일 창에 특화된 기능을 통해 XdgSurface 의 기능을 확장할 수 있는 방법을 제공합니다.

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

속성 문서

activated : bool [read-only]

이 속성은 최상위 요소가 입력 포커스가 있는 것처럼 표시되는지 여부를 나타냅니다.

appId : string [read-only]

이 속성은 XdgToplevel 의 앱 ID를 포함합니다. 이는 Qt의 desktopFileName 에 해당합니다.

decorationMode : enumeration [read-only]

이 속성은 이 최상위 창의 현재 창 장식 모드를 저장합니다.

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

XdgDecorationManagerV1도 참조하십시오 .

fullscreen : bool [read-only]

이 속성은 클라이언트가 전체 화면으로 전환해야 한다는 점을 인지했는지 여부와 관계없이 적용됩니다.

maxSize : size [read-only]

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

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

maximized : bool [read-only]

이 속성은 클라이언트가 이 속성을 최대화해야 한다는 점을 인정했는지 여부와 관계없이 적용됩니다.

minSize : size [read-only]

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

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

modal : bool [read-only, since 6.8]

이 속성은 최상위 블록이 다른 창의 입력 수신을 차단할지 여부를 결정합니다.

이 속성은 Qt 6.8에서 도입되었습니다.

parentToplevel : XdgToplevel [read-only]

이 속성은 이 XdgToplevel 의 상위 요소인 XdgToplevel 를 포함합니다.

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 의 가능한 값은 다음과 같습니다:

void sendFullscreen(size size)

전체 화면 상태가 설정된 상태에서 configure 이벤트를 전송할 수 있도록 편의성을 제공하며, 최대화 및 크기 조정 기능은 제거되었습니다. 활성화된 상태는 현재 상태로 유지됩니다.

size 는 창의 새로운 크기입니다.

sendUnmaximized도 참조하십시오 .

void sendMaximized(size size)

최대화 상태가 설정된 상태에서 configure 이벤트를 전송할 수 있도록 편의성을 제공하며, 전체 화면 및 크기 조정 기능은 제거되었습니다. 활성화된 상태는 현재 상태로 유지됩니다.

size 는 창의 새로운 크기입니다.

void sendResizing(size size)

크기 조정 상태가 설정된 상태로 ‘configure’ 이벤트를 전송할 수 있도록 편의성을 제공하며, ‘maximized’ 및 ‘fullscreen’ 속성은 제거됩니다. ‘activated’ 상태는 현재 상태로 유지됩니다.

size 는 창의 새로운 크기입니다.

void sendUnmaximized(size size)

최대화, 전체 화면 및 크기 조정 상태가 제거된 상태에서 configure 이벤트를 전송할 수 있도록 편의성을 제공하며, 전체 화면 및 크기 조정 상태도 제거됩니다. 활성화된 상태는 현재 상태로 유지됩니다.

size 는 창의 새로운 크기입니다. ` size `가 0인 경우, 클라이언트가 크기를 결정합니다.

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

size, delta, 그리고 드래그 중에 활성화된 edges 가 주어졌을 때 새로운 크기를 계산하는 데 편리한 방법입니다.