2015-12-24 07:06:41 -07:00
|
|
|
// Copyright (c) 2015 GitHub, Inc.
|
|
|
|
// Use of this source code is governed by the MIT license that can be
|
|
|
|
// found in the LICENSE file.
|
|
|
|
|
2021-11-22 00:34:31 -07:00
|
|
|
#ifndef ELECTRON_SHELL_BROWSER_NOTIFICATIONS_NOTIFICATION_H_
|
|
|
|
#define ELECTRON_SHELL_BROWSER_NOTIFICATIONS_NOTIFICATION_H_
|
2015-12-24 07:06:41 -07:00
|
|
|
|
2017-05-18 16:06:57 -06:00
|
|
|
#include <string>
|
2017-06-23 04:39:42 -06:00
|
|
|
#include <vector>
|
2017-05-18 16:06:57 -06:00
|
|
|
|
2023-05-11 14:07:39 -06:00
|
|
|
#include "base/memory/raw_ptr.h"
|
2015-12-24 07:06:41 -07:00
|
|
|
#include "base/memory/weak_ptr.h"
|
2017-06-24 05:03:27 -06:00
|
|
|
#include "third_party/skia/include/core/SkBitmap.h"
|
|
|
|
#include "url/gurl.h"
|
2015-12-24 07:06:41 -07:00
|
|
|
|
2019-06-19 15:23:04 -06:00
|
|
|
namespace electron {
|
2015-12-24 07:06:41 -07:00
|
|
|
|
2015-12-24 19:16:07 -07:00
|
|
|
class NotificationDelegate;
|
|
|
|
class NotificationPresenter;
|
|
|
|
|
2017-06-23 04:39:42 -06:00
|
|
|
struct NotificationAction {
|
2021-03-16 10:18:45 -06:00
|
|
|
std::u16string type;
|
|
|
|
std::u16string text;
|
2017-06-23 04:39:42 -06:00
|
|
|
};
|
|
|
|
|
2017-06-24 05:03:27 -06:00
|
|
|
struct NotificationOptions {
|
2021-03-16 10:18:45 -06:00
|
|
|
std::u16string title;
|
|
|
|
std::u16string subtitle;
|
|
|
|
std::u16string msg;
|
2017-06-24 05:03:27 -06:00
|
|
|
std::string tag;
|
2018-01-22 11:48:12 -07:00
|
|
|
bool silent;
|
2017-06-24 05:03:27 -06:00
|
|
|
GURL icon_url;
|
|
|
|
SkBitmap icon;
|
|
|
|
bool has_reply;
|
2021-03-16 10:18:45 -06:00
|
|
|
std::u16string timeout_type;
|
|
|
|
std::u16string reply_placeholder;
|
|
|
|
std::u16string sound;
|
|
|
|
std::u16string urgency; // Linux
|
2017-06-24 05:03:27 -06:00
|
|
|
std::vector<NotificationAction> actions;
|
2021-03-16 10:18:45 -06:00
|
|
|
std::u16string close_button_text;
|
|
|
|
std::u16string toast_xml;
|
2018-04-17 17:37:22 -06:00
|
|
|
|
|
|
|
NotificationOptions();
|
|
|
|
~NotificationOptions();
|
2017-06-24 05:03:27 -06:00
|
|
|
};
|
|
|
|
|
2015-12-24 07:06:41 -07:00
|
|
|
class Notification {
|
|
|
|
public:
|
2017-05-31 01:17:29 -06:00
|
|
|
virtual ~Notification();
|
|
|
|
|
2015-12-24 19:16:07 -07:00
|
|
|
// Shows the notification.
|
2017-06-24 05:03:27 -06:00
|
|
|
virtual void Show(const NotificationOptions& options) = 0;
|
2023-10-17 17:33:00 -06:00
|
|
|
|
|
|
|
// Dismisses the notification. On some platforms this will result in full
|
|
|
|
// removal and destruction of the notification, but if the initial dismissal
|
|
|
|
// does not fully get rid of the notification it will be destroyed in Remove.
|
2015-12-24 19:16:07 -07:00
|
|
|
virtual void Dismiss() = 0;
|
2015-12-24 07:06:41 -07:00
|
|
|
|
2023-10-17 17:33:00 -06:00
|
|
|
// Removes the notification if it was not fully removed during dismissal,
|
|
|
|
// as can happen on some platforms including Windows.
|
|
|
|
virtual void Remove();
|
|
|
|
|
2016-04-15 01:14:13 -06:00
|
|
|
// Should be called by derived classes.
|
2020-09-01 19:02:47 -06:00
|
|
|
void NotificationClicked();
|
2023-10-17 17:33:00 -06:00
|
|
|
void NotificationDismissed(bool should_destroy = true);
|
2020-09-29 13:20:10 -06:00
|
|
|
void NotificationFailed(const std::string& error = "");
|
2016-04-15 01:14:13 -06:00
|
|
|
|
2016-10-25 07:32:06 -06:00
|
|
|
// delete this.
|
|
|
|
void Destroy();
|
|
|
|
|
2015-12-24 07:06:41 -07:00
|
|
|
base::WeakPtr<Notification> GetWeakPtr() {
|
|
|
|
return weak_factory_.GetWeakPtr();
|
|
|
|
}
|
|
|
|
|
2017-05-31 01:17:29 -06:00
|
|
|
void set_delegate(NotificationDelegate* delegate) { delegate_ = delegate; }
|
2018-04-08 13:24:08 -06:00
|
|
|
void set_notification_id(const std::string& id) { notification_id_ = id; }
|
2023-10-17 17:33:00 -06:00
|
|
|
void set_is_dismissed(bool dismissed) { is_dismissed_ = dismissed; }
|
2018-04-08 13:24:08 -06:00
|
|
|
|
2015-12-24 19:16:07 -07:00
|
|
|
NotificationDelegate* delegate() const { return delegate_; }
|
|
|
|
NotificationPresenter* presenter() const { return presenter_; }
|
2018-04-08 13:24:08 -06:00
|
|
|
const std::string& notification_id() const { return notification_id_; }
|
2023-10-17 17:33:00 -06:00
|
|
|
bool is_dismissed() const { return is_dismissed_; }
|
2015-12-24 19:16:07 -07:00
|
|
|
|
2021-11-03 05:41:45 -06:00
|
|
|
// disable copy
|
|
|
|
Notification(const Notification&) = delete;
|
|
|
|
Notification& operator=(const Notification&) = delete;
|
|
|
|
|
2015-12-24 07:06:41 -07:00
|
|
|
protected:
|
2015-12-24 19:16:07 -07:00
|
|
|
Notification(NotificationDelegate* delegate,
|
|
|
|
NotificationPresenter* presenter);
|
2017-04-05 05:27:46 -06:00
|
|
|
|
2015-12-24 07:06:41 -07:00
|
|
|
private:
|
2023-05-11 14:07:39 -06:00
|
|
|
raw_ptr<NotificationDelegate> delegate_;
|
|
|
|
raw_ptr<NotificationPresenter> presenter_;
|
2018-04-08 13:24:08 -06:00
|
|
|
std::string notification_id_;
|
2023-10-17 17:33:00 -06:00
|
|
|
bool is_dismissed_ = false;
|
2015-12-24 19:16:07 -07:00
|
|
|
|
2021-01-26 11:16:21 -07:00
|
|
|
base::WeakPtrFactory<Notification> weak_factory_{this};
|
2015-12-24 07:06:41 -07:00
|
|
|
};
|
|
|
|
|
2019-06-19 15:23:04 -06:00
|
|
|
} // namespace electron
|
2015-12-24 07:06:41 -07:00
|
|
|
|
2021-11-22 00:34:31 -07:00
|
|
|
#endif // ELECTRON_SHELL_BROWSER_NOTIFICATIONS_NOTIFICATION_H_
|