QWaylandQuickItem Class

QWaylandQuickItem クラスはQWaylandView を表す Qt Quick アイテムを提供します

Header: #include <QWaylandQuickItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
In QML: WaylandQuickItem
Inherits: QQuickItem
Inherited By:

QWaylandQuickShellSurfaceItem

プロパティ

パブリック関数

QWaylandQuickItem(QQuickItem *parent = nullptr)
virtual ~QWaylandQuickItem() override
bool allowDiscardFrontBuffer() const
QWaylandCompositor *compositor() const
bool focusOnClick() const
bool inputEventsEnabled() const
bool inputRegionContains(const QPointF &localPosition) const
bool isBufferLocked() const
bool isPaintEnabled() const
QPointF mapFromSurface(const QPointF &point) const
QPointF mapToSurface(const QPointF &point) const
QWaylandSurface::Origin origin() const
QWaylandOutput *output() const
void setAllowDiscardFrontBuffer(bool discard)
void setBufferLocked(bool locked)
void setFocusOnClick(bool focus)
void setInputEventsEnabled(bool enabled)
void setOutput(QWaylandOutput *output)
void setPrimary()
void setSubsurfaceHandler(QObject *)
void setSurface(QWaylandSurface *surface)
void setTouchEventsEnabled(bool enabled)
QObject *subsurfaceHandler() const
QWaylandSurface *surface() const
bool touchEventsEnabled() const
QWaylandView *view() const

再実装されたパブリック関数

virtual QSGTextureProvider *textureProvider() const override

パブリックスロット

void setPaintEnabled(bool paintEnabled)
virtual void takeFocus(QWaylandSeat *device = nullptr)

シグナル

詳しい説明

Qt Quick でQWaylandCompositor を書くとき、このクラスを使ってクライアントのコンテンツを出力デバイスに表示することができ、ユーザ入力をクライアントに渡すことができます。

プロパティの説明

allowDiscardFrontBuffer : bool

デフォルトでは、新しいバッファが利用可能になり、updatePaintNode() が呼び出されるまで、このアイテムは現在のバッファをロックします。このプロパティを true に設定すると、Qt は、スロットリングビューがバッファを使用しなくなったときに、すぐにバッファを解放することができます。これは、更新間隔が遅いアイテムの場合に便利です。

アクセス関数

bool allowDiscardFrontBuffer() const
void setAllowDiscardFrontBuffer(bool discard)

Notifier シグナル:

void allowDiscardFrontBufferChanged()

bufferLocked : bool

このプロパティは、アイテムのバッファが現在ロックされているかどうかを保持します。バッファがロックされている限り、解放されてクライアントに返されることはありません。

デフォルトは false です。

アクセス関数

bool isBufferLocked() const
void setBufferLocked(bool locked)

Notifier シグナル:

void bufferLockedChanged()

[read-only] compositor : QWaylandCompositor* const

このプロパティは、このQWaylandQuickItem によってレンダリングされたサーフェスのコンポジターを保持します。

アクセス関数

QWaylandCompositor *compositor() const

ノーティファイアシグナル:

void compositorChanged()

focusOnClick : bool

このプロパティは、QWaylandQuickItem がクリックまたはタッチされたときにフォーカスを取るかどうかを指定します。

デフォルトはtrue です。

アクセス関数:

bool focusOnClick() const
void setFocusOnClick(bool focus)

ノーティファイアシグナル:

void focusOnClickChanged()

[read-only] origin : const QWaylandSurface::Origin

このプロパティは、QWaylandQuickItem の原点を保持します。

アクセス関数:

QWaylandSurface::Origin origin() const

ノーティファイア・シグナル:

void originChanged()

output : QWaylandOutput*

このプロパティは、この項目が表示される出力を保持する。

アクセス関数:

QWaylandOutput *output() const
void setOutput(QWaylandOutput *output)

Notifier シグナル:

void outputChanged()

paintEnabled : bool

アイテムが非表示の場合はtrue を保持するが、テクスチャは更新される。visiblefalse に設定してアイテムを非表示にするのとは対照的に、このプロパティをfalse に設定しても、マウスやキーボード入力がアイテムに到達するのを妨げることはない。

アクセス関数

bool isPaintEnabled() const
void setPaintEnabled(bool paintEnabled)

Notifier シグナル:

void paintEnabledChanged()

surface : QWaylandSurface*

このプロパティは、このQWaylandQuickItem によってレンダリングされたサーフェスを保持します。

アクセス関数

QWaylandSurface *surface() const
void setSurface(QWaylandSurface *surface)

ノーティファイアシグナル:

void surfaceChanged()

touchEventsEnabled : bool

このプロパティは、タッチイベントがクライアントサーフェスに転送される場合はtrue を保持し、そうでない場合はfalse を保持する。

アクセス関数:

bool touchEventsEnabled() const
void setTouchEventsEnabled(bool enabled)

ノーティファイアシグナル:

void touchEventsEnabledChanged()

メンバー関数ドキュメント

QWaylandQuickItem::QWaylandQuickItem(QQuickItem *parent = nullptr)

与えられたparent で QWaylandQuickItem を構築します。

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

QWaylandQuickItem を破棄します。

bool QWaylandQuickItem::inputRegionContains(const QPointF &localPosition) const

このアイテムのサーフェスの入力領域がlocalPosition で与えられた位置を含む場合、true を返します。

[invokable] QPointF QWaylandQuickItem::mapFromSurface(const QPointF &point) const

Waylandサーフェスの座標系で指定されたpoint を、このアイテムの座標系内の等価点にマップし、マップされた座標を返す。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] QPointF QWaylandQuickItem::mapToSurface(const QPointF &point) const

このアイテムの座標系で与えられたpoint を Wayland サーフェスの座標系で等価な点にマップし、マップされた座標を返す。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] void QWaylandQuickItem::setPrimary()

このQWaylandQuickItem のビューをサーフェスのプライマリビューにします。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

QWaylandSurface::primaryViewも参照してください

[signal] void QWaylandQuickItem::surfaceDestroyed()

このシグナルは、クライアントがQWaylandQuickItem に関連付けられているwl_surface を破棄したときに発行されます。 このシグナルのハンドラは、QWaylandQuickItem を直ちに破棄するか、クローズアニメーションを開始してから Item を破棄することが期待されています。

アニメーションが開始された場合、アニメーションが終了するまでアイテムのコンテンツが保持されるようにbufferLocked を設定する必要があります。

QWaylandQuickItem::bufferLockedも参照してください

[virtual slot] void QWaylandQuickItem::takeFocus(QWaylandSeat *device = nullptr)

この関数を呼び出すと、アイテムは入力device のフォーカスを取得します。

[override virtual] QSGTextureProvider *QWaylandQuickItem::textureProvider() const

再インプリメント:QQuickItem::textureProvider() const.

このQWaylandQuickItem のテクスチャプロバイダを返します。

QWaylandView *QWaylandQuickItem::view() const

このQWaylandQuickItem によってレンダリングされたビューを返します。

©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。