QWaylandXdgToplevel Class
La clase QWaylandXdgToplevel representa las partes específicas de la ventana de nivel superior de una superficie xdg. Más información...
| Encabezado: | #include <QWaylandXdgToplevel> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
| En QML: | XdgToplevel |
| Heredan: | 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 &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 |
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 ofrece una forma de ampliar la funcionalidad de un QWaylandXdgSurface con características específicas de las ventanas de estilo escritorio.
Se corresponde con la interfaz de Wayland « xdg_toplevel ».
Documentación sobre los tipos de miembros
enum QWaylandXdgToplevel::DecorationMode
Este tipo de enumeración 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 la ventana. |
QWaylandXdgToplevel::ClientSideDecoration | 1 | El cliente debe dibujar las decoraciones de la ventana. |
Documentación de la propiedad
[read-only] activated : bool
Esta propiedad indica si «toplevel» se muestra como si tuviera el foco de entrada.
Funciones de acceso:
| bool | activated() const |
Señal de notificador:
| void | activatedChanged() |
[read-only] appId : QString
Esta propiedad contiene el identificador de la aplicación de QWaylandXdgToplevel. Se corresponde con desktopFileName en Qt XML.
Funciones de acceso:
| QString | appId() const |
Señal del notificador:
| void | appIdChanged() |
[read-only] decorationMode : enum DecorationMode
Esta propiedad almacena el modo de decoración de ventana actual de este elemento de nivel superior.
Funciones de acceso:
| QWaylandXdgToplevel::DecorationMode | decorationMode() const |
Señal de notificación:
| void | decorationModeChanged() |
Véase también « QWaylandXdgDecorationManagerV1 ».
[read-only] fullscreen : bool
Esta propiedad indica si el cliente ha confirmado que debe mostrarse en pantalla completa.
Funciones de acceso:
| bool | fullscreen() const |
Señal de notificación:
| void | fullscreenChanged() |
[read-only] maxSize : QSize
Esta propiedad establece el tamaño máximo del « QWaylandXdgToplevel ».
El compositor puede ignorar este valor y solicitar un tamaño mayor.
Funciones de acceso:
| QSize | maxSize() const |
Señal de notificación:
| void | maxSizeChanged() |
[read-only] maximized : bool
Esta propiedad indica si el cliente ha confirmado que debe maximizarse.
Funciones de acceso:
| bool | maximized() const |
Señal del notificador:
| void | maximizedChanged() |
[read-only] minSize : QSize
Esta propiedad establece el tamaño mínimo del « QWaylandXdgToplevel ».
El compositor puede ignorar este valor y solicitar un tamaño menor.
Funciones de acceso:
| QSize | minSize() const |
Señal de notificador:
| void | minSizeChanged() |
[read-only, since 6.8] modal : bool
Esta propiedad determina si el bloque de nivel superior impide que otras ventanas reciban entradas.
Esta enumeración 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 elemento « XdgToplevel » principal de este « XdgToplevel ».
Funciones de acceso:
| QWaylandXdgToplevel * | parentToplevel() const |
Señal de notificador:
| void | parentToplevelChanged() |
[read-only] resizing : bool
Esta propiedad indica si el cliente ha confirmado que se está cambiando su tamaño.
Funciones de acceso:
| bool | resizing() const |
Señal de notificación:
| void | resizingChanged() |
[read-only] states : QList<int>
Esta propiedad contiene los últimos estados que el cliente ha confirmado para este QWaylandToplevel.
Señal de Notifier:
| void | statesChanged() |
[read-only] title : QString
Esta propiedad ostenta el título de « QWaylandXdgToplevel ».
Funciones de acceso:
| QString | title() const |
Señal de notificación:
| void | titleChanged() |
[read-only] xdgSurface : QWaylandXdgSurface* const
Esta propiedad contiene el « QWaylandXdgSurface » correspondiente a este « QWaylandXdgToplevel ».
Funciones de Access:
| QWaylandXdgSurface * | xdgSurface() const |
Documentación de las funciones de miembro
[explicit] QWaylandXdgToplevel::QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource)
Crea un objeto `QWaylandXdgToplevel` a partir de los valores proporcionados en ` xdgSurface ` y ` resource`.
[static] QWaylandXdgToplevel *QWaylandXdgToplevel::fromResource(wl_resource *resource)
Devuelve el objeto ` QWaylandXdgToplevel ` correspondiente al objeto ` resource`.
[static] QWaylandSurfaceRole *QWaylandXdgToplevel::role()
Devuelve el rol de superficie del objeto `QWaylandToplevel`.
[invokable] void QWaylandXdgToplevel::sendClose()
Envía un evento de cierre al cliente. El cliente puede optar por ignorar el evento.
Nota: Esta función se puede invocar 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 igual a cero significa que el cliente puede decidir libremente el tamaño. Los valores de ` states ` conocidos se enumeran en `QWaylandXdgToplevel::State`.
[invokable] uint QWaylandXdgToplevel::sendFullscreen(const QSize &size)
Facilita el envío de un evento de configuración con el estado de pantalla completa activado, y elimina las opciones de maximización y cambio de tamaño. El estado de activación se mantiene tal y como está.
size es el nuevo tamaño de la ventana.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también sendUnmaximized.
[invokable] uint QWaylandXdgToplevel::sendMaximized(const QSize &size)
Facilita el envío de un evento de configuración con el estado «maximizado» activado, y sin los estados «pantalla completa» y «cambio de tamaño». El estado «activado» se mantiene tal y como está.
size es el nuevo tamaño de la ventana.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] uint QWaylandXdgToplevel::sendResizing(const QSize &size)
Facilita el envío de un evento de configuración con el estado de cambio de tamaño establecido y los estados «maximizado» y «pantalla completa» desactivados. El estado «activado» se mantiene tal y como está.
size es el nuevo tamaño de la ventana.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] uint QWaylandXdgToplevel::sendUnmaximized(const QSize &size = QSize(0, 0))
Opción para enviar un evento de configuración en el que se eliminan los estados «maximizado», «pantalla completa» y «cambio de tamaño», y se eliminan los estados «pantalla completa» y «cambio de tamaño». El estado «activado» se mantiene tal y como está.
size es el nuevo tamaño de la ventana. Si size es cero, el cliente decide el tamaño.
Nota: Esta función se puede invocar 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
Función práctica para calcular el nuevo tamaño a partir del size actual, un delta y el edges activos durante el arrastre.
Nota: Esta función se puede invocar 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.