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
136
137
138
139
140
141
|
// Copyright 2014 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_CLIPBOARD_CLIPBOARD_ANDROID_H_
#define UI_BASE_CLIPBOARD_CLIPBOARD_ANDROID_H_
#include <jni.h>
#include <stddef.h>
#include <stdint.h>
#include <string_view>
#include "base/android/scoped_java_ref.h"
#include "base/component_export.h"
#include "base/functional/callback_forward.h"
#include "base/time/time.h"
#include "ui/base/clipboard/clipboard.h"
namespace ui {
// Documentation on the underlying Android API this ultimately abstracts is
// available at https://developer.android.com/guide/topics/text/copy-paste.
class ClipboardAndroid : public Clipboard {
public:
// Callback called whenever the clipboard is modified. The parameter
// represents the time of the modification.
using ModifiedCallback = base::RepeatingCallback<void(base::Time)>;
ClipboardAndroid(const ClipboardAndroid&) = delete;
ClipboardAndroid& operator=(const ClipboardAndroid&) = delete;
// Called by Java when the Java Clipboard is notified that the clipboard has
// changed.
void OnPrimaryClipChanged(JNIEnv* env,
const base::android::JavaParamRef<jobject>& obj);
// Called by Java when the Java Clipboard is notified that the window focus
// has changed. Since Chrome will not receive OnPrimaryClipChanged call from
// Android if Chrome is in background,Clipboard handler needs to check the
// content of clipboard didn't change, when Chrome is back in foreground.
void OnPrimaryClipTimestampInvalidated(
JNIEnv* env,
const base::android::JavaParamRef<jobject>& obj,
const jlong j_timestamp_ms);
// Called by Java side.
int64_t GetLastModifiedTimeToJavaTime(JNIEnv* env);
// Sets the callback called whenever the clipboard is modified.
COMPONENT_EXPORT(UI_BASE_CLIPBOARD)
void SetModifiedCallback(ModifiedCallback cb);
// Sets the last modified time without calling the above callback.
COMPONENT_EXPORT(UI_BASE_CLIPBOARD)
void SetLastModifiedTimeWithoutRunningCallback(base::Time time);
private:
friend class Clipboard;
ClipboardAndroid();
~ClipboardAndroid() override;
// Clipboard overrides:
void OnPreShutdown() override;
std::optional<DataTransferEndpoint> GetSource(
ClipboardBuffer buffer) const override;
const ClipboardSequenceNumberToken& GetSequenceNumber(
ClipboardBuffer buffer) const override;
std::vector<std::u16string> GetStandardFormats(
ClipboardBuffer buffer,
const DataTransferEndpoint* data_dst) const override;
bool IsFormatAvailable(const ClipboardFormatType& format,
ClipboardBuffer buffer,
const DataTransferEndpoint* data_dst) const override;
void Clear(ClipboardBuffer buffer) override;
void ReadAvailableTypes(ClipboardBuffer buffer,
const DataTransferEndpoint* data_dst,
std::vector<std::u16string>* types) const override;
void ReadText(ClipboardBuffer buffer,
const DataTransferEndpoint* data_dst,
std::u16string* result) const override;
void ReadAsciiText(ClipboardBuffer buffer,
const DataTransferEndpoint* data_dst,
std::string* result) const override;
void ReadHTML(ClipboardBuffer buffer,
const DataTransferEndpoint* data_dst,
std::u16string* markup,
std::string* src_url,
uint32_t* fragment_start,
uint32_t* fragment_end) const override;
void ReadSvg(ClipboardBuffer buffer,
const DataTransferEndpoint* data_dst,
std::u16string* result) const override;
void ReadRTF(ClipboardBuffer buffer,
const DataTransferEndpoint* data_dst,
std::string* result) const override;
void ReadPng(ClipboardBuffer buffer,
const DataTransferEndpoint* data_dst,
ReadPngCallback callback) const override;
void ReadDataTransferCustomData(ClipboardBuffer buffer,
const std::u16string& type,
const DataTransferEndpoint* data_dst,
std::u16string* result) const override;
void ReadFilenames(ClipboardBuffer buffer,
const DataTransferEndpoint* data_dst,
std::vector<ui::FileInfo>* result) const override;
void ReadBookmark(const DataTransferEndpoint* data_dst,
std::u16string* title,
std::string* url) const override;
void ReadData(const ClipboardFormatType& format,
const DataTransferEndpoint* data_dst,
std::string* result) const override;
base::Time GetLastModifiedTime() const override;
void ClearLastModifiedTime() override;
void WritePortableAndPlatformRepresentations(
ClipboardBuffer buffer,
const ObjectMap& objects,
const std::vector<RawData>& raw_objects,
std::vector<Clipboard::PlatformRepresentation> platform_representations,
std::unique_ptr<DataTransferEndpoint> data_src,
uint32_t privacy_types) override;
void WriteText(std::string_view text) override;
void WriteHTML(std::string_view markup,
std::optional<std::string_view> source_url) override;
void WriteSvg(std::string_view markup) override;
void WriteRTF(std::string_view rtf) override;
void WriteFilenames(std::vector<ui::FileInfo> filenames) override;
void WriteBookmark(std::string_view title, std::string_view url) override;
void WriteWebSmartPaste() override;
void WriteBitmap(const SkBitmap& bitmap) override;
void WriteData(const ClipboardFormatType& format,
base::span<const uint8_t> data) override;
void WriteClipboardHistory() override;
void WriteUploadCloudClipboard() override;
void WriteConfidentialDataForPassword() override;
};
} // namespace ui
#endif // UI_BASE_CLIPBOARD_CLIPBOARD_ANDROID_H_
|
