本页内容

XdgOutputV1 QML Type

表示合成器中的显示器。更多...

Import Statement: import QtWayland.Compositor.XdgShell
In C++: QWaylandXdgOutputV1

属性

详细说明

物业文件

description : string

该属性存储了此输出的描述。

描述内容没有定义任何规范。

初始化后更改此属性将不生效。

logicalGeometry : rect [read-only]

该属性保存了输出在全局合成器空间中的位置和大小。它是逻辑位置和逻辑大小的组合。

另请参阅 XdgOutputV1::logicalPosition 和XdgOutputV1::logicalSize 。

logicalPosition : point

该属性存储输出在全局合成器坐标系中的坐标。

默认值为 0,0。

logicalSize : size

该属性存储输出在全局合成器空间中的尺寸。

默认值为 -1,-1,该值无效。

请注意,这是逻辑尺寸,而非物理尺寸。例如,对于WaylandOutput 模式下3840x2160的分辨率以及缩放因子为2的情况:

  • 如果合成器不缩放表面缓冲区,则会报告逻辑尺寸为 3840x2160。
  • 会自动缩放表面缓冲区的合成器,将报告逻辑尺寸为 1920x1080。
  • 使用 1.5 这个分数缩放比例的合成器,将报告逻辑尺寸为 2560x1620。

manager : XdgOutputManagerV1 [read-only]

该属性保存了管理此XdgOutputV1 的对象。

name : string

该属性存储此输出的名称。

命名规则由合成器定义,但仅限于字母数字字符和连字符(“-”)。每个名称都是唯一的,并且在使用相同硬件和软件配置的会话中将保持一致。

名称示例包括“HDMI-A-1”、“WL-1”、“X11-1”等……但请不要认为名称反映了底层技术。

初始化后更改此属性不会生效。

output : WaylandOutput [read-only]

该属性存储与该XdgOutputV1 关联的WaylandOutput 。

© 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.