2015-08-01 21:11:29 -06: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_UI_WIN_TASKBAR_HOST_H_
|
|
|
|
#define ELECTRON_SHELL_BROWSER_UI_WIN_TASKBAR_HOST_H_
|
2015-08-01 21:11:29 -06:00
|
|
|
|
2015-08-05 22:58:40 -06:00
|
|
|
#include <shobjidl.h>
|
2018-04-18 11:20:15 -06:00
|
|
|
#include <wrl/client.h>
|
2015-08-01 21:11:29 -06:00
|
|
|
|
|
|
|
#include <map>
|
2015-08-05 22:44:07 -06:00
|
|
|
#include <string>
|
2015-08-01 21:11:29 -06:00
|
|
|
#include <vector>
|
|
|
|
|
2023-02-03 04:43:42 -07:00
|
|
|
#include "base/functional/callback.h"
|
2019-06-19 14:46:59 -06:00
|
|
|
#include "shell/browser/native_window.h"
|
2016-07-14 14:27:16 -06:00
|
|
|
#include "ui/gfx/geometry/rect.h"
|
2015-08-05 21:10:34 -06:00
|
|
|
#include "ui/gfx/image/image.h"
|
2015-08-01 21:11:29 -06:00
|
|
|
|
2019-06-19 15:23:04 -06:00
|
|
|
namespace electron {
|
2015-08-01 21:11:29 -06:00
|
|
|
|
2015-08-05 20:30:22 -06:00
|
|
|
class TaskbarHost {
|
2015-08-01 21:11:29 -06:00
|
|
|
public:
|
2015-08-05 21:10:34 -06:00
|
|
|
struct ThumbarButton {
|
|
|
|
std::string tooltip;
|
|
|
|
gfx::Image icon;
|
|
|
|
std::vector<std::string> flags;
|
2021-05-06 16:01:04 -06:00
|
|
|
base::RepeatingClosure clicked_callback;
|
2018-06-25 14:30:00 -06:00
|
|
|
|
|
|
|
ThumbarButton();
|
|
|
|
ThumbarButton(const ThumbarButton&);
|
|
|
|
~ThumbarButton();
|
2015-08-05 21:10:34 -06:00
|
|
|
};
|
|
|
|
|
|
|
|
TaskbarHost();
|
|
|
|
virtual ~TaskbarHost();
|
2015-08-01 21:11:29 -06:00
|
|
|
|
2021-11-03 05:41:45 -06:00
|
|
|
// disable copy
|
|
|
|
TaskbarHost(const TaskbarHost&) = delete;
|
|
|
|
TaskbarHost& operator=(const TaskbarHost&) = delete;
|
|
|
|
|
2015-08-05 22:54:00 -06:00
|
|
|
// Add or update the buttons in thumbar.
|
2018-04-17 19:44:10 -06:00
|
|
|
bool SetThumbarButtons(HWND window,
|
|
|
|
const std::vector<ThumbarButton>& buttons);
|
2015-08-05 22:44:07 -06:00
|
|
|
|
2016-08-12 09:55:42 -06:00
|
|
|
void RestoreThumbarButtons(HWND window);
|
|
|
|
|
2015-08-05 23:07:00 -06:00
|
|
|
// Set the progress state in taskbar.
|
2018-04-17 19:44:10 -06:00
|
|
|
bool SetProgressBar(HWND window,
|
|
|
|
double value,
|
|
|
|
const NativeWindow::ProgressState state);
|
2015-08-05 22:54:00 -06:00
|
|
|
|
2015-08-05 23:07:00 -06:00
|
|
|
// Set the overlay icon in taskbar.
|
2018-04-17 19:44:10 -06:00
|
|
|
bool SetOverlayIcon(HWND window,
|
2024-03-19 05:50:30 -06:00
|
|
|
const SkBitmap& bitmap,
|
2018-04-17 19:44:10 -06:00
|
|
|
const std::string& text);
|
2015-08-05 23:07:00 -06:00
|
|
|
|
2016-07-14 14:27:16 -06:00
|
|
|
// Set the region of the window to show as a thumbnail in taskbar.
|
2016-08-07 11:23:42 -06:00
|
|
|
bool SetThumbnailClip(HWND window, const gfx::Rect& region);
|
|
|
|
|
|
|
|
// Set the tooltip for the thumbnail in taskbar.
|
|
|
|
bool SetThumbnailToolTip(HWND window, const std::string& tooltip);
|
2016-07-14 14:27:16 -06:00
|
|
|
|
2015-08-05 22:44:07 -06:00
|
|
|
// Called by the window that there is a button in thumbar clicked.
|
2015-08-01 21:11:29 -06:00
|
|
|
bool HandleThumbarButtonEvent(int button_id);
|
|
|
|
|
2021-03-25 05:02:47 -06:00
|
|
|
void SetThumbarButtonsAdded(bool added) { thumbar_buttons_added_ = added; }
|
|
|
|
|
2015-08-01 21:11:29 -06:00
|
|
|
private:
|
2016-06-08 23:21:21 -06:00
|
|
|
// Initialize the taskbar object.
|
|
|
|
bool InitializeTaskbar();
|
2015-08-05 22:58:40 -06:00
|
|
|
|
2021-05-06 16:01:04 -06:00
|
|
|
using CallbackMap = std::map<int, base::RepeatingClosure>;
|
2015-08-05 22:44:07 -06:00
|
|
|
CallbackMap callback_map_;
|
2015-08-01 21:11:29 -06:00
|
|
|
|
2016-08-12 09:55:42 -06:00
|
|
|
std::vector<ThumbarButton> last_buttons_;
|
|
|
|
|
2015-08-05 22:58:40 -06:00
|
|
|
// The COM object of taskbar.
|
2018-04-18 11:20:15 -06:00
|
|
|
Microsoft::WRL::ComPtr<ITaskbarList3> taskbar_;
|
2015-08-05 22:58:40 -06:00
|
|
|
|
2015-08-05 22:44:07 -06:00
|
|
|
// Whether we have already added the buttons to thumbar.
|
2018-05-21 16:18:38 -06:00
|
|
|
bool thumbar_buttons_added_ = false;
|
2015-08-01 21:11:29 -06:00
|
|
|
};
|
|
|
|
|
2019-06-19 15:23:04 -06:00
|
|
|
} // namespace electron
|
2015-08-01 21:11:29 -06:00
|
|
|
|
2021-11-22 00:34:31 -07:00
|
|
|
#endif // ELECTRON_SHELL_BROWSER_UI_WIN_TASKBAR_HOST_H_
|