WaylandSurface QML Type (Uncreatable)

Stellt einen rechteckigen Bereich auf einem Ausgabegerät dar. Mehr...

Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

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()

Ausführliche Beschreibung

Dieser Typ kapselt einen rechteckigen Pixelbereich, der auf einem Ausgabegerät angezeigt wird. Er entspricht der Schnittstelle „ wl_surface “ im Wayland-Protokoll.

Dokumentation der Eigenschaften

bufferScale : size [read-only]

Diese Eigenschaft enthält den Puffermaßstab des „ WaylandSurface “. Der Puffermaßstab ermöglicht es einem Client, Pufferdaten mit höherer Auflösung bereitzustellen, die für hochauflösende Ausgaben verwendet werden können.

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 enthält den Client, der diese WaylandSurface nutzt.

contentOrientation : enum [read-only]

Diese Eigenschaft gibt die Ausrichtung des Inhalts von „ WaylandSurface “ an.

Siehe auch „ WaylandOutput.transform “.

cursorSurface : bool

Diese Eigenschaft gilt unabhängig davon, ob die „ WaylandSurface “ eine Cursor-Oberfläche ist.

destinationSize : size [read-only]

Diese Eigenschaft enthält die Größe dieses WaylandSurface in Oberflächenkoordinaten.

Siehe auch „ bufferScale “ und „ bufferSize “.

hasContent : bool [read-only]

Diese Eigenschaft gibt an, ob die Oberfläche derzeit über einen fest zugewiesenen, nicht-null-Puffer verfügt.

Siehe auch „ WaylandSurface::bufferSize “.

inhibitsIdle : bool [read-only]

Diese Eigenschaft legt fest, ob diese Oberfläche das Leerlaufverhalten des Compositors – wie z. B. Bildschirmabschaltung, Bildschirmsperre und Bildschirmschoner – unterbinden soll.

Siehe auch IdleInhibitManagerV1.

isOpaque : bool [read-only, since 6.4]

Diese Eigenschaft gilt unabhängig davon, ob die Fläche vollständig undurchsichtig ist, wie vom Client über die Anforderung „set_opaque_region“ gemeldet.

Diese Eigenschaft wurde in Qt 6.4 eingeführt.

origin : enum [read-only]

Diese Eigenschaft enthält den Ursprung des Puffers der „ WaylandSurface “ oder „ WaylandSurface.OriginTopLeft“, falls die Oberfläche keinen Puffer besitzt.

Sie kann die folgenden Werte annehmen:

• WaylandSurface.OriginTopLeft Der Ursprung ist die obere linke Ecke des Puffers.
• WaylandSurface.OriginBottomLeft Der Ursprung ist die untere linke 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 beziehen sich auf die Ecke des Puffers und werden mit bufferScale skaliert.

Siehe auch „ bufferScale “, „ bufferSize “ und „ destinationSize “.

useTextureAlpha : bool [default: true]

Diese Eigenschaft legt fest, ob die Oberfläche für das Blending den Textur-Alpha-Kanal verwenden soll.

Wenn „ true “ gesetzt ist, wird der Alphakanal der Oberfläche für das Überblenden verwendet; wenn „ false “ gesetzt ist, wird die Oberfläche als undurchsichtig behandelt.

Signal-Dokumentation

childAdded(WaylandSurface child)

Dieses Signal wird ausgelöst, wenn ein „wl_subsurface“ ( child) zur Oberfläche hinzugefügt wurde.

void dragStarted(WaylandDrag drag)

Dieses Signal wird ausgesendet, wenn ein „ drag “ von dieser Oberfläche gestartet wurde.

surfaceDestroyed()

Dieses Signal wird ausgelöst, wenn die entsprechende wl_surface zerstört wird.

Methodendokumentation

void destroy()

Zerstört die „ WaylandSurface “.

void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)

Initialisiert die „ WaylandSurface “ mit den angegebenen Werten „ compositor “ und „ client “ sowie mit den angegebenen Werten „ id “ und „ version “.

bool isDestroyed()

Gibt „ true “ zurück, wenn das „ WaylandSurface “ zerstört wurde. Andernfalls wird „ false “ zurückgegeben.