QWaylandSurface Class

メンバ関数ドキュメント

QWaylandSurface::QWaylandSurface()

初期化されていない QWaylandSurface を構築します。

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

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

[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 を返す。そうでない場合は false を返します。

bool QWaylandSurface::isInitialized() const

QWaylandSurface が初期化されていれば true を返す。

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 を保持する。