QWaylandSurfaceRole Class

Description détaillée

QWaylandSurfaceRole est utilisé pour représenter le rôle d'une surface QWaylandSurface. Selon la spécification du protocole, le rôle d'une surface est permanent une fois qu'il a été défini, et si la même surface est réutilisée ultérieurement pour un rôle différent, cela constitue une erreur de protocole. Le fait d'attribuer plusieurs fois le même rôle à une surface ne constitue pas une erreur.

À titre d'exemple, le site QWaylandXdgShell peut attribuer des rôles "popup" ou "toplevel" aux surfaces. Si get_toplevel est demandé sur une surface qui a déjà reçu une demande get_popup, le compositeur émettra une erreur de protocole.

Les rôles sont comparés en fonction de la valeur du pointeur, de sorte que deux objets QWaylandSurfaceRole seront considérés comme des rôles différents, quelle que soit leur adresse names. Une façon typique d'attribuer un rôle est d'avoir un objet statique QWaylandSurfaceRole pour le représenter.

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

// ...

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