1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
// Copyright 2012 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef UI_VIEWS_CONTROLS_MENU_MENU_HOST_H_
#define UI_VIEWS_CONTROLS_MENU_MENU_HOST_H_
#include <memory>
#include <string>
#include "base/memory/raw_ptr.h"
#include "base/scoped_observation.h"
#include "build/build_config.h"
#include "ui/base/owned_window_anchor.h"
#include "ui/views/widget/widget.h"
#include "ui/views/widget/widget_observer.h"
namespace gfx {
class Insets;
class Rect;
} // namespace gfx
namespace views {
class MenuControllerTest;
class SubmenuView;
class View;
class Widget;
namespace internal {
#if defined(USE_AURA)
// This class is internal to views.
class PreMenuEventDispatchHandler;
#endif // defined(USE_AURA)
} // namespace internal
// `SubmenuView` uses a `MenuHost` to house the `SubmenuView`.
//
// As a `Widget`, `MenuHost` is owned by the widget system. `SubmenuView`
// creates `MenuHost` and when `SubmenuView` is done with the `MenuHost`
// `DestroyMenuHost` is invoked, which leads to the destruction of the
// `MenuHost`. Alternatively, the OS may destroy the widget. In this case
// `MenuHost` invokes `MenuHostDestroyed` on the `SubmenuView` and the
// `SubmenuView` then drops references to the `MenuHost`.
class MenuHost : public Widget, public WidgetObserver {
public:
struct InitParams {
raw_ptr<Widget> parent = nullptr;
gfx::Rect bounds;
raw_ptr<View> contents_view = nullptr;
bool do_capture = false;
gfx::NativeView native_view_for_gestures;
// Window that is stacked below a new menu window (can be different from the
// |parent|).
raw_ptr<Widget> context = nullptr;
// Additional information that helps to position anchored windows in such
// backends as Wayland.
ui::OwnedWindowAnchor owned_window_anchor;
};
explicit MenuHost(SubmenuView* submenu);
MenuHost(const MenuHost&) = delete;
MenuHost& operator=(const MenuHost&) = delete;
~MenuHost() override;
// Initializes and shows the MenuHost.
// WARNING: |init_params.parent| may be NULL.
void InitMenuHost(const InitParams& init_params);
// Returns true if the menu host is visible.
bool IsMenuHostVisible();
// Shows the menu host. If |do_capture| is true the menu host should do a
// mouse grab.
void ShowMenuHost(bool do_capture);
// Hides the menu host.
void HideMenuHost();
// Destroys and deletes the menu host.
void DestroyMenuHost();
// Sets the bounds of the menu host.
void SetMenuHostBounds(const gfx::Rect& bounds);
// Sets the anchor of the menu host.
void SetMenuHostOwnedWindowAnchor(const ui::OwnedWindowAnchor& anchor);
// Releases a mouse grab installed by |ShowMenuHost|.
void ReleaseMenuHostCapture();
private:
friend class MenuControllerTest;
// Widget:
internal::RootView* CreateRootView() override;
void OnMouseCaptureLost() override;
void OnNativeWidgetDestroyed() override;
void OnOwnerClosing() override;
void OnDragWillStart() override;
void OnDragComplete() override;
Widget* GetPrimaryWindowWidget() override;
gfx::Insets GetCustomInsetsInDIP() const override;
// WidgetObserver:
void OnWidgetDestroying(Widget* widget) override;
// Returns the parent of the MenuHost widget.
Widget* GetOwner();
base::ScopedObservation<Widget, WidgetObserver> owner_observation_{this};
gfx::NativeView native_view_for_gestures_ = gfx::NativeView();
// The view we contain, owned by `MenuItemView`.
raw_ptr<SubmenuView> submenu_ = nullptr;
// If true, DestroyMenuHost has been invoked.
bool destroying_ = false;
// If true and capture is lost we don't notify the delegate.
bool ignore_capture_lost_ = false;
#if defined(USE_AURA)
// Handles raw touch events at the moment.
std::unique_ptr<internal::PreMenuEventDispatchHandler> pre_dispatch_handler_;
#endif // defined(USE_AURA)
};
} // namespace views
#endif // UI_VIEWS_CONTROLS_MENU_MENU_HOST_H_
|
