QWaylandSurfaceRole Class

詳細な説明

QWaylandSurfaceRoleは、QWaylandSurface の役割を表すために使用されます。プロトコル仕様に従い、サーフェスの役割は一度設定されると永続的であり、後で同じサーフェスが異なる役割のために再利用された場合、これはプロトコルエラーとなります。サーフェスを同じ役割に複数回設定することはエラーではありません。

例として、QWaylandXdgShell はサーフェスに「popup」または「toplevel」のいずれかのロールを割り当てることができます。以前にget_popup リクエストを受け取ったサーフェスに対してget_toplevel が要求された場合、コンポジターはプロトコルエラーを発行します。

ロールはポインタ値によって比較されるため、names が何であれ、2つのQWaylandSurfaceRoleオブジェクトは異なるロールと見なされます。ロールを割り当てる一般的な方法は、それを表す静的なQWaylandSurfaceRoleオブジェクトを用意することです。

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

// ...

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