En esta página

XdgToplevel QML Type

XdgToplevel representa las partes específicas de la ventana de nivel superior de una superficie xdg. Más información...

Import Statement: import QtWayland.Compositor.XdgShell
In C++: QWaylandXdgToplevel

Propiedades

Métodos

Descripción detallada

Este tipo forma parte de la extensión XdgShell y ofrece una forma de ampliar la funcionalidad de un XdgSurface con características específicas de las ventanas de estilo escritorio.

Se corresponde con la interfaz de Wayland xdg_toplevel.

Documentación de propiedades

activated : bool [read-only]

Esta propiedad indica si «toplevel» se representa a sí mismo como si tuviera el foco de entrada.

appId : string [read-only]

Esta propiedad contiene el identificador de la aplicación de XdgToplevel. Se corresponde con el desktopFileName en Qt XML.

decorationMode : enumeration [read-only]

Esta propiedad almacena el modo de decoración de ventana actual de este elemento de nivel superior.

Los valores posibles son:

ConstanteDescripción
XdgToplevel.ServerSideDecorationEl compositor debe dibujar las decoraciones de la ventana.
XdgToplevel.ClientSideDecorationEl cliente debe dibujar las decoraciones de la ventana.

Véase también XdgDecorationManagerV1.

fullscreen : bool [read-only]

Esta propiedad se mantiene independientemente de si el cliente ha confirmado que debe mostrarse en pantalla completa.

maxSize : size [read-only]

Esta propiedad contiene el tamaño máximo de la imagen « XdgToplevel » solicitado por el cliente.

El compositor puede ignorar este valor y solicitar un tamaño mayor.

maximized : bool [read-only]

Esta propiedad se cumple independientemente de que el cliente haya reconocido que debe maximizarse.

minSize : size [read-only]

Esta propiedad contiene el tamaño mínimo de la imagen « XdgToplevel » solicitado por el cliente.

El compositor puede ignorar este valor y solicitar un tamaño menor.

Esta propiedad determina si «toplevel» impide que otras ventanas reciban entradas.

Esta propiedad se introdujo en Qt 6.8.

parentToplevel : XdgToplevel [read-only]

Esta propiedad contiene el elemento « XdgToplevel » principal de este « XdgToplevel ».

resizing : bool [read-only]

Esta propiedad indica si el cliente ha confirmado que se está cambiando el tamaño.

title : string [read-only]

Esta propiedad ostenta el título de « XdgToplevel ».

xdgSurface : XdgSurface [read-only]

Esta propiedad contiene el objeto « XdgSurface » correspondiente a este « XdgToplevel ».

Documentación del método

void sendClose()

Envía un evento de cierre al cliente. El cliente puede optar por ignorar el evento.

int sendConfigure(size size, list<int> states)

Envía un evento de configuración al cliente. ` 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 posibles para states son:

ConstanteDescripción
XdgToplevel.MaximizedStateLa superficie está maximizada
XdgToplevel.FullscreenStateLa superficie está a pantalla completa
XdgToplevel.ResizingStateSe está cambiando el tamaño de la superficie
XdgToplevel.ActivatedStateLa superficie ya está activa

void sendFullscreen(size size)

Facilita el envío de un evento de configuración con el estado de pantalla completa activado, y se han eliminado las opciones de maximizar y cambiar el tamaño. El estado de activación se mantiene tal y como está.

size es el nuevo tamaño de la ventana.

Véase también sendUnmaximized.

void sendMaximized(size size)

Facilidad para enviar un evento «configure» con el estado «maximizado» establecido y los estados «pantalla completa» y «cambio de tamaño» eliminados. El estado «activado» se mantiene tal y como está.

size es el nuevo tamaño de la ventana.

void sendResizing(size 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.

void sendUnmaximized(size size)

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 «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.

size sizeForResize(size size, point delta, uint edges)

Forma práctica de calcular la nueva talla, partiendo de la « size » actual, una « delta » y la « edges » activa en el arrastre.

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