QWaylandSurfaceRole Class

詳細説明

QWaylandSurfaceRoleは、QWaylandSurface 。プロトコルの仕様によると、サーフェスのロールは一度設定されると永続的であり、同じサーフェスが後に別のロールに再利用された場合、これはプロトコルエラーとなる。表面を同じ役割に複数回設定してもエラーにはならない。

例として、QWaylandXdgShell 、サーフェスに「ポップアップ」または「トップレベル」の役割を割り当てることができます。以前にget_popup リクエストを受けたサーフェスでget_toplevel リクエストされた場合、コンポジターはプロトコルエラーを発行します。

ロールはポインタ値で比較されるため、QWaylandSurfaceRoleの2つのオブジェクトは、names に関係なく、異なるロールとみなされます。ロールを割り当てる典型的な方法は、それを表す静的なQWaylandSurfaceRoleオブジェクトを持つことです。

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

// ...

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