plasma-framework/src/declarativeimports/core/dialog.h

215 lines
6.0 KiB
C
Raw Normal View History

/***************************************************************************
* Copyright 2011 Marco Martin <mart@kde.org> *
* Copyright 2013 Sebastian Kügler <sebas@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, write to the *
* Free Software Foundation, Inc., *
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA . *
***************************************************************************/
#ifndef DIALOG_PROXY_P
#define DIALOG_PROXY_P
#include <QQuickItem>
#include <QQuickWindow>
#include <QWeakPointer>
#include <QPoint>
#include <Plasma/Plasma>
class QQuickItem;
namespace Plasma
{
class Dialog;
}
class DeclarativeItemContainer;
class DialogMargins : public QObject
{
Q_OBJECT
2011-12-23 14:50:34 +01:00
/**
* Width in pixels of the left margin
*/
Q_PROPERTY(int left READ left NOTIFY leftChanged)
2011-12-23 14:50:34 +01:00
/**
* Height in pixels of the top margin
*/
Q_PROPERTY(int top READ top NOTIFY topChanged)
2011-12-23 14:50:34 +01:00
/**
* Width in pixels of the right margin
*/
Q_PROPERTY(int right READ right NOTIFY rightChanged)
2011-12-23 14:50:34 +01:00
/**
* Height in pixels of the bottom margin
*/
Q_PROPERTY(int bottom READ bottom NOTIFY bottomChanged)
public:
DialogMargins(QQuickWindow *dialog, QObject *parent = 0);
int left() const;
int top() const;
int right() const;
int bottom() const;
Q_SIGNALS:
void leftChanged();
void rightChanged();
void topChanged();
void bottomChanged();
protected:
void checkMargins();
private:
int m_left;
int m_top;
int m_right;
int m_bottom;
QQuickWindow *m_dialog;
friend class DialogProxy;
};
/**
* QML wrapper for kdelibs Plasma::Dialog
*
* Exposed as `Dialog` in QML.
*/
class DialogProxy : public QQuickWindow
{
Q_OBJECT
2011-12-23 14:50:34 +01:00
/**
* The main QML item that will be displayed in the Dialog
*/
Q_PROPERTY(QQuickItem *mainItem READ mainItem WRITE setMainItem NOTIFY mainItemChanged)
2011-12-23 14:50:34 +01:00
/**
* Visibility of the Dialog window. Doesn't have anything to do with the visibility of the mainItem.
*/
Q_PROPERTY(bool visible READ isVisible WRITE setVisible NOTIFY visibleChanged)
2011-12-23 14:50:34 +01:00
/**
* Window flags of the Dialog window
*/
2011-03-21 21:38:48 +01:00
Q_PROPERTY(int windowFlags READ windowFlags WRITE setWindowFlags)
2011-12-23 14:50:34 +01:00
/**
* Margins of the dialog around the mainItem.
* @see DialogMargins
*/
Q_PROPERTY(QObject *margins READ margins CONSTANT)
2011-12-23 14:50:34 +01:00
/**
* True if the dialog window is the active one in the window manager.
*/
2011-06-19 23:08:15 +02:00
Q_PROPERTY(bool activeWindow READ isActiveWindow NOTIFY activeWindowChanged)
2011-12-23 14:50:34 +01:00
/**
* Plasma Location of the dialog window. Useful if this dialog is apopup for a panel
*/
Q_PROPERTY(int location READ location WRITE setLocation NOTIFY locationChanged)
2012-04-06 13:08:49 +02:00
//This won't be available on windows, but should be used only by kwin and never by applets anyways
#ifndef Q_WS_WIN
/**
* Window ID of the dialog window.
**/
Q_PROPERTY(qulonglong windowId READ windowId CONSTANT)
2012-04-06 13:08:49 +02:00
#endif
2013-02-20 19:31:06 +01:00
Q_CLASSINFO("DefaultProperty", "mainItem")
public:
2011-02-25 19:00:01 +01:00
enum WidgetAttribute {
WA_X11NetWmWindowTypeDock = Qt::WA_X11NetWmWindowTypeDock
};
DialogProxy(QQuickItem *parent = 0);
~DialogProxy();
QQuickItem *mainItem() const;
void setMainItem(QQuickItem *mainItem);
bool isVisible() const;
void setVisible(const bool visible);
2011-06-19 23:08:15 +02:00
bool isActiveWindow() const;
2011-12-23 14:50:34 +01:00
/**
* Ask the window manager to activate the window.
* The window manager may or may not accept the activiation request
*/
2011-11-16 21:11:58 +01:00
Q_INVOKABLE void activateWindow();
2011-03-21 21:38:48 +01:00
//FIXME: passing an int is ugly
int windowFlags() const;
void setWindowFlags(const int);
int location() const;
void setLocation(int location);
QObject *margins() const;
2012-04-06 13:08:49 +02:00
#ifndef Q_WS_WIN
qulonglong windowId() const;
2012-04-06 13:08:49 +02:00
#endif
/**
* @returns The suggested screen position for the popup
* @arg item the item the popup has to be positioned relatively to. if null, the popup will be positioned in the center of the window
* @arg alignment alignment of the popup compared to the item
*/
2011-06-08 13:02:22 +02:00
//FIXME: alignment should be Qt::AlignmentFlag
Q_INVOKABLE QPoint popupPosition(QQuickItem *item, int alignment=Qt::AlignLeft) ;
2011-12-23 14:50:34 +01:00
/**
* Set a Qt.WidgetAttribute to the dialog window
*
* @arg int attribute see Qt.WidgetAttribute
* @arg bool on activate or deactivate the atrtibute
*/
2011-02-25 19:00:01 +01:00
//FIXME:: Qt::WidgetAttribute should be already
Q_INVOKABLE void setAttribute(int attribute, bool on);
Q_SIGNALS:
void mainItemChanged();
void visibleChanged();
2011-06-19 23:08:15 +02:00
void activeWindowChanged();
void locationChanged();
2013-02-20 19:31:06 +01:00
private Q_SLOTS:
void syncToMainItemSize();
2011-02-25 20:37:56 +01:00
protected:
// bool eventFilter(QObject *watched, QEvent *event);
2013-02-20 15:18:58 +01:00
void resizeEvent(QResizeEvent *re);
2013-02-20 19:39:03 +01:00
void focusInEvent(QFocusEvent *ev);
void focusOutEvent(QFocusEvent *ev);
2011-02-25 20:37:56 +01:00
private:
2011-03-21 21:38:48 +01:00
Qt::WindowFlags m_flags;
2013-02-20 19:31:06 +01:00
QTimer *m_syncTimer;
QWeakPointer<QQuickItem> m_mainItem;
DialogMargins *m_margins;
2011-06-19 23:08:15 +02:00
bool m_activeWindow;
Plasma::Location m_location;
};
#endif