QWaylandSurfaceRole Class

Detaillierte Beschreibung

QWaylandSurfaceRole wird verwendet, um die Rolle einer QWaylandSurface zu repräsentieren. Gemäß der Protokollspezifikation ist die Rolle einer Oberfläche dauerhaft, wenn sie einmal gesetzt wurde, und wenn die gleiche Oberfläche später für eine andere Rolle wiederverwendet wird, stellt dies einen Protokollfehler dar. Das mehrfache Setzen der Oberfläche auf dieselbe Rolle ist kein Fehler.

So kann beispielsweise QWaylandXdgShell Oberflächen entweder die Rolle "Popup" oder "Toplevel" zuweisen. Wenn get_toplevel auf einer Oberfläche angefordert wird, die zuvor eine get_popup -Anforderung erhalten hat, dann gibt der Compositor einen Protokollfehler aus.

Rollen werden anhand von Zeigerwerten verglichen, so dass zwei beliebige Objekte von QWaylandSurfaceRole als unterschiedliche Rollen betrachtet werden, unabhängig davon, wie ihre names lauten. Ein typischer Weg, eine Rolle zuzuweisen, ist ein statisches QWaylandSurfaceRole-Objekt, das diese Rolle repräsentiert.

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

// ...

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