WaylandSurface QML Type

Represents a rectangular area on an output device. 更多...

import 语句：	import QtWayland.Compositor 1.5
实例化：	QWaylandSurface

所有成员列表，包括继承成员

特性

bufferScale : size
bufferSize : size
client : WaylandClient
contentOrientation : enum
cursorSurface : bool
destinationSize : size
hasContent : bool
inhibitsIdle : bool
isOpaque : bool
origin : enum
sourceGeometry : rect
useTextureAlpha : bool

信号

childAdded (WaylandSurface child )
void dragStarted (WaylandDrag drag )
surfaceDestroyed ()

方法

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

详细描述

This type encapsulates a rectangular area of pixels that is displayed on an output device. It corresponds to the interface wl_surface in the Wayland protocol.

特性文档编制

[read-only] bufferScale : size

此特性保持 WaylandSurface 's buffer scale. The buffer scale lets a client supply higher resolution buffer data for use on high resolution outputs.

[read-only] bufferSize : size

This property holds the size of the current buffer of this WaylandSurface in pixels, not in surface coordinates.

For the size in surface coordinates, use destinationSize 代替。

另请参阅 destinationSize and bufferScale .

[read-only] client : WaylandClient

This property holds the client using this WaylandSurface .

[read-only] contentOrientation : enum

This property holds the orientation of the WaylandSurface 's contents.

另请参阅 WaylandOutput.transform .

cursorSurface : bool

This property holds whether the WaylandSurface is a cursor surface.

[read-only] destinationSize : size

This property holds the size of this WaylandSurface in surface coordinates.

另请参阅 bufferScale and bufferSize .

[read-only] hasContent : bool

This property holds whether the WaylandSurface has content.

[read-only] inhibitsIdle : bool

This property holds whether this surface is intended to inhibit the idle behavior of the compositor such as screen blanking, locking and screen saving.

另请参阅 IdleInhibitManagerV1 .

[read-only, since 6.4] isOpaque : bool

This property holds whether the surface is fully opaque, as reported by the client through the set_opaque_region request.

该特性在 Qt 6.4 引入。

[read-only] origin : enum

This property holds the origin of the WaylandSurface 's buffer, or WaylandSurface .OriginTopLeft if the surface has no buffer.

It can have the following values:

WaylandSurface .OriginTopLeft The origin is the top left corner of the buffer.
WaylandSurface .OriginBottomLeft The origin is the bottom left corner of the buffer.

[read-only] sourceGeometry : rect

This property describes the portion of the attached Wayland buffer that should be drawn on the screen. The coordinates are from the corner of the buffer and are scaled by bufferScale .

另请参阅 bufferScale , bufferSize ，和 destinationSize .

useTextureAlpha : bool

This property specifies whether the surface should use texture alpha.

信号文档编制

childAdded ( WaylandSurface child )

This signal is emitted when a wl_subsurface, child , has been added to the surface.

注意： 相应处理程序是 onChildAdded .

void dragStarted ( WaylandDrag drag )

This signal is emitted when a drag has started from this surface.

注意： 相应处理程序是 onDragStarted .

surfaceDestroyed ()

This signal is emitted when the corresponding wl_surface is destroyed.

注意： 相应处理程序是 onSurfaceDestroyed .

方法文档编制

void destroy ()

销毁 WaylandSurface .

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

初始化 WaylandSurface 采用给定 compositor and client ，和采用给定 id and version .

bool isDestroyed ()

返回 true 若 WaylandSurface has been destroyed. Otherwise returns false .