electron/atom/browser/native_window_views.h

279 lines
9.1 KiB
C
Raw Normal View History

// 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.
#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"
#include <string>
#include <vector>
2014-07-04 08:54:10 +00:00
#include "atom/browser/ui/accelerator_util.h"
#include "ui/views/widget/widget_delegate.h"
2014-07-08 04:55:33 +00:00
#include "ui/views/widget/widget_observer.h"
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"
#include "ui/base/win/accessibility_misc_utils.h"
#include <UIAutomationCoreApi.h>
2015-08-06 02:15:27 +00:00
#endif
namespace views {
class UnhandledKeyboardEventHandler;
}
2014-07-02 14:14:52 +00:00
namespace atom {
class GlobalMenuBarX11;
2014-07-16 14:10:10 +00:00
class MenuBar;
2014-11-25 03:46:30 +00:00
class WindowStateWatcher;
#if defined(OS_WIN)
class AtomDesktopWindowTreeHostWin;
#elif defined(USE_X11)
class EventDisabler;
#endif
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::WidgetDelegateView,
public views::WidgetObserver {
2014-07-02 14:14:52 +00:00
public:
NativeWindowViews(brightray::InspectableWebContents* inspectable_web_contents,
2016-06-19 03:06:08 +00:00
const mate::Dictionary& options,
NativeWindow* parent);
~NativeWindowViews() override;
2014-07-02 14:14:52 +00:00
// NativeWindow:
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;
bool IsEnabled() override;
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;
gfx::Rect GetBounds() override;
2016-07-29 01:19:17 +00:00
gfx::Rect GetContentBounds() override;
gfx::Size GetContentSize() override;
void SetContentSizeConstraints(
const extensions::SizeConstraints& size_constraints) override;
void SetResizable(bool resizable) override;
bool IsResizable() override;
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;
void SetClosable(bool closable) override;
bool IsClosable() override;
void SetAlwaysOnTop(bool top, const std::string& level,
int relativeLevel, std::string* error) override;
bool IsAlwaysOnTop() override;
void Center() override;
void Invalidate() override;
void SetTitle(const std::string& title) override;
std::string GetTitle() override;
void FlashFrame(bool flash) override;
void SetSkipTaskbar(bool skip) override;
void SetKiosk(bool kiosk) override;
bool IsKiosk() override;
2015-10-23 03:35:33 +00:00
void SetBackgroundColor(const std::string& color_name) override;
2016-01-23 10:55:12 +00:00
void SetHasShadow(bool has_shadow) override;
bool HasShadow() override;
void SetIgnoreMouseEvents(bool ignore) override;
void SetContentProtection(bool enable) override;
2016-06-13 08:10:28 +00:00
void SetFocusable(bool focusable) override;
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;
void SetParentWindow(NativeWindow* parent) override;
gfx::NativeView GetNativeView() override;
gfx::NativeWindow GetNativeWindow() override;
2015-02-07 01:00:26 +00:00
void SetOverlayIcon(const gfx::Image& overlay,
const std::string& description) override;
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;
void SetVisibleOnAllWorkspaces(bool visible) override;
bool IsVisibleOnAllWorkspaces() override;
2014-07-02 14:14:52 +00:00
2016-01-07 20:38:35 +00:00
gfx::AcceleratedWidget GetAcceleratedWidget() override;
2014-07-21 14:03:58 +00:00
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
void SetEnabled(bool enable);
2016-05-20 10:46:05 +00:00
views::Widget* widget() const { return window_.get(); }
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:
void OnWidgetActivationChanged(
views::Widget* widget, bool active) override;
2015-05-09 15:55:10 +00:00
void OnWidgetBoundsChanged(
views::Widget* widget, const gfx::Rect& bounds) override;
2014-07-08 04:55:33 +00:00
// views::WidgetDelegate:
void DeleteDelegate() override;
views::View* GetInitiallyFocusedView() override;
bool CanResize() const override;
bool CanMaximize() const override;
bool CanMinimize() const override;
base::string16 GetWindowTitle() const override;
bool ShouldHandleSystemCommands() const override;
views::Widget* GetWidget() override;
const views::Widget* GetWidget() const override;
views::View* GetContentsView() override;
bool ShouldDescendIntoChildForEventHandling(
gfx::NativeView child,
const gfx::Point& location) override;
views::ClientView* CreateClientView(views::Widget* widget) override;
views::NonClientFrameView* CreateNonClientFrameView(
views::Widget* widget) override;
void OnWidgetMove() override;
2014-11-25 06:28:34 +00:00
#if defined(OS_WIN)
bool ExecuteWindowsCommand(int command_id) override;
#endif
#if defined(OS_WIN)
// MessageHandlerDelegate:
bool PreHandleMSG(
UINT message, WPARAM w_param, LPARAM l_param, LRESULT* result) override;
void HandleSizeEvent(WPARAM w_param, LPARAM l_param);
#endif
// NativeWindow:
gfx::Rect ContentBoundsToWindowBounds(const gfx::Rect& bounds) override;
gfx::Rect WindowBoundsToContentBounds(const gfx::Rect& bounds) override;
void HandleKeyboardEvent(
2014-07-04 08:54:10 +00:00
content::WebContents*,
const content::NativeWebKeyboardEvent& event) override;
2014-07-04 08:54:10 +00:00
// views::View:
void Layout() override;
gfx::Size GetMinimumSize() override;
gfx::Size GetMaximumSize() override;
bool AcceleratorPressed(const ui::Accelerator& accelerator) override;
2014-07-04 08:54:10 +00:00
// Register accelerators supported by the menu model.
void RegisterAccelerators(AtomMenuModel* menu_model);
2014-07-04 08:54:10 +00:00
// Returns the restore state for the window.
ui::WindowShowState GetRestoredState();
2016-05-23 01:59:39 +00:00
std::unique_ptr<views::Widget> window_;
2014-07-04 08:54:10 +00:00
views::View* web_view_; // Managed by inspectable_web_contents_.
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
NativeBrowserView* browser_view_;
2016-05-23 01:59:39 +00:00
std::unique_ptr<MenuBar> menu_bar_;
bool menu_bar_autohide_;
2014-08-07 08:48:30 +00:00
bool menu_bar_visible_;
bool menu_bar_alt_pressed_;
#if defined(USE_X11)
2016-05-23 01:59:39 +00:00
std::unique_ptr<GlobalMenuBarX11> global_menu_bar_;
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_;
// To disable the mouse events.
std::unique_ptr<EventDisabler> event_disabler_;
// 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.
extensions::SizeConstraints old_size_constraints_;
2014-11-25 06:28:34 +00:00
#elif defined(OS_WIN)
// Weak ref.
AtomDesktopWindowTreeHostWin* atom_desktop_window_tree_host_win_;
ui::WindowShowState last_window_state_;
// 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_;
gfx::Rect last_normal_bounds_before_move_;
// 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_;
// Memoized version of a11y check
bool checked_for_a11y_support_;
2016-07-09 12:49:15 +00:00
// Whether to show the WS_THICKFRAME style.
bool thick_frame_;
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_;
#endif
2014-11-25 03:46:30 +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-04 08:54:10 +00:00
// Map from accelerator to menu item's command id.
accelerator_util::AcceleratorTable accelerator_table_;
// How many times the Disable has been called.
int disable_count_;
bool use_content_size_;
2016-01-23 10:23:18 +00:00
bool movable_;
bool resizable_;
bool maximizable_;
bool minimizable_;
bool fullscreenable_;
std::string title_;
2015-05-09 15:55:10 +00:00
gfx::Size widget_size_;
2014-07-02 14:14:52 +00:00
DISALLOW_COPY_AND_ASSIGN(NativeWindowViews);
2014-07-02 14:14:52 +00:00
};
} // namespace atom
#endif // ATOM_BROWSER_NATIVE_WINDOW_VIEWS_H_