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 Client zurückgegeben.

Der Standardwert ist false.


compositor : WaylandCompositor [read-only]

Diese Eigenschaft enthält den Compositor für die von diesem WaylandQuickItem gerenderte Oberfläche.


focusOnClick : bool

Diese Eigenschaft gibt an, ob der WaylandQuickItem den Fokus erhalten soll, wenn er angeklickt oder berührt wird.

Die Vorgabe ist true.


origin : enum [read-only]

Diese Eigenschaft enthält den Ursprung des 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 des Untergrunds außer Kraft zu setzen.

Standardmäßig erstellt Qt ein neues SurfaceItem als Kind dieses Elements und behält die korrekte Position bei.

Um die Vorgabe 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)

Überträgt den angegebenen point im Koordinatensystem der Wayland-Oberfläche auf den entsprechenden Punkt im Koordinatensystem dieses Elements und gibt die übertragene Koordinate zurück.


point mapToSurface(point point)

Überträgt den angegebenen point im Koordinatensystem dieses Elements auf den entsprechenden Punkt im Koordinatensystem der Wayland-Oberfläche und gibt die zugeordnete Koordinate zurück.


setPrimary()

Macht diese WaylandQuickItem zur primären Ansicht für die Oberfläche.


© 2025 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.