WaylandSurface QML Type
Stellt einen rechteckigen Bereich auf einem Ausgabegerät dar. Mehr...
| Import Statement: | import QtWayland.Compositor |
| In C++: | QWaylandSurface |
Eigenschaften
- bufferScale : size
- bufferSize : size
- client : WaylandClient
- contentOrientation : enum
- cursorSurface : bool
- destinationSize : size
- hasContent : bool
- inhibitsIdle : bool
- isOpaque : bool
(since 6.4) - origin : enum
- sourceGeometry : rect
- useTextureAlpha : bool
Signale
- childAdded(WaylandSurface child)
- void dragStarted(WaylandDrag drag)
- surfaceDestroyed()
Methoden
- void destroy()
- void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)
- bool isDestroyed()
Detaillierte Beschreibung
Dieser Typ kapselt einen rechteckigen Bereich von Pixeln, der auf einem Ausgabegerät angezeigt wird. Er entspricht der Schnittstelle wl_surface im Wayland-Protokoll.
Eigenschaft Dokumentation
bufferScale : size [read-only]
Diese Eigenschaft enthält die Pufferskala von WaylandSurface. Mit der Pufferskala kann ein Client Pufferdaten mit höherer Auflösung für die Verwendung bei hochauflösenden Ausgaben bereitstellen.
bufferSize : size [read-only]
Diese Eigenschaft enthält die Größe des aktuellen Puffers dieses WaylandSurface in Pixeln, nicht in Oberflächenkoordinaten.
Für die Größe in Oberflächenkoordinaten, verwenden Sie stattdessen destinationSize.
Siehe auch destinationSize und bufferScale.
client : WaylandClient [read-only]
Diese Eigenschaft hält den Kunden, der diese WaylandSurface verwendet.
contentOrientation : enum [read-only]
Diese Eigenschaft gibt die Ausrichtung des Inhalts von WaylandSurface an.
Siehe auch WaylandOutput.transform.
cursorSurface : bool
Diese Eigenschaft gibt an, ob es sich bei WaylandSurface um eine Cursorfläche handelt.
destinationSize : size [read-only]
Diese Eigenschaft enthält die Größe dieser WaylandSurface in Oberflächenkoordinaten.
Siehe auch bufferScale und bufferSize.
hasContent : bool [read-only]
Diese Eigenschaft gibt an, ob die Seite WaylandSurface einen Inhalt hat.
inhibitsIdle : bool [read-only]
Diese Eigenschaft gibt an, ob diese Oberfläche das Leerlaufverhalten des Compositors, wie z. B. das Ausblenden, Sperren und Speichern des Bildschirms, unterbinden soll.
Siehe auch IdleInhibitManagerV1.
isOpaque : bool [read-only, since 6.4]
Diese Eigenschaft gibt an, ob die Oberfläche vollständig undurchsichtig ist, wie vom Client über die set_opaque_region-Anforderung gemeldet.
Diese Eigenschaft wurde in Qt 6.4 eingeführt.
origin : enum [read-only]
Diese Eigenschaft enthält den Ursprung des Puffers von WaylandSurface bzw. WaylandSurface.OriginTopLeft, wenn die Oberfläche keinen Puffer hat.
Sie kann die folgenden Werte annehmen:
- WaylandSurface.OriginTopLeft Der Ursprung ist die linke obere Ecke des Puffers.
- WaylandSurface.OriginBottomLeft Der Ursprung ist die linke untere Ecke des Puffers.
sourceGeometry : rect [read-only]
Diese Eigenschaft beschreibt den Teil des angehängten Wayland-Puffers, der auf dem Bildschirm gezeichnet werden soll. Die Koordinaten gehen von der Ecke des Puffers aus und werden durch bufferScale skaliert.
Siehe auch bufferScale, bufferSize, und destinationSize.
useTextureAlpha : bool
Diese Eigenschaft gibt an, ob die Oberfläche die Textur Alpha verwenden soll.
Signal-Dokumentation
childAdded(WaylandSurface child)
Dieses Signal wird ausgegeben, wenn eine wl_subsurface, child, zur Oberfläche hinzugefügt wurde.
Hinweis: Der entsprechende Handler ist onChildAdded.
void dragStarted(WaylandDrag drag)
Dieses Signal wird ausgegeben, wenn ein drag von dieser Oberfläche aus gestartet wurde.
Hinweis: Der entsprechende Handler ist onDragStarted.
surfaceDestroyed()
Dieses Signal wird ausgegeben, wenn die entsprechende wl_Oberfläche zerstört wird.
Hinweis: Der entsprechende Handler ist onSurfaceDestroyed.
Dokumentation der Methode
void destroy()
Zerstört die WaylandSurface.
void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)
Initialisiert WaylandSurface mit den angegebenen compositor und client, sowie mit den angegebenen id und version.
bool isDestroyed()
Gibt true zurück, wenn die WaylandSurface zerstört wurde. Andernfalls wird false zurückgegeben.
© 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.