QWaylandSurfaceRole Class

Ausführliche Beschreibung

QWaylandSurfaceRole dient zur Darstellung der Rolle einer QWaylandSurface. Gemäß der Protokollspezifikation ist die Rolle einer Oberfläche nach ihrer Festlegung dauerhaft, und wenn dieselbe Oberfläche später für eine andere Rolle wiederverwendet wird, stellt dies einen Protokollfehler dar. Das mehrmalige Festlegen derselben Rolle für die Oberfläche ist kein Fehler.

Beispielsweise kann das „ QWaylandXdgShell “ Oberflächen entweder die Rolle „popup“ oder „toplevel“ zuweisen. Wird für eine Oberfläche, die zuvor eine „ get_popup “-Anforderung erhalten hat, eine „ get_toplevel “-Anforderung gestellt, löst der Compositor einen Protokollfehler aus.

Rollen werden anhand ihres Zeigerwerts verglichen, sodass zwei beliebige Objekte von `QWaylandSurfaceRole` als unterschiedliche Rollen betrachtet werden, unabhängig davon, welche ` names ` sie haben. Eine typische Methode zur Zuweisung einer Rolle besteht darin, ein statisches `QWaylandSurfaceRole`-Objekt zu verwenden, das diese Rolle repräsentiert.

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

// ...

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