このページでは

QWaylandXdgOutputV1 Class

コンポジター内の表示を表します。詳細...

ヘッダー: #include <QWaylandXdgOutputV1>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
QML内: XdgOutputV1
継承元: QObject

プロパティ

パブリック関数

QString description() const
QRect logicalGeometry() const
QPoint logicalPosition() const
QSize logicalSize() const
QString name() const
QWaylandOutput *output() const
void setDescription(const QString &name)
void setLogicalPosition(const QPoint &position)
void setLogicalSize(const QSize &size)
void setName(const QString &name)

シグナル

詳細な説明

プロパティのドキュメント

description : QString

このプロパティには、この出力の説明が格納されます。

説明については、定義された規約はありません。

初期化後にこのプロパティを変更しても、変更は反映されません。

アクセス関数:

QString description() const
void setDescription(const QString &name)

通知信号:

void descriptionChanged()

[read-only] logicalGeometry : QRect

このプロパティは、グローバルコンポジター空間における出力の位置とサイズを保持します。これは、論理位置と論理サイズの組み合わせです。

アクセス関数:

QRect logicalGeometry() const

通知シグナル:

void logicalGeometryChanged()

関連項目: QWaylandXdgOutputV1::logicalPosition およびQWaylandXdgOutputV1::logicalSize 。

logicalPosition : QPoint

このプロパティは、グローバルコンポジター空間内における出力の座標を保持します。

デフォルト値は 0,0 です。

アクセス関数:

QPoint logicalPosition() const
void setLogicalPosition(const QPoint &position)

通知シグナル:

void logicalPositionChanged()

logicalSize : QSize

このプロパティは、グローバルコンポジター空間における出力のサイズを保持します。

デフォルト値は -1,-1 ですが、これは無効です。

これは物理的なサイズではなく、論理的なサイズであることにご注意ください。たとえば、WaylandOutput モードで解像度が3840x2160、スケーリング係数が2の場合:

  • サーフェスバッファをスケーリングしないコンポジターは、論理サイズとして 3840x2160 を報告します。
  • サーフェスバッファを自動的にスケーリングするコンポジターは、論理サイズとして 1920x1080 を報告します。
  • スケール係数 1.5 を使用するコンポジターは、論理サイズとして 2560x1620 を報告します。

アクセス関数:

QSize logicalSize() const
void setLogicalSize(const QSize &size)

通知シグナル:

void logicalSizeChanged()

name : QString

このプロパティには、この出力の名前が格納されます。

命名規則はコンポジターによって定義されますが、英数字およびハイフン(「-」)に限定されます。各名前は一意であり、同じハードウェアおよびソフトウェア構成のセッション間でも一貫して維持されます。

名前の例としては、「HDMI-A-1」、「WL-1」、「X11-1」などがあります。ただし、その名前が基盤となる技術を反映しているとは限りません。

初期化後にこのプロパティを変更しても、その変更は反映されません。

アクセス関数:

QString name() const
void setName(const QString &name)

通知シグナル:

void nameChanged()

[read-only] output : QWaylandOutput*

このプロパティには、この `QWaylandXdgOutputV1` に関連付けられた `QWaylandOutput ` が格納されます。

アクセス関数:

QWaylandOutput *output() const

通知信号:

void outputChanged()

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.