QWaylandSurface Class

メンバ関数ドキュメント

QWaylandSurface::QWaylandSurface()

未初期化の QWaylandSurface を構築します。

QWaylandSurface::QWaylandSurface(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)

与えられたcompositor とclient のために、そして与えられたid とversion のために QWaylandSurface を構築し、初期化します。

[override virtual noexcept] QWaylandSurface::~QWaylandSurface()

QWaylandSurface を破棄します。

[signal] void QWaylandSurface::childAdded(QWaylandSurface *child)

このシグナルは wl_subsurface,child がサーフェスに追加されたときに発せられます。

QWaylandCompositor *QWaylandSurface::compositor() const

このQWaylandSurface のコンポジターを返します。

[invokable] void QWaylandSurface::destroy()

QWaylandSurface を破棄します。

[signal] void QWaylandSurface::dragStarted(QWaylandDrag *drag)

このシグナルは、このサーフェスからdrag が開始されたときに発せられます。

[invokable] void QWaylandSurface::frameStarted()

すべてのフレームのコールバックを送信準備します。

[static] QWaylandSurface *QWaylandSurface::fromResource(wl_resource *resource)

Waylandリソースresource に対応するQWaylandSurface を返します。

[invokable] void QWaylandSurface::initialize(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)

与えられたcompositor とclient でQWaylandSurface を初期化し、与えられたid とversion で を初期化します。

bool QWaylandSurface::inputRegionContains(const QPoint &p) const

QWaylandSurface の入力領域に点p が含まれる場合はtrue を返します。そうでない場合はfalse を返します。

bool QWaylandSurface::inputRegionContains(const QPointF &position) const

QWaylandSurface の入力領域に点position が含まれる場合はtrue を返す。それ以外の場合はfalse を返す。

[invokable] bool QWaylandSurface::isDestroyed() const

QWaylandSurface が破壊された場合は true を返す。それ以外の場合は偽を返す。

bool QWaylandSurface::isInitialized() const

QWaylandSurface が初期化されていれば真を返します。

QWaylandView *QWaylandSurface::primaryView() const

このQWaylandSurface のプライマリ・ビューを返します。

QWaylandView::advance() およびQWaylandSurface::setPrimaryView()も参照 。

struct wl_resource *QWaylandSurface::resource() const

このQWaylandSurface に対応する Wayland リソースを返します。

[invokable] void QWaylandSurface::sendFrameCallbacks()

保留中のフレームコールバックを送信します。

void QWaylandSurface::setPrimaryView(QWaylandView *view)

このサーフェスに複数のビューがある場合、このQWaylandSurface のプライマリビューをview に設定します。プライマリビューはクライアントのリフレッシュレートを管理するビューです。このビューは、QWaylandView::advance() が呼び出されたときにバッファ参照を破棄します。詳細はQWaylandView::advance() のドキュメントを参照してください。

QWaylandWlShellIntegration や QWaylandXdgShellV5Integration などのシェルサーフェス統合では、クライアントからの最大化およびフルスクリーンリクエストは、統合がサーフェスのプライマリビューを持っている場合にのみ効果があります。

primaryView() およびQWaylandView::advance()も参照してください 。

bool QWaylandSurface::setRole(QWaylandSurfaceRole *role, wl_resource *errorResource, uint32_t errorCode)

サーフェスにrole を設定します。ロールはサーフェスがスクリーン上でどのようにマッピングされるかを定義します。一度ロールがサーフェスに割り当てられると、これが永続的なロールになります。それ以降、異なるロールでsetRole() を呼び出すと、errorResource にプロトコルエラーが発生し、errorCode がクライアントに送信される。この要件を強制することが、サーフェスロールの主な目的である。

role はポインタ値で比較される。QWaylandSurfaceRole 、2つのオブジェクトはその名前に関係なく、異なるロールとみなされます。

サーフェスロールは、例えばシェル拡張などでサーフェスが特定の目的に採用された場合、プロトコル実装によって内部的に設定されます。このような方法でサーフェスを使用する拡張機能を開発していない限り、この関数を呼び出すべきではありません。

ロールを割り当てることができればtrueを返し、そうでなければfalseを返します。

[signal] void QWaylandSurface::surfaceDestroyed()

このシグナルは、対応するwl_surfaceが破棄されたときに発行されます。

[slot] void QWaylandSurface::updateSelection()

コンポジターが保持するクリップボード選択でサーフェスを更新します。これはサーフェスがキーボードフォーカスを受け取ると自動的に行われますが、この関数はキーボードフォーカスを持たないクライアントを更新するのに便利です。

QList<QWaylandView *> QWaylandSurface::views() const

このQWaylandSurface のビューを返します。

wl_client *QWaylandSurface::waylandClient() const

このQWaylandSurface を使用してwl_client を保持します。