Sur cette page

QWaylandXdgOutputV1 Class

Représente un écran dans un compositeur. En savoir plus…

En-tête : #include <QWaylandXdgOutputV1>
CMake : find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake : QT += waylandcompositor
En QML : XdgOutputV1
Hérite de : QObject

Propriétés

Fonctions publiques

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)

Signaux

Description détaillée

Documentation sur les propriétés

description : QString

Cette propriété contient la description de cette sortie.

Aucune convention n'est définie pour cette description.

La modification de cette propriété après l'initialisation n'a aucun effet.

Fonctions d'accès :

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

Signal de notification :

void descriptionChanged()

[read-only] logicalGeometry : QRect

Cette propriété contient la position et la taille de la sortie dans l'espace global du compositeur. Elle correspond à la combinaison de la position logique et de la taille logique.

Fonctions d'accès :

QRect logicalGeometry() const

Signal de notification :

void logicalGeometryChanged()

Voir également QWaylandXdgOutputV1::logicalPosition et QWaylandXdgOutputV1::logicalSize.

logicalPosition : QPoint

Cette propriété contient les coordonnées de la sortie dans l'espace global du compositeur.

La valeur par défaut est 0,0.

Fonctions d'accès :

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

Signal de notification :

void logicalPositionChanged()

logicalSize : QSize

Cette propriété indique la taille de la sortie dans l'espace du compositeur global.

La valeur par défaut est -1,-1, ce qui n’est pas valide.

N'oubliez pas qu'il s'agit de la taille logique, et non de la taille physique. Par exemple, pour un mode « WaylandOutput » de 3840x2160 et un facteur d'échelle de 2 :

  • Un compositeur qui ne redimensionne pas les tampons de surface indiquera une taille logique de 3840x2160.
  • Un compositeur qui redimensionne automatiquement les tampons de surface indiquera une taille logique de 1920x1080.
  • Un compositeur utilisant un facteur d'échelle fractionnaire de 1,5 indiquera une taille logique de 2560 × 1620.

Fonctions d'accès :

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

Signal de notification :

void logicalSizeChanged()

name : QString

Cette propriété contient le nom de cette sortie.

La convention de nommage est définie par le compositeur, mais se limite aux caractères alphanumériques et aux tirets (« - »). Chaque nom est unique et restera identique d'une session à l'autre avec la même configuration matérielle et logicielle.

Exemples de noms : « HDMI-A-1 », « WL-1 », « X11-1 », etc. Cependant, ne partez pas du principe que le nom reflète la technologie sous-jacente.

La modification de cette propriété après l’initialisation n’a aucun effet.

Fonctions d’accès :

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

Signal de notification :

void nameChanged()

[read-only] output : QWaylandOutput*

Cette propriété contient l'QWaylandOutput e associé à cette QWaylandXdgOutputV1.

Fonctions d'accès :

QWaylandOutput *output() const

Signal de notification :

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.