QWaylandXdgToplevel Class
QWaylandXdgToplevel 클래스는 xdg 서페이스의 토플 레벨 창 특정 부분을 나타냅니다. 더 보기...
Header: | #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 &maxSize) |
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
이 열거형 유형은 최상위 창에 대한 창 장식 모드를 지정하는 데 사용됩니다.
Constant | 값 | 설명 |
---|---|---|
QWaylandXdgToplevel::ServerSideDecoration | 2 | 컴포저가 창 장식을 그려야 합니다. |
QWaylandXdgToplevel::ClientSideDecoration | 1 | 클라이언트는 창 장식을 그려야 합니다. |
프로퍼티 문서
[read-only]
activated : const bool
이 프로퍼티는 토플 레벨이 입력 포커스가 있는 것으로 그리는지 여부를 보유합니다.
액세스 함수:
bool | activated() const |
알림 신호:
void | activatedChanged() |
[read-only]
appId : const QString
이 속성은 QWaylandXdgToplevel 의 앱 ID를 보유합니다.
액세스 함수:
QString | appId() const |
알림 신호:
void | appIdChanged() |
[read-only]
decorationMode : const enum DecorationMode
이 프로퍼티는 이 최상위 레벨의 현재 창 장식 모드를 저장합니다.
함수에 액세스합니다:
QWaylandXdgToplevel::DecorationMode | decorationMode() const |
알림 신호:
void | decorationModeChanged() |
QWaylandXdgDecorationManagerV1 를참조하세요 .
[read-only]
fullscreen : const bool
이 속성은 클라이언트가 전체 화면으로 표시해야 한다는 것을 확인했는지 여부를 저장합니다.
액세스 기능:
bool | fullscreen() const |
알림 신호:
void | fullscreenChanged() |
[read-only]
maxSize : const QSize
이 속성은 QWaylandXdgToplevel 의 최대 크기를 보유합니다.
컴포저는 이 값을 무시하고 더 큰 크기를 요청할 수 있습니다.
액세스 함수:
QSize | maxSize() const |
알림 신호:
void | maxSizeChanged() |
[read-only]
maximized : const bool
이 속성은 클라이언트가 최대화해야 한다는 것을 인정했는지 여부를 보유합니다.
액세스 함수:
bool | maximized() const |
알림 신호:
void | maximizedChanged() |
[read-only]
minSize : const QSize
이 속성은 QWaylandXdgToplevel 의 최소 크기를 보유합니다.
컴포저는 이 값을 무시하고 더 작은 크기를 요청할 수 있습니다.
액세스 함수:
QSize | minSize() const |
알림 신호:
void | minSizeChanged() |
[read-only, since 6.8]
modal : const bool
이 프로퍼티는 토플 레벨이 다른 창이 입력을 받지 못하도록 차단할지 여부를 저장합니다.
이 프로퍼티는 Qt 6.8에 도입되었습니다.
액세스 함수:
bool | isModal() const |
알림 신호:
void | modalChanged() |
[read-only]
parentToplevel : QWaylandXdgToplevel* const
이 속성은 이 XdgToplevel 의 XdgToplevel 부모를 보유합니다.
액세스 함수:
QWaylandXdgToplevel * | parentToplevel() const |
알림 신호:
void | parentToplevelChanged() |
[read-only]
resizing : const bool
이 속성은 클라이언트가 크기 조정 중임을 확인했는지 여부를 저장합니다.
액세스 기능:
bool | resizing() const |
알림 신호:
void | resizingChanged() |
[read-only]
states : const QList<int>
이 프로퍼티에는 클라이언트가 이 QWaylandToplevel에 대해 마지막으로 승인한 상태가 저장됩니다.
알림 신호:
void | statesChanged() |
[read-only]
title : const 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()
Q웨이랜드 토플 레벨의 표면 역할을 반환합니다.
[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)
전체 화면 상태가 설정되고 최대화 및 크기 조정이 제거된 상태에서 구성 이벤트를 전송할 수 있는 편의성이 개선되었습니다. 활성화된 상태는 현재 상태로 유지됩니다.
size 는 창의 새 크기입니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
sendUnmaximized 를참조하세요 .
[invokable]
uint QWaylandXdgToplevel::sendMaximized(const QSize &size)
최대화 상태가 설정되고 전체 화면 및 크기 조정이 제거된 상태에서 편리하게 구성 이벤트를 전송할 수 있습니다. 활성화된 상태는 현재 상태로 유지됩니다.
size 는 창의 새 크기입니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable]
uint QWaylandXdgToplevel::sendResizing(const QSize &maxSize)
크기 조정 상태가 설정되고 최대화 및 전체 화면이 제거된 상태에서 구성 이벤트를 편리하게 보낼 수 있습니다. 활성화된 상태는 현재 상태로 유지됩니다.
maxSize 는 창의 새 크기입니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable]
uint QWaylandXdgToplevel::sendUnmaximized(const QSize &size = QSize(0, 0))
최대화, 전체 화면 및 크기 조정 상태가 제거되고 전체 화면 및 크기 조정이 제거된 상태에서 구성 이벤트를 편리하게 보낼 수 있습니다. 활성화된 상태는 현재 상태로 유지됩니다.
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 을 참조하세요.
© 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.