En esta página

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

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.

ConstanteValorDescripción
QWaylandXdgToplevel::ServerSideDecoration2El compositor debe dibujar las decoraciones de la ventana.
QWaylandXdgToplevel::ClientSideDecoration1El 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()

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.