ForeignToplevel.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 fuddlesworth
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#pragma once
 
#include <phosphorwayland_export.h>
 
#include <QList>
#include <QObject>
#include <QPointer>
 
#include <memory>
 
QT_BEGIN_NAMESPACE
class QScreen;
class QWindow;
QT_END_NAMESPACE
 
namespace PhosphorWayland {
 
class ForeignToplevel;
 
class PHOSPHORWAYLAND_EXPORT ForeignToplevelManager : public QObject
{
    Q_OBJECT
    Q_DISABLE_COPY_MOVE(ForeignToplevelManager)
 
public:
    explicit ForeignToplevelManager(QObject* parent = nullptr);
    ~ForeignToplevelManager() override;
 
    static bool isSupported();
 
    [[nodiscard]] QList<ForeignToplevel*> toplevels() const;
 
    void stop();
 
Q_SIGNALS:
    void toplevelAdded(PhosphorWayland::ForeignToplevel* toplevel);
    void toplevelRemoved(PhosphorWayland::ForeignToplevel* toplevel);
 
private:
    friend class ForeignToplevel;
    class Private;
    std::unique_ptr<Private> d;
};
 
class PHOSPHORWAYLAND_EXPORT ForeignToplevel : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QString title READ title NOTIFY titleChanged)
    Q_PROPERTY(QString appId READ appId NOTIFY appIdChanged)
    Q_PROPERTY(bool maximized READ isMaximized NOTIFY stateChanged)
    Q_PROPERTY(bool minimized READ isMinimized NOTIFY stateChanged)
    Q_PROPERTY(bool activated READ isActivated NOTIFY stateChanged)
    Q_PROPERTY(bool fullscreen READ isFullscreen NOTIFY stateChanged)
    Q_PROPERTY(QList<QScreen*> outputs READ outputs NOTIFY outputsChanged)
    Q_PROPERTY(PhosphorWayland::ForeignToplevel* parentToplevel READ parentToplevel NOTIFY parentToplevelChanged)
    Q_PROPERTY(bool closed READ isClosed NOTIFY closedChanged)
 
public:
    ~ForeignToplevel() override;
 
    [[nodiscard]] QString title() const;
    [[nodiscard]] QString appId() const;
    [[nodiscard]] bool isMaximized() const;
    [[nodiscard]] bool isMinimized() const;
    [[nodiscard]] bool isActivated() const;
    [[nodiscard]] bool isFullscreen() const;
    [[nodiscard]] QList<QScreen*> outputs() const;
    [[nodiscard]] ForeignToplevel* parentToplevel() const;
    [[nodiscard]] bool isClosed() const;
 
    Q_INVOKABLE void activate();
 
    Q_INVOKABLE void close();
 
    Q_INVOKABLE void setMaximized(bool maximized);
    Q_INVOKABLE void setMinimized(bool minimized);
    Q_INVOKABLE void setFullscreen(bool fullscreen, QScreen* output = nullptr);
 
    Q_INVOKABLE void setRectangle(QWindow* surface, const QRect& rect);
 
Q_SIGNALS:
    void titleChanged();
    void appIdChanged();
    void stateChanged();
    void outputsChanged();
    void parentToplevelChanged();
    void closedChanged();
 
private:
    friend class ForeignToplevelManager;
    class Private;
    explicit ForeignToplevel(std::unique_ptr<Private> p);
    std::unique_ptr<Private> d;
};
 
} // namespace PhosphorWayland
 
Q_DECLARE_METATYPE(PhosphorWayland::ForeignToplevel*)