2014-10-31 18:17:05 +00:00
|
|
|
// Copyright (c) 2014 GitHub, Inc.
|
2014-07-02 14:14:52 +00:00
|
|
|
// Use of this source code is governed by the MIT license that can be
|
|
|
|
// found in the LICENSE file.
|
|
|
|
|
2014-07-03 17:30:36 +00:00
|
|
|
#ifndef ATOM_BROWSER_NATIVE_WINDOW_VIEWS_H_
|
|
|
|
#define ATOM_BROWSER_NATIVE_WINDOW_VIEWS_H_
|
2014-07-02 14:14:52 +00:00
|
|
|
|
|
|
|
#include "atom/browser/native_window.h"
|
|
|
|
|
2018-09-13 00:25:56 +00:00
|
|
|
#include <memory>
|
2017-08-14 18:21:00 +00:00
|
|
|
#include <set>
|
2014-07-03 17:30:36 +00:00
|
|
|
#include <string>
|
|
|
|
|
2014-07-08 04:55:33 +00:00
|
|
|
#include "ui/views/widget/widget_observer.h"
|
2014-07-03 17:30:36 +00:00
|
|
|
|
2015-08-06 02:15:27 +00:00
|
|
|
#if defined(OS_WIN)
|
|
|
|
#include "atom/browser/ui/win/message_handler_delegate.h"
|
2015-08-06 03:10:34 +00:00
|
|
|
#include "atom/browser/ui/win/taskbar_host.h"
|
2016-05-31 08:47:45 +00:00
|
|
|
#include "base/win/scoped_gdi_object.h"
|
2015-08-06 02:15:27 +00:00
|
|
|
#endif
|
|
|
|
|
2014-07-03 17:30:36 +00:00
|
|
|
namespace views {
|
2014-07-07 15:02:46 +00:00
|
|
|
class UnhandledKeyboardEventHandler;
|
2014-07-03 17:30:36 +00:00
|
|
|
}
|
2014-07-02 14:14:52 +00:00
|
|
|
|
|
|
|
namespace atom {
|
|
|
|
|
2014-07-11 00:57:19 +00:00
|
|
|
class GlobalMenuBarX11;
|
2018-05-01 04:28:22 +00:00
|
|
|
class RootView;
|
2014-11-25 03:46:30 +00:00
|
|
|
class WindowStateWatcher;
|
2015-08-06 02:25:50 +00:00
|
|
|
|
2015-08-02 03:11:29 +00:00
|
|
|
#if defined(OS_WIN)
|
|
|
|
class AtomDesktopWindowTreeHostWin;
|
2016-06-19 08:35:56 +00:00
|
|
|
#elif defined(USE_X11)
|
|
|
|
class EventDisabler;
|
2015-08-02 03:11:29 +00:00
|
|
|
#endif
|
2014-07-11 00:57:19 +00:00
|
|
|
|
2014-07-03 17:30:36 +00:00
|
|
|
class NativeWindowViews : public NativeWindow,
|
2015-08-06 02:15:27 +00:00
|
|
|
#if defined(OS_WIN)
|
|
|
|
public MessageHandlerDelegate,
|
|
|
|
#endif
|
2014-07-08 04:55:33 +00:00
|
|
|
public views::WidgetObserver {
|
2014-07-02 14:14:52 +00:00
|
|
|
public:
|
2018-04-18 01:44:10 +00:00
|
|
|
NativeWindowViews(const mate::Dictionary& options, NativeWindow* parent);
|
2015-06-25 01:47:57 +00:00
|
|
|
~NativeWindowViews() override;
|
2014-07-02 14:14:52 +00:00
|
|
|
|
|
|
|
// NativeWindow:
|
2018-05-08 03:51:27 +00:00
|
|
|
void SetContentView(views::View* view) override;
|
2014-11-12 12:08:51 +00:00
|
|
|
void Close() override;
|
|
|
|
void CloseImmediately() override;
|
|
|
|
void Focus(bool focus) override;
|
|
|
|
bool IsFocused() override;
|
|
|
|
void Show() override;
|
|
|
|
void ShowInactive() override;
|
|
|
|
void Hide() override;
|
|
|
|
bool IsVisible() override;
|
2016-06-17 08:38:44 +00:00
|
|
|
bool IsEnabled() override;
|
2018-04-08 11:20:43 +00:00
|
|
|
void SetEnabled(bool enable) override;
|
2014-11-12 12:08:51 +00:00
|
|
|
void Maximize() override;
|
|
|
|
void Unmaximize() override;
|
|
|
|
bool IsMaximized() override;
|
|
|
|
void Minimize() override;
|
|
|
|
void Restore() override;
|
|
|
|
bool IsMinimized() override;
|
2014-11-25 06:34:14 +00:00
|
|
|
void SetFullScreen(bool fullscreen) override;
|
2015-04-21 13:35:36 +00:00
|
|
|
bool IsFullscreen() const override;
|
2016-01-15 04:54:12 +00:00
|
|
|
void SetBounds(const gfx::Rect& bounds, bool animate) override;
|
2015-05-01 10:50:53 +00:00
|
|
|
gfx::Rect GetBounds() override;
|
2016-07-29 01:19:17 +00:00
|
|
|
gfx::Rect GetContentBounds() override;
|
2015-10-05 12:03:43 +00:00
|
|
|
gfx::Size GetContentSize() override;
|
2018-08-24 21:33:27 +00:00
|
|
|
gfx::Rect GetNormalBounds() override;
|
2015-10-06 08:06:39 +00:00
|
|
|
void SetContentSizeConstraints(
|
|
|
|
const extensions::SizeConstraints& size_constraints) override;
|
2014-11-12 12:08:51 +00:00
|
|
|
void SetResizable(bool resizable) override;
|
2018-04-03 13:04:32 +00:00
|
|
|
#if defined(OS_WIN)
|
|
|
|
void MoveTop() override;
|
|
|
|
#endif
|
2014-11-12 12:08:51 +00:00
|
|
|
bool IsResizable() override;
|
2016-01-18 22:46:35 +00:00
|
|
|
void SetMovable(bool movable) override;
|
|
|
|
bool IsMovable() override;
|
|
|
|
void SetMinimizable(bool minimizable) override;
|
|
|
|
bool IsMinimizable() override;
|
2016-01-22 21:24:33 +00:00
|
|
|
void SetMaximizable(bool maximizable) override;
|
|
|
|
bool IsMaximizable() override;
|
2016-01-23 07:47:37 +00:00
|
|
|
void SetFullScreenable(bool fullscreenable) override;
|
|
|
|
bool IsFullScreenable() override;
|
2016-01-18 22:46:35 +00:00
|
|
|
void SetClosable(bool closable) override;
|
|
|
|
bool IsClosable() override;
|
2018-04-18 01:44:10 +00:00
|
|
|
void SetAlwaysOnTop(bool top,
|
|
|
|
const std::string& level,
|
|
|
|
int relativeLevel,
|
|
|
|
std::string* error) override;
|
2014-11-12 12:08:51 +00:00
|
|
|
bool IsAlwaysOnTop() override;
|
|
|
|
void Center() override;
|
2017-02-14 03:41:24 +00:00
|
|
|
void Invalidate() override;
|
2014-11-12 12:08:51 +00:00
|
|
|
void SetTitle(const std::string& title) override;
|
|
|
|
std::string GetTitle() override;
|
|
|
|
void FlashFrame(bool flash) override;
|
|
|
|
void SetSkipTaskbar(bool skip) override;
|
2017-08-13 06:28:33 +00:00
|
|
|
void SetSimpleFullScreen(bool simple_fullscreen) override;
|
|
|
|
bool IsSimpleFullScreen() override;
|
2014-11-12 12:08:51 +00:00
|
|
|
void SetKiosk(bool kiosk) override;
|
|
|
|
bool IsKiosk() override;
|
2018-03-06 04:21:47 +00:00
|
|
|
void SetBackgroundColor(SkColor color) override;
|
2016-01-23 10:55:12 +00:00
|
|
|
void SetHasShadow(bool has_shadow) override;
|
|
|
|
bool HasShadow() override;
|
2017-09-29 02:26:02 +00:00
|
|
|
void SetOpacity(const double opacity) override;
|
2017-10-02 15:08:10 +00:00
|
|
|
double GetOpacity() override;
|
2017-08-14 18:21:00 +00:00
|
|
|
void SetIgnoreMouseEvents(bool ignore, bool forward) override;
|
2016-06-22 08:40:01 +00:00
|
|
|
void SetContentProtection(bool enable) override;
|
2016-06-13 08:10:28 +00:00
|
|
|
void SetFocusable(bool focusable) override;
|
2016-07-06 23:04:18 +00:00
|
|
|
void SetMenu(AtomMenuModel* menu_model) override;
|
Implement initial, experimental BrowserView API
Right now, `<webview>` is the only way to embed additional content in a
`BrowserWindow`. Unfortunately `<webview>` suffers from a [number of
problems](https://github.com/electron/electron/issues?utf8=%E2%9C%93&q=is%3Aissue%20is%3Aopen%20label%3Awebview%20).
To make matters worse, many of these are upstream Chromium bugs instead
of Electron-specific bugs.
For us at [Figma](https://www.figma.com), the main issue is very slow
performance.
Despite the upstream improvements to `<webview>` through the OOPIF work, it is
probable that there will continue to be `<webview>`-specific bugs in the
future.
Therefore, this introduces a `<webview>` alternative to called `BrowserView`,
which...
- is a thin wrapper around `api::WebContents` (so bugs in `BrowserView` will
likely also be bugs in `BrowserWindow` web contents)
- is instantiated in the main process like `BrowserWindow` (and unlike
`<webview>`, which lives in the DOM of a `BrowserWindow` web contents)
- needs to be added to a `BrowserWindow` to display something on the screen
This implements the most basic API. The API is expected to evolve and change in
the near future and has consequently been marked as experimental. Please do not
use this API in production unless you are prepared to deal with breaking
changes.
In the future, we will want to change the API to support multiple
`BrowserView`s per window. We will also want to consider z-ordering
auto-resizing, and possibly even nested views.
2017-04-11 17:47:30 +00:00
|
|
|
void SetBrowserView(NativeBrowserView* browser_view) override;
|
2016-06-17 06:28:43 +00:00
|
|
|
void SetParentWindow(NativeWindow* parent) override;
|
2017-05-21 18:57:19 +00:00
|
|
|
gfx::NativeView GetNativeView() const override;
|
|
|
|
gfx::NativeWindow GetNativeWindow() const override;
|
2015-02-07 01:00:26 +00:00
|
|
|
void SetOverlayIcon(const gfx::Image& overlay,
|
2015-02-07 00:31:41 +00:00
|
|
|
const std::string& description) override;
|
2016-08-09 23:05:44 +00:00
|
|
|
void SetProgressBar(double progress, const ProgressState state) override;
|
2014-11-12 12:32:14 +00:00
|
|
|
void SetAutoHideMenuBar(bool auto_hide) override;
|
|
|
|
bool IsMenuBarAutoHide() override;
|
|
|
|
void SetMenuBarVisibility(bool visible) override;
|
|
|
|
bool IsMenuBarVisible() override;
|
2018-08-31 22:06:02 +00:00
|
|
|
|
|
|
|
void SetVisibleOnAllWorkspaces(bool visible,
|
|
|
|
bool visibleOnFullScreen) override;
|
|
|
|
|
2015-03-26 06:18:37 +00:00
|
|
|
bool IsVisibleOnAllWorkspaces() override;
|
2014-07-02 14:14:52 +00:00
|
|
|
|
2017-05-21 18:57:19 +00:00
|
|
|
gfx::AcceleratedWidget GetAcceleratedWidget() const override;
|
2014-07-21 14:03:58 +00:00
|
|
|
|
2018-02-22 06:16:24 +00:00
|
|
|
gfx::Rect ContentBoundsToWindowBounds(const gfx::Rect& bounds) const override;
|
|
|
|
gfx::Rect WindowBoundsToContentBounds(const gfx::Rect& bounds) const override;
|
2018-03-06 05:44:36 +00:00
|
|
|
|
|
|
|
void UpdateDraggableRegions(std::unique_ptr<SkRegion> region);
|
2018-02-22 06:16:24 +00:00
|
|
|
|
2018-10-18 21:23:40 +00:00
|
|
|
void IncrementChildModals();
|
|
|
|
void DecrementChildModals();
|
|
|
|
|
2015-08-06 03:10:34 +00:00
|
|
|
#if defined(OS_WIN)
|
2016-05-20 10:46:05 +00:00
|
|
|
void SetIcon(HICON small_icon, HICON app_icon);
|
2016-05-20 13:22:15 +00:00
|
|
|
#elif defined(USE_X11)
|
|
|
|
void SetIcon(const gfx::ImageSkia& icon);
|
2015-08-06 03:10:34 +00:00
|
|
|
#endif
|
|
|
|
|
2018-02-22 06:16:24 +00:00
|
|
|
SkRegion* draggable_region() const { return draggable_region_.get(); }
|
2016-05-20 10:46:05 +00:00
|
|
|
|
2016-05-20 13:22:15 +00:00
|
|
|
#if defined(OS_WIN)
|
|
|
|
TaskbarHost& taskbar_host() { return taskbar_host_; }
|
|
|
|
#endif
|
|
|
|
|
2014-07-02 14:14:52 +00:00
|
|
|
private:
|
2014-07-08 04:55:33 +00:00
|
|
|
// views::WidgetObserver:
|
2018-04-18 01:44:10 +00:00
|
|
|
void OnWidgetActivationChanged(views::Widget* widget, bool active) override;
|
|
|
|
void OnWidgetBoundsChanged(views::Widget* widget,
|
|
|
|
const gfx::Rect& bounds) override;
|
2014-07-08 04:55:33 +00:00
|
|
|
|
2014-07-03 17:30:36 +00:00
|
|
|
// views::WidgetDelegate:
|
2014-11-12 12:08:51 +00:00
|
|
|
void DeleteDelegate() override;
|
|
|
|
views::View* GetInitiallyFocusedView() override;
|
|
|
|
bool CanResize() const override;
|
|
|
|
bool CanMaximize() const override;
|
2014-12-16 00:46:37 +00:00
|
|
|
bool CanMinimize() const override;
|
2014-11-12 12:08:51 +00:00
|
|
|
base::string16 GetWindowTitle() const override;
|
|
|
|
views::View* GetContentsView() override;
|
|
|
|
bool ShouldDescendIntoChildForEventHandling(
|
2018-04-18 01:44:10 +00:00
|
|
|
gfx::NativeView child,
|
|
|
|
const gfx::Point& location) override;
|
2014-11-12 12:08:51 +00:00
|
|
|
views::ClientView* CreateClientView(views::Widget* widget) override;
|
|
|
|
views::NonClientFrameView* CreateNonClientFrameView(
|
|
|
|
views::Widget* widget) override;
|
2015-05-10 03:44:18 +00:00
|
|
|
void OnWidgetMove() override;
|
2014-11-25 06:28:34 +00:00
|
|
|
#if defined(OS_WIN)
|
|
|
|
bool ExecuteWindowsCommand(int command_id) override;
|
2014-11-24 08:04:41 +00:00
|
|
|
#endif
|
2014-09-09 07:30:33 +00:00
|
|
|
|
2015-08-06 02:25:50 +00:00
|
|
|
#if defined(OS_WIN)
|
|
|
|
// MessageHandlerDelegate:
|
2018-04-18 01:44:10 +00:00
|
|
|
bool PreHandleMSG(UINT message,
|
|
|
|
WPARAM w_param,
|
|
|
|
LPARAM l_param,
|
|
|
|
LRESULT* result) override;
|
2015-09-28 23:20:09 +00:00
|
|
|
void HandleSizeEvent(WPARAM w_param, LPARAM l_param);
|
2017-08-14 18:21:00 +00:00
|
|
|
void SetForwardMouseMessages(bool forward);
|
2018-04-18 01:44:10 +00:00
|
|
|
static LRESULT CALLBACK SubclassProc(HWND hwnd,
|
|
|
|
UINT msg,
|
|
|
|
WPARAM w_param,
|
|
|
|
LPARAM l_param,
|
|
|
|
UINT_PTR subclass_id,
|
|
|
|
DWORD_PTR ref_data);
|
|
|
|
static LRESULT CALLBACK MouseHookProc(int n_code,
|
|
|
|
WPARAM w_param,
|
|
|
|
LPARAM l_param);
|
2015-08-06 02:25:50 +00:00
|
|
|
#endif
|
|
|
|
|
2018-10-18 21:23:40 +00:00
|
|
|
// Enable/disable:
|
|
|
|
bool ShouldBeEnabled();
|
|
|
|
void SetEnabledInternal(bool enabled);
|
|
|
|
|
2015-06-25 03:07:23 +00:00
|
|
|
// NativeWindow:
|
2014-11-12 12:08:51 +00:00
|
|
|
void HandleKeyboardEvent(
|
2014-07-04 08:54:10 +00:00
|
|
|
content::WebContents*,
|
2014-11-12 12:08:51 +00:00
|
|
|
const content::NativeWebKeyboardEvent& event) override;
|
2014-07-04 08:54:10 +00:00
|
|
|
|
2015-03-26 08:39:03 +00:00
|
|
|
// Returns the restore state for the window.
|
|
|
|
ui::WindowShowState GetRestoredState();
|
|
|
|
|
2018-05-01 04:28:22 +00:00
|
|
|
std::unique_ptr<RootView> root_view_;
|
|
|
|
|
2018-05-21 22:18:38 +00:00
|
|
|
// The view should be focused by default.
|
|
|
|
views::View* focused_view_ = nullptr;
|
2014-07-04 08:54:10 +00:00
|
|
|
|
2018-04-25 07:25:55 +00:00
|
|
|
// The "resizable" flag on Linux is implemented by setting size constraints,
|
|
|
|
// we need to make sure size constraints are restored when window becomes
|
|
|
|
// resizable again. This is also used on Windows, to keep taskbar resize
|
|
|
|
// events from resizing the window.
|
|
|
|
extensions::SizeConstraints old_size_constraints_;
|
|
|
|
|
2014-07-11 00:57:19 +00:00
|
|
|
#if defined(USE_X11)
|
2016-05-23 01:59:39 +00:00
|
|
|
std::unique_ptr<GlobalMenuBarX11> global_menu_bar_;
|
2014-07-11 00:57:19 +00:00
|
|
|
|
2014-11-25 03:46:30 +00:00
|
|
|
// Handles window state events.
|
2016-05-23 01:59:39 +00:00
|
|
|
std::unique_ptr<WindowStateWatcher> window_state_watcher_;
|
2015-10-06 08:06:39 +00:00
|
|
|
|
2016-06-19 08:35:56 +00:00
|
|
|
// To disable the mouse events.
|
|
|
|
std::unique_ptr<EventDisabler> event_disabler_;
|
2017-11-12 23:35:39 +00:00
|
|
|
#endif
|
2018-04-25 07:25:55 +00:00
|
|
|
|
2017-11-12 23:35:39 +00:00
|
|
|
#if defined(OS_WIN)
|
2015-08-02 03:11:29 +00:00
|
|
|
// Weak ref.
|
|
|
|
AtomDesktopWindowTreeHostWin* atom_desktop_window_tree_host_win_;
|
2015-09-28 23:20:09 +00:00
|
|
|
|
|
|
|
ui::WindowShowState last_window_state_;
|
|
|
|
|
2016-11-22 04:49:56 +00:00
|
|
|
// There's an issue with restore on Windows, that sometimes causes the Window
|
|
|
|
// to receive the wrong size (#2498). To circumvent that, we keep tabs on the
|
|
|
|
// size of the window while in the normal state (not maximized, minimized or
|
|
|
|
// fullscreen), so we restore it correctly.
|
|
|
|
gfx::Rect last_normal_bounds_;
|
2016-11-22 05:07:05 +00:00
|
|
|
gfx::Rect last_normal_bounds_before_move_;
|
2016-11-22 04:49:56 +00:00
|
|
|
|
|
|
|
// last_normal_bounds_ may or may not require update on WM_MOVE. When a
|
|
|
|
// window is maximized, it is moved (WM_MOVE) to maximum size first and then
|
|
|
|
// sized (WM_SIZE). In this case, last_normal_bounds_ should not update. We
|
|
|
|
// keep last_normal_bounds_candidate_ as a candidate which will become valid
|
|
|
|
// last_normal_bounds_ if the moves are consecutive with no WM_SIZE event in
|
|
|
|
// between.
|
|
|
|
gfx::Rect last_normal_bounds_candidate_;
|
|
|
|
|
|
|
|
bool consecutive_moves_;
|
|
|
|
|
2015-08-06 02:30:22 +00:00
|
|
|
// In charge of running taskbar related APIs.
|
2015-08-06 03:10:34 +00:00
|
|
|
TaskbarHost taskbar_host_;
|
2016-04-06 17:36:39 +00:00
|
|
|
|
2016-10-13 18:46:55 +00:00
|
|
|
// Memoized version of a11y check
|
2018-05-21 22:18:38 +00:00
|
|
|
bool checked_for_a11y_support_ = false;
|
2016-10-13 18:46:55 +00:00
|
|
|
|
2016-07-09 12:49:15 +00:00
|
|
|
// Whether to show the WS_THICKFRAME style.
|
2018-05-21 22:18:38 +00:00
|
|
|
bool thick_frame_ = true;
|
2016-07-09 12:49:15 +00:00
|
|
|
|
2016-07-09 14:16:57 +00:00
|
|
|
// The bounds of window before maximize/fullscreen.
|
|
|
|
gfx::Rect restore_bounds_;
|
|
|
|
|
2016-05-31 08:47:45 +00:00
|
|
|
// The icons of window and taskbar.
|
|
|
|
base::win::ScopedHICON window_icon_;
|
|
|
|
base::win::ScopedHICON app_icon_;
|
2017-08-02 19:16:37 +00:00
|
|
|
|
2017-08-14 16:12:55 +00:00
|
|
|
// The set of windows currently forwarding mouse messages.
|
|
|
|
static std::set<NativeWindowViews*> forwarding_windows_;
|
2017-08-02 19:16:37 +00:00
|
|
|
static HHOOK mouse_hook_;
|
|
|
|
bool forwarding_mouse_messages_ = false;
|
2017-08-14 16:12:55 +00:00
|
|
|
HWND legacy_window_ = NULL;
|
2017-09-29 02:26:02 +00:00
|
|
|
bool layered_ = false;
|
2014-11-25 05:05:04 +00:00
|
|
|
#endif
|
2014-11-25 03:46:30 +00:00
|
|
|
|
2014-07-07 15:02:46 +00:00
|
|
|
// Handles unhandled keyboard messages coming back from the renderer process.
|
2016-05-23 01:59:39 +00:00
|
|
|
std::unique_ptr<views::UnhandledKeyboardEventHandler> keyboard_event_handler_;
|
2014-07-07 15:02:46 +00:00
|
|
|
|
2018-02-22 06:16:24 +00:00
|
|
|
// For custom drag, the whole window is non-draggable and the draggable region
|
|
|
|
// has to been explicitly provided.
|
|
|
|
std::unique_ptr<SkRegion> draggable_region_; // used in custom drag.
|
|
|
|
|
2018-10-18 21:23:40 +00:00
|
|
|
// Whether the window should be enabled based on user calls to SetEnabled()
|
|
|
|
bool is_enabled_ = true;
|
|
|
|
// How many modal children this window has;
|
|
|
|
// used to determine enabled state
|
|
|
|
unsigned int num_modal_children_ = 0;
|
2018-05-21 22:18:38 +00:00
|
|
|
|
|
|
|
bool use_content_size_ = false;
|
|
|
|
bool movable_ = true;
|
|
|
|
bool resizable_ = true;
|
|
|
|
bool maximizable_ = true;
|
|
|
|
bool minimizable_ = true;
|
|
|
|
bool fullscreenable_ = true;
|
2014-07-03 17:30:36 +00:00
|
|
|
std::string title_;
|
2015-05-09 15:55:10 +00:00
|
|
|
gfx::Size widget_size_;
|
2017-10-02 15:08:10 +00:00
|
|
|
double opacity_ = 1.0;
|
2014-07-02 14:14:52 +00:00
|
|
|
|
2014-07-03 17:30:36 +00:00
|
|
|
DISALLOW_COPY_AND_ASSIGN(NativeWindowViews);
|
2014-07-02 14:14:52 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
} // namespace atom
|
|
|
|
|
2014-07-03 17:30:36 +00:00
|
|
|
#endif // ATOM_BROWSER_NATIVE_WINDOW_VIEWS_H_
|