kwin/scripting/screenedgeitem.h
Martin Gräßlin 5007a19062 Add a ScreenEdgeItem to reserve a screen edge from QML
Usage:
ScreenEdgeItem {
    edge: ScreenEdgeItem.LeftEdge
    onActivated: doSomething()
}
2013-08-13 09:57:51 +02:00

108 lines
2.7 KiB
C++

/********************************************************************
KWin - the KDE window manager
This file is part of the KDE project.
Copyright (C) 2013 Martin Gräßlin <mgraesslin@kde.org>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*********************************************************************/
#ifndef KWIN_SCREENEDGEITEM_H
#define KWIN_SCREENEDGEITEM_H
#include <QObject>
#include <kwinglobals.h>
namespace KWin
{
/**
* @brief Qml export for reserving a Screen Edge.
*
* The edge is controlled by the @c enabled property and the @c edge
* property. If the edge is enabled and gets triggered the @link activated()
* signal gets emitted.
*
* Example usage:
* @code
* ScreenEdgeItem {
* edge: ScreenEdgeItem.LeftEdge
* onActivated: doSomething()
* }
* @endcode
*
*/
class ScreenEdgeItem : public QObject
{
Q_OBJECT
Q_ENUMS(Edge)
/**
* @brief Whether the edge is currently enabled, that is reserved. Default value is @c true.
*
*/
Q_PROPERTY(bool enabled READ isEnabled WRITE setEnabled NOTIFY enabledChanged)
/**
* @brief Which of the screen edges is to be reserved. Default value is @c NoEdge.
*
*/
Q_PROPERTY(Edge edge READ edge WRITE setEdge NOTIFY edgeChanged)
public:
enum Edge {
TopEdge,
TopRightEdge,
RightEdge,
BottomRightEdge,
BottomEdge,
BottomLeftEdge,
LeftEdge,
TopLeftEdge,
EDGE_COUNT,
NoEdge
};
explicit ScreenEdgeItem(QObject *parent = 0);
virtual ~ScreenEdgeItem();
bool isEnabled() const;
Edge edge() const;
public Q_SLOTS:
void setEnabled(bool enabled);
void setEdge(Edge edge);
Q_SIGNALS:
void enabledChanged();
void edgeChanged();
void activated();
private Q_SLOTS:
bool borderActivated(ElectricBorder edge);
private:
void enableEdge();
void disableEdge();
bool m_enabled;
Edge m_edge;
};
inline bool ScreenEdgeItem::isEnabled() const
{
return m_enabled;
}
inline ScreenEdgeItem::Edge ScreenEdgeItem::edge() const
{
return m_edge;
}
} // namespace KWin
#endif // KWIN_SCREENEDGEITEM_H