WaylandQuickItem QML Type
Stellt ein Qt Quick Element zur Verfügung, das ein WaylandView darstellt. Mehr...
| Import Statement: | import QtWayland.Compositor |
| In C++: | QWaylandQuickItem |
| Inherited By: |
Eigenschaften
- bufferLocked : bool
- compositor : WaylandCompositor
- focusOnClick : bool
- inputEventsEnabled : bool
- origin : enum
- output : WaylandOutput
- paintEnabled : bool
- subsurfaceHandler : object
- surface : WaylandSurface
- touchEventsEnabled : bool
Signale
- void surfaceDestroyed()
Methoden
- point mapFromSurface(point point)
- point mapToSurface(point point)
- void setPrimary()
Ausführliche Beschreibung
Qt Quick-basierte Wayland-Compositors können diesen Typ verwenden, um den Inhalt eines Clients auf einem Ausgabegerät anzuzeigen. Er gibt Benutzereingaben an den Client weiter.
Eigenschaft Dokumentation
bufferLocked : bool
Diese Eigenschaft gibt an, ob der Puffer des Elements derzeit gesperrt ist. Solange der Puffer gesperrt ist, wird er nicht freigegeben und an den Kunden zurückgegeben.
Der Standardwert ist false.
compositor : WaylandCompositor [read-only]
Diese Eigenschaft enthält den Compositor für die Oberfläche, die von dieser WaylandQuickItem gerendert wird.
focusOnClick : bool
Diese Eigenschaft gibt an, ob der WaylandQuickItem den Fokus erhalten soll, wenn er angeklickt oder berührt wird.
Die Standardeinstellung ist true.
inputEventsEnabled : bool
Diese Eigenschaft gibt an, ob Eingabeereignisse für dieses Element aktiviert sind.
Wenn true aktiviert ist, verarbeitet das Element Eingabeereignisse wie Tastatur- und Mausereignisse; wenn false aktiviert ist, werden Eingabeereignisse ignoriert.
origin : enum [read-only]
Diese Eigenschaft gilt für den Ursprung der QWaylandQuickItem.
output : WaylandOutput
Diese Eigenschaft enthält die Ausgabe, auf der dieses Element angezeigt wird.
paintEnabled : bool
Gibt true zurück, wenn das Element ausgeblendet ist, obwohl die Textur weiterhin aktualisiert wird. Im Gegensatz zum Ausblenden des Elements durch Setzen von visible auf false wird durch das Setzen dieser Eigenschaft auf false nicht verhindert, dass Maus- oder Tastatureingaben das Element erreichen.
subsurfaceHandler : object
Diese Eigenschaft bietet eine Möglichkeit, das Standardverhalten von Subsurface zu überschreiben.
Standardmäßig erstellt Qt ein neues SurfaceItem als Kind dieses Elements und behält die korrekte Position bei.
Um die Standardeinstellung zu überschreiben, weisen Sie dieser Eigenschaft ein Handler-Objekt zu. Der Handler sollte eine handleSubsurfaceAdded(WaylandSurface) Funktion implementieren.
ShellSurfaceItem { subsurfaceHandler: QtObject { function handleSubsurfaceAdded(child) { // create custom surface item, and connect the subsurfacePositionChanged signal } } }
Der Standardwert für diese Eigenschaft ist null.
surface : WaylandSurface
Diese Eigenschaft enthält die Oberfläche, die von dieser WaylandQuickItem gerendert wird.
touchEventsEnabled : bool
Diese Eigenschaft enthält true, wenn Berührungsereignisse an die Client-Oberfläche weitergeleitet werden, andernfalls false.
Signal-Dokumentation
void surfaceDestroyed()
Dieses Signal wird ausgegeben, wenn der Client das mit WaylandQuickItem verknüpfte wl_surface zerstört hat. Vom Handler für dieses Signal wird erwartet, dass er entweder das WaylandQuickItem sofort zerstört oder eine Schließanimation startet und dann das Element zerstört.
Wenn eine Animation gestartet wird, sollte bufferLocked gesetzt werden, um sicherzustellen, dass das Element seinen Inhalt behält, bis die Animation beendet ist.
Hinweis: Der entsprechende Handler ist onSurfaceDestroyed.
Siehe auch bufferLocked.
Dokumentation der Methode
point mapFromSurface(point point)
Ordnet den angegebenen point im Koordinatensystem der Wayland-Oberfläche dem entsprechenden Punkt im Koordinatensystem dieses Elements zu und gibt die zugeordnete Koordinate zurück.
point mapToSurface(point point)
Ordnet den angegebenen point im Koordinatensystem dieses Elements dem entsprechenden Punkt im Koordinatensystem der Wayland-Oberfläche zu und gibt die zugeordnete Koordinate zurück.
void setPrimary()
Macht diese WaylandQuickItem zur primären Ansicht für die Oberfläche.
© 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.