QWaylandXdgToplevel Class
La clase QWaylandXdgToplevel representa las partes específicas de la ventana toplevel de una superficie xdg. Más...
| Cabecera: | #include <QWaylandXdgToplevel> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
| En QML: | XdgToplevel |
| Hereda: | QObject |
Tipos públicos
| enum | DecorationMode { ServerSideDecoration, ClientSideDecoration } |
Propiedades
|
|
Funciones públicas
| 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 |
Señales
| void | activatedChanged() |
| void | appIdChanged() |
| void | decorationModeChanged() |
| void | fullscreenChanged() |
| void | maxSizeChanged() |
| void | maximizedChanged() |
| void | minSizeChanged() |
| void | modalChanged() |
| void | parentToplevelChanged() |
| void | resizingChanged() |
| void | statesChanged() |
| void | titleChanged() |
Miembros públicos estáticos
| QWaylandXdgToplevel * | fromResource(wl_resource *resource) |
| QWaylandSurfaceRole * | role() |
Descripción detallada
Esta clase forma parte de la extensión QWaylandXdgShell y proporciona una forma de ampliar la funcionalidad de un QWaylandXdgSurface con características específicas para ventanas de estilo escritorio.
Corresponde a la interfaz Wayland xdg_toplevel.
Documentación de tipos de miembros
enum QWaylandXdgToplevel::DecorationMode
Este tipo enum se utiliza para especificar el modo de decoración de las ventanas de nivel superior.
| Constante | Valor | Descripción |
|---|---|---|
QWaylandXdgToplevel::ServerSideDecoration | 2 | El compositor debe dibujar las decoraciones de las ventanas. |
QWaylandXdgToplevel::ClientSideDecoration | 1 | El cliente debe dibujar las decoraciones de las ventanas. |
Documentación de Propiedades
[read-only] activated : bool
Esta propiedad indica si toplevel se dibuja a sí mismo como si tuviera el foco de entrada.
Funciones de acceso:
| bool | activated() const |
Señal del notificador:
| void | activatedChanged() |
[read-only] appId : QString
Esta propiedad contiene el identificador de la aplicación QWaylandXdgToplevel.
Funciones de acceso:
| QString | appId() const |
Señal del notificador:
| void | appIdChanged() |
[read-only] decorationMode : enum DecorationMode
Esta propiedad contiene el modo actual de decoración de la ventana para este toplevel.
Funciones de acceso:
| QWaylandXdgToplevel::DecorationMode | decorationMode() const |
Señal del notificador:
| void | decorationModeChanged() |
Véase también QWaylandXdgDecorationManagerV1.
[read-only] fullscreen : bool
Esta propiedad mantiene si el cliente ha reconocido que debe estar a pantalla completa.
Funciones de acceso:
| bool | fullscreen() const |
Señal del notificador:
| void | fullscreenChanged() |
[read-only] maxSize : QSize
Esta propiedad contiene el tamaño máximo de QWaylandXdgToplevel.
El compositor es libre de ignorar este valor y solicitar un tamaño mayor.
Funciones de acceso:
| QSize | maxSize() const |
Señal del notificador:
| void | maxSizeChanged() |
[read-only] maximized : bool
Esta propiedad mantiene si el cliente ha reconocido que debe maximizarse.
Funciones de acceso:
| bool | maximized() const |
Señal de notificador:
| void | maximizedChanged() |
[read-only] minSize : QSize
Esta propiedad contiene el tamaño mínimo de QWaylandXdgToplevel.
El compositor es libre de ignorar este valor y solicitar un tamaño menor.
Funciones de acceso:
| QSize | minSize() const |
Señal del notificador:
| void | minSizeChanged() |
[read-only, since 6.8] modal : bool
Esta propiedad mantiene si toplevel bloquea otras ventanas de recibir entrada.
Esta propiedad se introdujo en Qt 6.8.
Funciones de acceso:
| bool | isModal() const |
Señal de notificador:
| void | modalChanged() |
[read-only] parentToplevel : QWaylandXdgToplevel*
Esta propiedad contiene el XdgToplevel padre de este XdgToplevel.
Funciones de acceso:
| QWaylandXdgToplevel * | parentToplevel() const |
Señal del notificador:
| void | parentToplevelChanged() |
[read-only] resizing : bool
Esta propiedad indica si el cliente ha reconocido que está siendo redimensionado.
Funciones de acceso:
| bool | resizing() const |
Señal del notificador:
| void | resizingChanged() |
[read-only] states : QList<int>
Esta propiedad contiene los últimos estados que el cliente reconoció para este QWaylandToplevel.
Notifier:
| void | statesChanged() |
[read-only] title : QString
Esta propiedad contiene el título de la QWaylandXdgToplevel.
Funciones de acceso:
| QString | title() const |
Señal del notificador:
| void | titleChanged() |
[read-only] xdgSurface : QWaylandXdgSurface* const
Esta propiedad contiene el QWaylandXdgSurface para este QWaylandXdgToplevel.
Funciones de acceso:
| QWaylandXdgSurface * | xdgSurface() const |
Documentación de funciones miembro
[explicit] QWaylandXdgToplevel::QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource)
Construye un QWaylandXdgToplevel para los datos xdgSurface y resource.
[static] QWaylandXdgToplevel *QWaylandXdgToplevel::fromResource(wl_resource *resource)
Devuelve el QWaylandXdgToplevel correspondiente al resource.
[static] QWaylandSurfaceRole *QWaylandXdgToplevel::role()
Devuelve el rol de superficie para el QWaylandToplevel.
[invokable] void QWaylandXdgToplevel::sendClose()
Envía un evento de cierre al cliente. El cliente puede elegir ignorar el evento.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
uint QWaylandXdgToplevel::sendConfigure(const QSize &size, const QList<QWaylandXdgToplevel::State> &states)
Envía un evento de configuración al cliente. El parámetro size contiene el tamaño en píxeles de la superficie. Un tamaño de cero significa que el cliente es libre de decidir el tamaño. Los states conocidos se enumeran en QWaylandXdgToplevel::State.
[invokable] uint QWaylandXdgToplevel::sendFullscreen(const QSize &size)
Conveniencia para enviar un evento configure con el estado fullscreen activado, y maximizado y redimensionado eliminados. El estado activado se deja en su estado actual.
size es el nuevo tamaño de la ventana.
Nota: Esta función puede ser invocada a través del sistema de meta-objetos y desde QML. Véase Q_INVOKABLE.
Véase también sendUnmaximized.
[invokable] uint QWaylandXdgToplevel::sendMaximized(const QSize &size)
Conveniencia para enviar un evento configure con el estado maximizado establecido, y fullscreen y resizing eliminados. El estado activado se deja en su estado actual.
size es el nuevo tamaño de la ventana.
Nota: Esta función puede ser invocada a través del sistema de meta-objetos y desde QML. Véase Q_INVOKABLE.
[invokable] uint QWaylandXdgToplevel::sendResizing(const QSize &maxSize)
Conveniencia para enviar un evento configure con el estado resizing activado, y maximized y fullscreen eliminados. El estado activado se deja en su estado actual.
maxSize es el nuevo tamaño de la ventana.
Nota: Esta función puede ser invocada a través del sistema de meta-objetos y desde QML. Véase Q_INVOKABLE.
[invokable] uint QWaylandXdgToplevel::sendUnmaximized(const QSize &size = QSize(0, 0))
Conveniencia para enviar un evento configure con los estados maximizado, fullscreen y redimensionado eliminados, y fullscreen y redimensionado eliminados. El estado activado se deja en su estado actual.
size es el nuevo tamaño de la ventana. Si size es cero, el cliente decide el tamaño.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] QSize QWaylandXdgToplevel::sizeForResize(const QSizeF &size, const QPointF &delta, Qt::Edges edges) const
Conveniencia para calcular el nuevo tamaño dado el size actual , un delta, y el edges activo en el arrastre.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase 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.
