QWaylandSurfaceRole Class
La clase `QWaylandSurfaceRole` representa la función de la superficie en el contexto de `wl_surface`. Más información...
| Encabezado: | #include <QWaylandSurfaceRole> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
Funciones públicas
| QWaylandSurfaceRole(const QByteArray &name) | |
| const QByteArray | name() |
Descripción detallada
QWaylandSurfaceRole se utiliza para representar el rol de una superficie de forma emergente ( QWaylandSurface). Según la especificación del protocolo, el rol de una superficie es permanente una vez establecido, y si posteriormente se reutiliza la misma superficie para un rol diferente, esto constituye un error de protocolo. Establecer la superficie en el mismo rol varias veces no es un error.
A modo de ejemplo, el ` QWaylandXdgShell ` puede asignar a las superficies los roles «popup» o «toplevel». Si se solicita ` get_toplevel ` en una superficie que previamente ha recibido una solicitud de ` get_popup `, el compositor generará un error de protocolo.
Los roles se comparan por el valor del puntero, por lo que dos objetos cualesquiera de `QWaylandSurfaceRole` se considerarán roles diferentes, independientemente de cuáles sean sus ` names `. Una forma habitual de asignar un rol es disponer de un objeto `QWaylandSurfaceRole` estático que lo represente.
class MyShellSurfaceSubType
{
static QWaylandSurfaceRole s_role;
// ...
};
// ...
surface->setRole(&MyShellSurfaceSubType::s_role, resource->handle, MY_ERROR_CODE);Documentación de las funciones miembro
QWaylandSurfaceRole::QWaylandSurfaceRole(const QByteArray &name)
Crea un objeto `QWaylandSurfaceRole` y le asign name. El nombre se utiliza en los mensajes de error relacionados con este `QWaylandSurfaceRole`.
const QByteArray QWaylandSurfaceRole::name()
Devuelve el nombre de la « QWaylandSurfaceRole ». Este nombre se utiliza en los mensajes de error relacionados con esta « QWaylandSurfaceRole », por ejemplo, si se intenta cambiar la función de una superficie.
© 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.