QWaylandSurfaceRole Class

Description détaillée

QWaylandSurfaceRole est utilisé pour représenter le rôle d'une surface ( QWaylandSurface). Conformément à la spécification du protocole, le rôle d'une surface est permanent une fois 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. Définir plusieurs fois le même rôle pour une surface ne constitue pas une erreur.

À titre d’exemple, l’ QWaylandXdgShell peut attribuer aux surfaces les rôles « popup » ou « toplevel ». Si une demande de « get_toplevel » est émise sur une surface ayant précédemment reçu une demande de « get_popup », le compositeur générera alors une erreur de protocole.

Les rôles sont comparés par la valeur de leur pointeur ; ainsi, deux objets de type `QWaylandSurfaceRole` quelconques seront considérés comme des rôles différents, quelles que soient leurs ` names `. Une méthode courante pour attribuer un rôle consiste à utiliser un objet `QWaylandSurfaceRole` statique pour le représenter.

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

// ...

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