Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

QWaylandXdgToplevel Class

QWaylandXdgToplevel 클래스는 xdg 서페이스의 최상위 창에 해당하는 부분을 나타냅니다. 더 보기...

헤더: #include <QWaylandXdgToplevel>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
QML에서: XdgToplevel
상속: QObject

공개 유형

enum DecorationMode { ServerSideDecoration, ClientSideDecoration }

속성

공개 함수

QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource)
bool activated() const
QString appId() const
QWaylandXdgToplevel::DecorationMode decorationMode() const
bool fullscreen() const
bool isModal() const
QSize maxSize() const
bool maximized() const
QSize minSize() const
QWaylandXdgToplevel *parentToplevel() const
bool resizing() const
void sendClose()
uint sendConfigure(const QSize &size, const QList<QWaylandXdgToplevel::State> &states)
uint sendFullscreen(const QSize &size)
uint sendMaximized(const QSize &size)
uint sendResizing(const QSize &size)
uint sendUnmaximized(const QSize &size = QSize(0, 0))
QSize sizeForResize(const QSizeF &size, const QPointF &delta, Qt::Edges edges) const
QString title() const
QWaylandXdgSurface *xdgSurface() const

신호

void activatedChanged()
void appIdChanged()
void decorationModeChanged()
void fullscreenChanged()
void maxSizeChanged()
void maximizedChanged()
void minSizeChanged()
void modalChanged()
void parentToplevelChanged()
void resizingChanged()
void statesChanged()
void titleChanged()

정적 공용 멤버

QWaylandXdgToplevel *fromResource(wl_resource *resource)
QWaylandSurfaceRole *role()

상세 설명

이 클래스는 QWaylandXdgShell 확장 기능의 일부이며, 데스크톱 스타일 창에 특화된 기능을 통해 QWaylandXdgSurface 의 기능을 확장하는 방법을 제공합니다.

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

멤버 유형 문서

enum QWaylandXdgToplevel::DecorationMode

이 열거형 유형은 최상위 창의 창 장식 모드를 지정하는 데 사용됩니다.

상수값설명
QWaylandXdgToplevel::ServerSideDecoration2컴포지터는 창 장식을 그려야 합니다.
QWaylandXdgToplevel::ClientSideDecoration1클라이언트가 창 장식을 그려야 합니다.

속성 설명서

[read-only] activated : bool

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

액세스 함수:

bool activated() const

알림 신호:

void activatedChanged()

[read-only] appId : QString

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

액세스 함수:

QString appId() const

Notifier 시그널:

void appIdChanged()

[read-only] decorationMode : enum DecorationMode

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

액세스 함수:

QWaylandXdgToplevel::DecorationMode decorationMode() const

알림 신호:

void decorationModeChanged()

QWaylandXdgDecorationManagerV1도 참조하십시오 .

[read-only] fullscreen : bool

이 속성은 클라이언트가 전체 화면으로 표시되어야 함을 확인했는지 여부를 나타냅니다.

액세스 함수:

bool fullscreen() const

알림 신호:

void fullscreenChanged()

[read-only] maxSize : QSize

이 속성은 QWaylandXdgToplevel 의 최대 크기를 지정합니다.

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

액세스 함수:

QSize maxSize() const

알림 신호:

void maxSizeChanged()

[read-only] maximized : bool

이 속성은 클라이언트가 해당 창을 최대화해야 한다는 사실을 확인했는지 여부를 나타냅니다.

액세스 함수:

bool maximized() const

Notifier 신호:

void maximizedChanged()

[read-only] minSize : QSize

이 속성은 QWaylandXdgToplevel 의 최소 크기를 지정합니다.

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

액세스 함수:

QSize minSize() const

알림 신호:

void minSizeChanged()

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

이 열거형은 Qt 6.8에서 도입되었습니다.

액세스 함수:

bool isModal() const

Notifier 신호:

void modalChanged()

[read-only] parentToplevel : QWaylandXdgToplevel*

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

액세스 함수:

QWaylandXdgToplevel *parentToplevel() const

알림 신호:

void parentToplevelChanged()

[read-only] resizing : bool

이 속성은 클라이언트가 크기 조정이 진행 중임을 인지했는지 여부를 나타냅니다.

액세스 함수:

bool resizing() const

알림 신호:

void resizingChanged()

[read-only] states : QList<int>

이 속성은 클라이언트가 이 QWaylandToplevel에 대해 마지막으로 수신한 상태를 저장합니다.

Notifier 신호:

void statesChanged()

[read-only] title : QString

이 부동산은 ‘ QWaylandXdgToplevel ’라는 명칭을 가지고 있습니다.

액세스 기능:

QString title() const

알림 신호:

void titleChanged()

[read-only] xdgSurface : QWaylandXdgSurface* const

이 속성은 이 QWaylandXdgToplevel 에 대한 QWaylandXdgSurface 를 포함합니다.

액세스 함수:

QWaylandXdgSurface *xdgSurface() const

멤버 함수 설명서

[explicit] QWaylandXdgToplevel::QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource)

지정된 ` xdgSurface ` 및 ` resource`에 대한 `QWaylandXdgToplevel` 객체를 생성합니다.

[static] QWaylandXdgToplevel *QWaylandXdgToplevel::fromResource(wl_resource *resource)

resource 에 해당하는 QWaylandXdgToplevel 를 반환합니다.

[static] QWaylandSurfaceRole *QWaylandXdgToplevel::role()

QWaylandToplevel의 표면 역할을 반환합니다.

[invokable] void QWaylandXdgToplevel::sendClose()

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.

uint QWaylandXdgToplevel::sendConfigure(const QSize &size, const QList<QWaylandXdgToplevel::State> &states)

클라이언트에 구성 이벤트를 전송합니다. 매개변수 ` size `에는 표면의 픽셀 크기가 포함됩니다. 크기가 0인 경우 클라이언트가 크기를 자유롭게 결정할 수 있습니다. 알려진 ` states `는 `QWaylandXdgToplevel::State`에 열거되어 있습니다.

[invokable] uint QWaylandXdgToplevel::sendFullscreen(const QSize &size)

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

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.

sendUnmaximized도 참조하십시오 .

[invokable] uint QWaylandXdgToplevel::sendMaximized(const QSize &size)

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

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.

[invokable] uint QWaylandXdgToplevel::sendResizing(const QSize &size)

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

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.

[invokable] uint QWaylandXdgToplevel::sendUnmaximized(const QSize &size = QSize(0, 0))

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

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

참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.

[invokable] QSize QWaylandXdgToplevel::sizeForResize(const QSizeF &size, const QPointF &delta, Qt::Edges edges) const

size, delta, 그리고 드래그 중에 활성화된 edges 가 주어졌을 때 새로운 크기를 편리하게 계산할 수 있습니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.

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