QWaylandWlShellSurface Class
The QWaylandWlShellSurface class provides desktop-style compositor-specific features to a surface. More...
| Header: | #include <QWaylandWlShellSurface> |
| qmake: | QT += waylandcompositor |
| Since: | Qt 5.8 |
| Inherits: | QWaylandShellSurfaceTemplate |
Public Types
| enum | FullScreenMethod { DefaultFullScreen, ScaleFullScreen, DriverFullScreen, FillFullScreen } |
| enum | ResizeEdge { NoneEdge, TopEdge, BottomEdge, LeftEdge, ..., BottomRightEdge } |
Properties
- className : const QString
- shell : QWaylandWlShell * const
- surface : QWaylandSurface * const
- title : const QString
- 1 property inherited from QWaylandShellSurface
Public Functions
| QWaylandWlShellSurface() | |
| QWaylandWlShellSurface(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &res) | |
| virtual | ~QWaylandWlShellSurface() |
| QString | className() const |
| void | initialize(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &resource) |
| void | sendConfigure(const QSize &size, ResizeEdge edges) |
| void | sendPopupDone() |
| QWaylandWlShell * | shell() const |
| QSize | sizeForResize(const QSizeF &size, const QPointF &delta, ResizeEdge edges) |
| QWaylandSurface * | surface() const |
| QString | title() const |
- 1 public function inherited from QWaylandShellSurface
- 4 public functions inherited from QWaylandCompositorExtension
- 5 public functions inherited from QWaylandObject
Public Slots
| void | ping() |
Signals
| void | classNameChanged() |
| void | pong() |
| void | setDefaultToplevel() |
| void | setFullScreen(FullScreenMethod method, uint framerate, QWaylandOutput *output) |
| void | setMaximized(QWaylandOutput *output) |
| void | setPopup(QWaylandSeat *seat, QWaylandSurface *parentSurface, const QPoint &relativeToParent) |
| void | setTransient(QWaylandSurface *parentSurface, const QPoint &relativeToParent, bool inactive) |
| void | shellChanged() |
| void | startMove(QWaylandSeat *seat) |
| void | startResize(QWaylandSeat *seat, ResizeEdge edges) |
| void | surfaceChanged() |
| void | titleChanged() |
- 1 signal inherited from QWaylandShellSurface
Static Public Members
| QWaylandWlShellSurface * | fromResource(wl_resource *resource) |
| QWaylandSurfaceRole * | role() |
Additional Inherited Members
- 1 protected function inherited from QWaylandCompositorExtension
Detailed Description
The QWaylandWlShellSurface class provides desktop-style compositor-specific features to a surface.
This class is part of the QWaylandWlShell extension and provides a way to extend the functionality of an existing QWaylandSurface with features specific to desktop-style compositors, such as resizing and moving the surface.
It corresponds to the Wayland interface wl_shell_surface.
Member Type Documentation
enum QWaylandWlShellSurface::FullScreenMethod
enum QWaylandWlShellSurface::ResizeEdge
This enum type provides a way to specify an edge or corner of the surface.
| Constant | Value | Description |
|---|---|---|
QWaylandWlShellSurface::NoneEdge | 0 | No edge. |
QWaylandWlShellSurface::TopEdge | 1 | The top edge. |
QWaylandWlShellSurface::BottomEdge | 2 | The bottom edge. |
QWaylandWlShellSurface::LeftEdge | 4 | The left edge. |
QWaylandWlShellSurface::TopLeftEdge | 5 | The top left corner. |
QWaylandWlShellSurface::BottomLeftEdge | 6 | The bottom left corner. |
QWaylandWlShellSurface::RightEdge | 8 | The right edge. |
QWaylandWlShellSurface::TopRightEdge | 9 | The top right corner. |
QWaylandWlShellSurface::BottomRightEdge | 10 | The bottom right corner. |
Property Documentation
className : const QString
This property holds the class name of the QWaylandWlShellSurface.
Access functions:
| QString | className() const |
Notifier signal:
| void | classNameChanged() |
shell : QWaylandWlShell * const
This property holds the shell associated with this QWaylandWlShellSurface.
Access functions:
| QWaylandWlShell * | shell() const |
Notifier signal:
| void | shellChanged() |
surface : QWaylandSurface * const
This property holds the surface associated with this QWaylandWlShellSurface.
Access functions:
| QWaylandSurface * | surface() const |
Notifier signal:
| void | surfaceChanged() |
title : const QString
This property holds the title of the QWaylandWlShellSurface.
Access functions:
| QString | title() const |
Notifier signal:
| void | titleChanged() |
Member Function Documentation
QWaylandWlShellSurface::QWaylandWlShellSurface()
Constructs a QWaylandWlShellSurface.
QWaylandWlShellSurface::QWaylandWlShellSurface(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &res)
Constructs a QWaylandWlShellSurface for surface and initializes it with the given shell and resource res.
[virtual] QWaylandWlShellSurface::~QWaylandWlShellSurface()
Destroys the instance of QWaylandWlShellSurface. The destructor is virtual.
[static] QWaylandWlShellSurface *QWaylandWlShellSurface::fromResource(wl_resource *resource)
Returns the QWaylandWlShellSurface object associated with the given resource, or null if no such object exists.
void QWaylandWlShellSurface::initialize(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &resource)
Initializes the QWaylandWlShellSurface and associates it with the given shell, surface, and resource.
[slot] void QWaylandWlShellSurface::ping()
Sends a ping event to the client. If the client replies to the event the pong signal will be emitted.
[signal] void QWaylandWlShellSurface::pong()
[static] QWaylandSurfaceRole *QWaylandWlShellSurface::role()
void QWaylandWlShellSurface::sendConfigure(const QSize &size, ResizeEdge edges)
Sends a configure event to the client, suggesting that it resize its surface to the provided size. The edges provide a hint about how the surface was resized.
void QWaylandWlShellSurface::sendPopupDone()
Sends a popup_done event to the client to indicate that the user has clicked somewhere outside the client's surfaces.