1 | /**************************************************************************** |
2 | ** |
3 | ** Copyright (C) 2017 The Qt Company Ltd. |
4 | ** Contact: https://www.qt.io/licensing/ |
5 | ** |
6 | ** This file is part of the config.tests of the Qt Toolkit. |
7 | ** |
8 | ** $QT_BEGIN_LICENSE:GPL$ |
9 | ** Commercial License Usage |
10 | ** Licensees holding valid commercial Qt licenses may use this file in |
11 | ** accordance with the commercial license agreement provided with the |
12 | ** Software or, alternatively, in accordance with the terms contained in |
13 | ** a written agreement between you and The Qt Company. For licensing terms |
14 | ** and conditions see https://www.qt.io/terms-conditions. For further |
15 | ** information use the contact form at https://www.qt.io/contact-us. |
16 | ** |
17 | ** GNU General Public License Usage |
18 | ** Alternatively, this file may be used under the terms of the GNU |
19 | ** General Public License version 3 or (at your option) any later version |
20 | ** approved by the KDE Free Qt Foundation. The licenses are as published by |
21 | ** the Free Software Foundation and appearing in the file LICENSE.GPL3 |
22 | ** included in the packaging of this file. Please review the following |
23 | ** information to ensure the GNU General Public License requirements will |
24 | ** be met: https://www.gnu.org/licenses/gpl-3.0.html. |
25 | ** |
26 | ** $QT_END_LICENSE$ |
27 | ** |
28 | ****************************************************************************/ |
29 | |
30 | #include <QtWaylandCompositor/QWaylandShellSurface> |
31 | |
32 | /*! |
33 | * \qmltype ShellSurface |
34 | * \instantiates QWaylandShellSurface |
35 | * \inqmlmodule QtWayland.Compositor |
36 | * \since 5.8 |
37 | * \brief Provides a common interface for surface roles specified by shell extensions. |
38 | * |
39 | * This interface represents a Wayland surface role given by a Wayland protocol extension that |
40 | * defines how the WaylandSurface should map onto the screen. |
41 | * |
42 | * Note: Even though this type contains a very limited API, the properties and signals of the |
43 | * implementations are named consistently. For example, if you're only using desktop shell |
44 | * extensions in your compositor, it's safe to access properties such as title, maximized, etc. |
45 | * directly on the ShellSurface. See the various implementations for additional properties and |
46 | * signals. |
47 | * |
48 | * \sa WaylandSurface, ShellSurfaceItem, WlShellSurface, XdgSurfaceV5, IviSurface |
49 | */ |
50 | |
51 | /*! |
52 | * \class QWaylandShellSurface |
53 | * \inmodule QtWaylandCompositor |
54 | * \since 5.8 |
55 | * \brief The QWaylandShellSurface class is a common interface for surface roles specified by shell extensions. |
56 | * |
57 | * This interface represents a Wayland surface role given by a Wayland protocol extension that |
58 | * defines how the QWaylandSurface should map onto the screen. |
59 | * |
60 | * \sa QWaylandSurface, QWaylandWlShellSurface, QWaylandXdgSurfaceV5, QWaylandIviSurface |
61 | */ |
62 | |
63 | #if QT_CONFIG(wayland_compositor_quick) |
64 | /*! |
65 | * \fn QWaylandQuickShellIntegration *QWaylandShellSurface::createIntegration(QWaylandQuickShellSurfaceItem *item) |
66 | * |
67 | * Creates a QWaylandQuickShellIntegration for this QWaylandQuickShellSurface. It's called |
68 | * automatically when \a {item}'s \l {QWaylandQuickShellSurfaceItem::}{shellSurface} is assigned. |
69 | * |
70 | * \sa QWaylandQuickShellSurfaceItem |
71 | */ |
72 | #endif |
73 | |
74 | /*! |
75 | * \qmlproperty enum QtWaylandCompositor::ShellSurface::windowType |
76 | * |
77 | * This property holds the window type of the ShellSurface. |
78 | */ |
79 | |
80 | /*! |
81 | * \property QWaylandShellSurface::windowType |
82 | * |
83 | * This property holds the window type of the QWaylandShellSurface. |
84 | */ |
85 | |