QWaylandSurfaceRole Class

Descripción detallada

QWaylandSurfaceRole se utiliza para representar el rol de una QWaylandSurface. De acuerdo con la especificación del protocolo, el rol de una superficie es permanente una vez establecido, y si la misma superficie se reutiliza posteriormente para un rol diferente, esto constituye un error de protocolo. Establecer la superficie con el mismo rol varias veces no constituye un error.

Por ejemplo, QWaylandXdgShell puede asignar funciones "emergente" o "nivel superior" a las superficies. Si se solicita get_toplevel en una superficie que ha recibido previamente una solicitud get_popup, el compositor emitirá 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 típica de asignar un rol es tener un objeto estático QWaylandSurfaceRole para representarlo.

class MyShellSurfaceSubType
{
    static QWaylandSurfaceRole s_role;
    // ...
};

// ...

surface->setRole(&MyShellSurfaceSubType::s_role, resource->handle, MY_ERROR_CODE);