Auf dieser Seite

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:

ShellSurfaceItem

Eigenschaften

Signale

Methoden

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.