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
|
// Copyright 2020 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_BASE_DATA_TRANSFER_POLICY_DATA_TRANSFER_POLICY_CONTROLLER_H_
#define UI_BASE_DATA_TRANSFER_POLICY_DATA_TRANSFER_POLICY_CONTROLLER_H_
#include <optional>
#include <variant>
#include <vector>
#include "base/component_export.h"
#include "base/files/file_path.h"
#include "base/functional/callback.h"
#include "base/functional/callback_forward.h"
#include "base/types/optional_ref.h"
#include "ui/base/data_transfer_policy/data_transfer_endpoint.h"
namespace content {
class RenderFrameHost;
}
namespace ui {
struct FileInfo;
// The DataTransfer policy controller controls transferring data via
// drag-and-drop and clipboard read operations. It allows/disallows transferring
// the data given the source of the data and the destination trying to access
// the data and a set of rules controlling these source and destination.
class COMPONENT_EXPORT(UI_BASE_DATA_TRANSFER_POLICY)
DataTransferPolicyController {
public:
// Returns a pointer to the existing instance of the class.
static DataTransferPolicyController* Get();
// Returns true if an instance exists, without forcing an initialization.
static bool HasInstance();
// Deletes the existing instance of the class if it's already created.
// Indicates that restricting data transfer is no longer required.
static void DeleteInstance();
// Returns true if `data_dst` is allowed to read clipboard data originally
// written by `data_src`. `data_src` may be null if the clipboard data
// originates from source can't be represented by DataTransferEndpoint;
// similarly, `data_dst` may be null if the data is pasted into a destination
// can't be represented by DataTransferEndpoint e.g. Omnibox. `size` may be
// null in some cases such as pasting files.
virtual bool IsClipboardReadAllowed(
base::optional_ref<const DataTransferEndpoint> data_src,
base::optional_ref<const DataTransferEndpoint> data_dst,
std::optional<size_t> size) = 0;
// nullptr can be passed instead of `data_src` or `data_dst`. If clipboard
// data is set to be in warning mode, this function will show a notification
// to the user. If clipboard read is allowed, `callback` will be invoked with
// true. Otherwise `callback` will be invoked with false.
// If the WebContents of `rfh` got destroyed before `callback` is invoked, the
// notification will get closed.
// When pasting files, `pasted_content` contains a vector of the associated
// pasted files. Otherwise, `pasted_content` contains the size of the pasted
// data (text, image, etc...).
virtual void PasteIfAllowed(
base::optional_ref<const DataTransferEndpoint> data_src,
base::optional_ref<const DataTransferEndpoint> data_dst,
std::variant<size_t, std::vector<base::FilePath>> pasted_content,
content::RenderFrameHost* rfh,
base::OnceCallback<void(bool)> paste_cb) = 0;
// nullopt can be passed instead of `data_dst` and `data_src`. If dropping
// files, `filenames` contains the associated file info. If dropping the data
// is not allowed, this function will show a notification to the user. If the
// drop is allowed, `drop_cb` will be run. Otherwise `drop_cb` will be reset.
// `drop_cb` may be run asynchronously after the user comfirms they want to
// drop the data.
virtual void DropIfAllowed(std::optional<DataTransferEndpoint> data_src,
std::optional<DataTransferEndpoint> data_dst,
std::optional<std::vector<FileInfo>> filenames,
base::OnceClosure drop_cb) = 0;
protected:
DataTransferPolicyController();
virtual ~DataTransferPolicyController();
private:
// A singleton of DataTransferPolicyController. Equals nullptr when there's
// not any data transfer restrictions required.
static DataTransferPolicyController* g_data_transfer_policy_controller_;
};
} // namespace ui
#endif // UI_BASE_DATA_TRANSFER_POLICY_DATA_TRANSFER_POLICY_CONTROLLER_H_
|
