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
|
// Copyright 2024 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef ASH_QUICK_INSERT_VIEWS_QUICK_INSERT_PREVIEW_BUBBLE_CONTROLLER_H_
#define ASH_QUICK_INSERT_VIEWS_QUICK_INSERT_PREVIEW_BUBBLE_CONTROLLER_H_
#include <optional>
#include "ash/ash_export.h"
#include "ash/public/cpp/holding_space/holding_space_image.h"
#include "base/callback_list.h"
#include "base/files/file.h"
#include "base/functional/callback_forward.h"
#include "base/memory/weak_ptr.h"
#include "base/observer_list.h"
#include "base/scoped_observation.h"
#include "base/timer/timer.h"
#include "ui/views/widget/widget_observer.h"
namespace base {
class FilePath;
}
namespace views {
class View;
class Widget;
} // namespace views
namespace ash {
class QuickInsertPreviewBubbleView;
class ASH_EXPORT QuickInsertPreviewBubbleController
: public views::WidgetObserver {
public:
class Observer : public base::CheckedObserver {
public:
// Called when the bubble is shown or hidden.
virtual void OnPreviewBubbleVisibilityChanged(bool visible) = 0;
};
QuickInsertPreviewBubbleController();
QuickInsertPreviewBubbleController(
const QuickInsertPreviewBubbleController&) = delete;
QuickInsertPreviewBubbleController& operator=(
const QuickInsertPreviewBubbleController&) = delete;
~QuickInsertPreviewBubbleController() override;
// Creates the preview bubble if needed and shows it after a delay. If called
// while a bubble was previously already created, the existing bubble is kept
// but the delay to show the bubble (if not already shown) is reset.
// `async_preview_image` must remain alive while the bubble is open.
// `anchor_view` must not be `nullptr`.
// Destroying `anchor_view` closes the bubble if it's shown.
void ShowBubbleAfterDelay(HoldingSpaceImage* async_preview_image,
const base::FilePath& path,
views::View* anchor_view);
// TODO: b/322899032 - Take in an `anchor_view` to avoid accidentally closing
// the bubble view shown by a different anchor view.
void CloseBubble();
bool IsBubbleVisible() const;
void AddObserver(Observer* observer);
void RemoveObserver(Observer* observer);
// Updates the bubble view labels for the currently open bubble.
// If the bubble is not shown, this does nothing.
// If `text` is empty, then the bubble view labels are hidden.
void SetBubbleMainText(const std::u16string& text);
// views::WidgetObserver:
void OnWidgetDestroying(views::Widget* widget) override;
void ShowBubbleImmediatelyForTesting(HoldingSpaceImage* async_preview_image,
views::View* anchor_view);
QuickInsertPreviewBubbleView* bubble_view_for_testing() const;
private:
void UpdateBubbleImage();
void CreateBubbleWidget(HoldingSpaceImage* async_preview_image,
views::View* anchor_view);
// Shows the bubble if one has been created. Does nothing if the bubble is
// already being shown.
void ShowBubble();
// Timer to show the preview bubble after a delay.
base::OneShotTimer show_bubble_timer_;
raw_ptr<HoldingSpaceImage> async_preview_image_;
// Owned by the bubble widget.
raw_ptr<QuickInsertPreviewBubbleView> bubble_view_;
base::ObserverList<Observer> observers_;
base::CallbackListSubscription image_subscription_;
base::ScopedObservation<views::Widget, views::WidgetObserver>
widget_observation_{this};
base::WeakPtrFactory<QuickInsertPreviewBubbleController> weak_ptr_factory_{
this};
};
} // namespace ash
#endif // ASH_QUICK_INSERT_VIEWS_QUICK_INSERT_PREVIEW_BUBBLE_CONTROLLER_H_
|
