WaylandQuickItem QML Type

Der Typ „WaylandQuickItem“ stellt ein „ Qt Quick “-Element bereit, das die Oberfläche eines Wayland-Clients repräsentiert. Mehr…

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

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 QuickWayland-Compositoren, die auf diesem Typ basieren, können diesen Typ verwenden, um die Inhalte eines Clients auf einem Ausgabegerät anzuzeigen. Er leitet Benutzereingaben an den Client weiter.

Dokumentation der Eigenschaften

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 legt fest, ob das „ WaylandQuickItem “ den Fokus erhalten soll, wenn es 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 “ ist, verarbeitet und behandelt das Element Eingabeereignisse wie Tastatur- und Mausereignisse; wenn „ false “ ist, werden Eingabeereignisse ignoriert.

origin : enum [read-only]

Diese Eigenschaft gibt den Ursprung des aktuellen Puffers der Oberfläche an, d. h., welche Ecke des Puffers der Koordinate (0, 0) entspricht.

Siehe auch „ WaylandSurface::origin “.

output : WaylandOutput

Diese Eigenschaft enthält die Ausgabe, auf der dieses Element angezeigt wird.

paintEnabled : bool [default: true]

Wenn Sie diese Eigenschaft auf „ false “ setzen, wird die Darstellung des Elements unterbunden. Im Gegensatz zum Ausblenden des Elements durch Setzen von „ visible “ auf „ false “ wird dadurch nicht verhindert, dass Maus- oder Tastatureingaben das Element erreichen.

subsurfaceHandler : object

Diese Eigenschaft bietet die Möglichkeit, das Standardverhalten der Unterfläche zu überschreiben.

Standardmäßig erstellt Qt ein neues `SurfaceItem` als untergeordnetes Element dieses Elements und sorgt für die korrekte Positionierung.

Um die Standardeinstellung zu überschreiben, weisen Sie dieser Eigenschaft ein Handler-Objekt zu. Der Handler sollte die Funktion `handleSubsurfaceAdded(WaylandSurface)` implementieren.

ShellSurfaceItem {
    subsurfaceHandler: QtObject {
        function handleSubsurfaceAdded(child) {
          // create custom surface item, and connect the subsurfacePositionChanged signal
        }
    }
}

Der Standardwert dieser Eigenschaft lautet ` null`.

surface : WaylandSurface

Diese Eigenschaft enthält die von diesem „ WaylandQuickItem “ gerenderte Oberfläche.

touchEventsEnabled : bool

Diese Eigenschaft nimmt den Wert „ true “ an, wenn Berührungsereignisse an die Client-Oberfläche weitergeleitet werden, andernfalls „ false “.

Signal-Dokumentation

void surfaceDestroyed()

Dieses Signal wird ausgelöst, wenn der Client das mit dem ` WaylandQuickItem` verknüpfte ` wl_surface ` gelöscht hat. Der Handler für dieses Signal sollte entweder das ` WaylandQuickItem ` sofort löschen oder eine Schließanimation starten und anschließend das `Item` löschen.

Wird eine Animation gestartet, sollte ` bufferLocked ` so gesetzt werden, dass das Item seinen Inhalt beibehält, bis die Animation beendet ist

Siehe auch „ bufferLocked “.

Methodendokumentation

point mapFromSurface(point point)

Ordnet die angegebene „ 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 die im Koordinatensystem dieses Elements angegebene „ point “ dem entsprechenden Punkt im Koordinatensystem der Wayland-Oberfläche zu und gibt die zugeordnete Koordinate zurück.

void setPrimary()

Legt „ WaylandQuickItem “ als primäre Ansicht für die Oberfläche fest.