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
|
// Copyright 2016 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_SELECTION_CONTROLLER_H_
#define UI_VIEWS_SELECTION_CONTROLLER_H_
#include "base/memory/raw_ptr.h"
#include "base/time/time.h"
#include "base/timer/timer.h"
#include "ui/gfx/geometry/point.h"
#include "ui/gfx/range/range.h"
#include "ui/gfx/selection_model.h"
#include "ui/views/views_export.h"
namespace gfx {
class RenderText;
}
namespace ui {
class MouseEvent;
}
namespace views {
class SelectionControllerDelegate;
// Helper class used to facilitate mouse event handling and text selection. To
// use, clients must implement the SelectionControllerDelegate interface.
// TODO(karandeepb): Also make this class handle gesture events.
class VIEWS_EXPORT SelectionController {
public:
// Describes whether the view managing the delegate was initially focused when
// the mouse press was received.
enum class InitialFocusStateOnMousePress {
kFocused,
kUnFocused,
};
// |delegate| must be non-null.
explicit SelectionController(SelectionControllerDelegate* delegate);
SelectionController(const SelectionController&) = delete;
SelectionController& operator=(const SelectionController&) = delete;
// Handle mouse events forwarded by |delegate_|. |handled| specifies whether
// the event has already been handled by the |delegate_|. If |handled| is
// true, the mouse event is just used to update the internal state without
// updating the state of the associated RenderText instance.
bool OnMousePressed(const ui::MouseEvent& event,
bool handled,
InitialFocusStateOnMousePress initial_focus_state);
bool OnMouseDragged(const ui::MouseEvent& event);
void OnMouseReleased(const ui::MouseEvent& event);
void OnMouseCaptureLost();
// Returns the latest click location in root coordinates.
const gfx::Point& last_click_root_location() const {
return last_click_root_location_;
}
// Sets whether the SelectionController should update or paste the
// selection clipboard on middle-click. Default is false.
void set_handles_selection_clipboard(bool value) {
handles_selection_clipboard_ = value;
}
// Offsets the double-clicked word's range. This is only used in the unusual
// case where the text changes on the second mousedown of a double-click.
// This is harmless if there is not a currently double-clicked word.
void OffsetDoubleClickWord(size_t offset);
private:
// Tracks the mouse clicks for single/double/triple clicks.
void TrackMouseClicks(const ui::MouseEvent& event);
// Selects the word at the given |point|.
void SelectWord(const gfx::Point& point);
// Selects all the text.
void SelectAll();
// Returns the associated render text instance via the |delegate_|.
gfx::RenderText* GetRenderText();
// Helper function to update the selection on a mouse drag as per
// |last_drag_location_|. Can be called asynchronously, through a timer.
void SelectThroughLastDragLocation();
// Returns whether |point| is inside any substring of the text.
bool IsInsideText(const gfx::Point& point);
// A timer and point used to modify the selection when dragging. The
// |first_drag_location_| field is used to store where the drag-to-select
// started.
base::RepeatingTimer drag_selection_timer_;
gfx::Point last_drag_location_;
gfx::Point first_drag_location_;
// State variables used to track the last click time and location.
base::TimeTicks last_click_time_;
gfx::Point last_click_root_location_;
// Used to track double and triple clicks. Can take the values 0, 1 and 2
// which specify a single, double and triple click respectively. Alternates
// between a double and triple click for continuous clicks.
size_t aggregated_clicks_ = 0;
// The range selected on a double click.
gfx::Range double_click_word_;
// Weak pointer.
raw_ptr<SelectionControllerDelegate> delegate_;
// Whether the selection clipboard is handled.
bool handles_selection_clipboard_ = false;
};
} // namespace views
#endif // UI_VIEWS_SELECTION_CONTROLLER_H_
|
