En esta página

QWaylandXdgOutputV1 Class

Representa una pantalla en un compositor. Más...

Encabezado: #include <QWaylandXdgOutputV1>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
En QML: XdgOutputV1
Heredan de: QObject

Propiedades

Funciones públicas

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)

Señales

Descripción detallada

Documentación de propiedades

description : QString

Esta propiedad contiene la descripción de esta salida.

No se ha definido ninguna convención para la descripción.

Cambiar esta propiedad tras la inicialización no surte efecto.

Funciones de acceso:

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

Señal de notificación:

void descriptionChanged()

[read-only] logicalGeometry : QRect

Esta propiedad contiene la posición y el tamaño de la salida en el espacio global del compositor. Es la combinación de la posición lógica y el tamaño lógico.

Funciones de acceso:

QRect logicalGeometry() const

Señal de notificación:

void logicalGeometryChanged()

Véase también QWaylandXdgOutputV1::logicalPosition y QWaylandXdgOutputV1::logicalSize.

logicalPosition : QPoint

Esta propiedad contiene las coordenadas de la salida en el espacio global del compositor.

El valor por defecto es 0,0.

Funciones de acceso:

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

Señal del notificador:

void logicalPositionChanged()

logicalSize : QSize

Esta propiedad indica el tamaño de la salida en el espacio global del compositor.

El valor por defecto es -1,-1, que no es válido.

Recuerda que se trata del tamaño lógico, no del tamaño físico. Por ejemplo, para un modo « WaylandOutput » de 3840x2160 y un factor de escala de 2:

  • Un compositor que no escale los búferes de superficie indicará un tamaño lógico de 3840x2160.
  • Un compositor que escale automáticamente los búferes de superficie indicará un tamaño lógico de 1920x1080.
  • Un compositor que utilice una escala fraccionaria de 1,5 indicará un tamaño lógico de 2560x1620.

Funciones de acceso:

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

Señal de notificación:

void logicalSizeChanged()

name : QString

Esta propiedad contiene el nombre de esta salida.

La convención de nomenclatura la define el compositor, pero se limita a caracteres alfanuméricos y guiones («-»). Cada nombre es único y se mantendrá constante en todas las sesiones con la misma configuración de hardware y software.

Algunos ejemplos de nombres son «HDMI-A-1», «WL-1», «X11-1», etc. Sin embargo, no se debe dar por sentado que el nombre refleje la tecnología subyacente.

Cambiar esta propiedad tras la inicialización no surtirá efecto.

Funciones de acceso:

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

Señal de notificación:

void nameChanged()

[read-only] output : QWaylandOutput*

Esta propiedad contiene el « QWaylandOutput » asociado a este « QWaylandXdgOutputV1 ».

Funciones de acceso:

QWaylandOutput *output() const

Señal de notificador:

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.