You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
lxqt-notificationd-packaging/src/notificationlayout.h

105 lines
3.5 KiB

/* BEGIN_COMMON_COPYRIGHT_HEADER
* (c)LGPL2+
*
* LXDE-Qt - a lightweight, Qt based, desktop toolset
* http://razor-qt.org
*
* Copyright: 2012 Razor team
* Authors:
* Petr Vanek <petr@scribus.info>
*
* This program or library is free software; you can redistribute it
* and/or modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
* You should have received a copy of the GNU Lesser General
* Public License along with this library; if not, write to the
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301 USA
*
* END_COMMON_COPYRIGHT_HEADER */
#ifndef NotificationLayout_H
#define NotificationLayout_H
#include "notification.h"
class NotificationLayout : public QWidget
{
Q_OBJECT
public:
explicit NotificationLayout(QWidget *parent);
/*! Set various properties for self and child \c Notification instances.
* \param space a layout spacing
* \param width new width for notifications
*/
void setSizes(int space, int width);
signals:
//! All \c Notification instances are closed
void allNotificationsClosed();
//! At least one \c Notification instance is available and needs to be shown
void notificationAvailable();
//! Height of this widget changed so parent's \c NotificationArea needs to change its size too.
void heightChanged(int);
/*! Promote the internal change of notification closing into the \c Notifyd
* \param id an notification ID (obtained from \c Notify)
* \param reason a reason for closing code. See specification for more info.
*/
void notificationClosed(uint id, uint reason);
/*! Inform the external application that user chose one of provided action via the \c Notifyd
* \param in0 a notification ID (obtained from \c Notify)
* \param in1 a selected action key from the (key - display value) pair
*/
void actionInvoked(uint id, const QString &actionKey);
public slots:
/*! Add new notification
* See \c Notifyd::Notify() for params meanings.
*/
void addNotification(uint id, const QString &application,
const QString &summary, const QString &body,
const QString &icon, int timeout,
const QStringList& actions, const QVariantMap& hints);
/*! Notification id should be removed because of reason
*/
void removeNotification(uint id, uint reason);
private:
QHash<uint, Notification*> m_notifications;
QVBoxLayout *m_layout;
/*! Calculate required height based on height of each \c Notification
* in the m_notifications map.
* Also heightChanged() is emitted here.
*/
void checkHeight();
private slots:
/*! \c Notification's timer timeouted, so closing the notifiaction
*/
void removeNotificationTimeout();
/*! \c User cancelled the notifiation manually
*/
void removeNotificationUser();
/*! User clicked on one of actions (if provioded).
* \param actionKey an action's key (not the display value)
*/
void notificationActionCalled(const QString &actionKey);
};
#endif // NotificationLayout_H