summaryrefslogtreecommitdiffstats
path: root/widget/nsBaseClipboard.h
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 19:33:14 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 19:33:14 +0000
commit36d22d82aa202bb199967e9512281e9a53db42c9 (patch)
tree105e8c98ddea1c1e4784a60a5a6410fa416be2de /widget/nsBaseClipboard.h
parentInitial commit. (diff)
downloadfirefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.tar.xz
firefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.zip
Adding upstream version 115.7.0esr.upstream/115.7.0esr
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'widget/nsBaseClipboard.h')
-rw-r--r--widget/nsBaseClipboard.h163
1 files changed, 163 insertions, 0 deletions
diff --git a/widget/nsBaseClipboard.h b/widget/nsBaseClipboard.h
new file mode 100644
index 0000000000..6d9c064b76
--- /dev/null
+++ b/widget/nsBaseClipboard.h
@@ -0,0 +1,163 @@
+/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#ifndef nsBaseClipboard_h__
+#define nsBaseClipboard_h__
+
+#include "mozilla/dom/PContent.h"
+#include "mozilla/Logging.h"
+#include "mozilla/UniquePtr.h"
+#include "nsIClipboard.h"
+#include "nsITransferable.h"
+#include "nsCOMPtr.h"
+
+static mozilla::LazyLogModule sWidgetClipboardLog("WidgetClipboard");
+#define CLIPBOARD_LOG(...) \
+ MOZ_LOG(sWidgetClipboardLog, LogLevel::Debug, (__VA_ARGS__))
+#define CLIPBOARD_LOG_ENABLED() \
+ MOZ_LOG_TEST(sWidgetClipboardLog, LogLevel::Debug)
+
+class nsITransferable;
+class nsIClipboardOwner;
+class nsIWidget;
+
+/**
+ * A helper base class to implement nsIClipboard::SetData/AsyncSetData, so that
+ * all platform can share the same implementation.
+ *
+ * XXX this could be merged into nsBaseClipboard once all platform use
+ * nsBaseClipboard as base clipboard class to share the common code, see bug
+ * 1773707.
+ */
+class ClipboardSetDataHelper : public nsIClipboard {
+ public:
+ NS_DECL_ISUPPORTS
+
+ ClipboardSetDataHelper() = default;
+
+ // nsIClipboard
+ NS_IMETHOD SetData(nsITransferable* aTransferable, nsIClipboardOwner* aOwner,
+ int32_t aWhichClipboard) override;
+ NS_IMETHOD AsyncSetData(int32_t aWhichClipboard,
+ nsIAsyncSetClipboardDataCallback* aCallback,
+ nsIAsyncSetClipboardData** _retval) override final;
+
+ protected:
+ virtual ~ClipboardSetDataHelper();
+
+ // Implement the native clipboard behavior.
+ NS_IMETHOD SetNativeClipboardData(nsITransferable* aTransferable,
+ nsIClipboardOwner* aOwner,
+ int32_t aWhichClipboard) = 0;
+
+ class AsyncSetClipboardData final : public nsIAsyncSetClipboardData {
+ public:
+ NS_DECL_ISUPPORTS
+ NS_DECL_NSIASYNCSETCLIPBOARDDATA
+
+ AsyncSetClipboardData(int32_t aClipboardType,
+ ClipboardSetDataHelper* aClipboard,
+ nsIAsyncSetClipboardDataCallback* aCallback);
+
+ private:
+ virtual ~AsyncSetClipboardData() = default;
+ bool IsValid() const {
+ // If this request is no longer valid, the callback should be notified.
+ MOZ_ASSERT_IF(!mClipboard, !mCallback);
+ return !!mClipboard;
+ }
+ void MaybeNotifyCallback(nsresult aResult);
+
+ // The clipboard type defined in nsIClipboard.
+ int32_t mClipboardType;
+ // It is safe to use a raw pointer as it will be nullified (by calling
+ // NotifyCallback()) once ClipboardSetDataHelper stops tracking us. This is
+ // also used to indicate whether this request is valid.
+ ClipboardSetDataHelper* mClipboard;
+ // mCallback will be nullified once the callback is notified to ensure the
+ // callback is only notified once.
+ nsCOMPtr<nsIAsyncSetClipboardDataCallback> mCallback;
+ };
+
+ private:
+ void RejectPendingAsyncSetDataRequestIfAny(int32_t aClipboardType);
+
+ // Track the pending request for each clipboard type separately. And only need
+ // to track the latest request for each clipboard type as the prior pending
+ // request will be canceled when a new request is made.
+ RefPtr<AsyncSetClipboardData>
+ mPendingWriteRequests[nsIClipboard::kClipboardTypeCount];
+};
+
+/**
+ * A base clipboard class for Windows and Cocoa widget.
+ */
+class nsBaseClipboard : public ClipboardSetDataHelper {
+ public:
+ explicit nsBaseClipboard(
+ const mozilla::dom::ClipboardCapabilities& aClipboardCaps);
+
+ // nsISupports
+ NS_DECL_ISUPPORTS_INHERITED
+
+ // nsIClipboard
+ NS_IMETHOD SetData(nsITransferable* aTransferable, nsIClipboardOwner* anOwner,
+ int32_t aWhichClipboard) override final;
+ NS_IMETHOD GetData(nsITransferable* aTransferable,
+ int32_t aWhichClipboard) override;
+ NS_IMETHOD EmptyClipboard(int32_t aWhichClipboard) override;
+ NS_IMETHOD HasDataMatchingFlavors(const nsTArray<nsCString>& aFlavorList,
+ int32_t aWhichClipboard,
+ bool* _retval) override;
+ NS_IMETHOD IsClipboardTypeSupported(int32_t aWhichClipboard,
+ bool* aRetval) override final;
+ RefPtr<mozilla::GenericPromise> AsyncGetData(
+ nsITransferable* aTransferable, int32_t aWhichClipboard) override;
+ RefPtr<DataFlavorsPromise> AsyncHasDataMatchingFlavors(
+ const nsTArray<nsCString>& aFlavorList, int32_t aWhichClipboard) override;
+
+ protected:
+ virtual ~nsBaseClipboard() = default;
+
+ // Implement the native clipboard behavior.
+ NS_IMETHOD GetNativeClipboardData(nsITransferable* aTransferable,
+ int32_t aWhichClipboard) = 0;
+
+ class ClipboardCache final {
+ public:
+ ~ClipboardCache() {
+ // In order to notify the old clipboard owner.
+ Clear();
+ }
+
+ /**
+ * Clear the cached transferable and notify the original clipboard owner
+ * that it has lost ownership.
+ */
+ void Clear();
+ void Update(nsITransferable* aTransferable,
+ nsIClipboardOwner* aClipboardOwner) {
+ // Clear first to notify the old clipboard owner.
+ Clear();
+ mTransferable = aTransferable;
+ mClipboardOwner = aClipboardOwner;
+ }
+ nsITransferable* GetTransferable() const { return mTransferable; }
+ nsIClipboardOwner* GetClipboardOwner() const { return mClipboardOwner; }
+
+ private:
+ nsCOMPtr<nsITransferable> mTransferable;
+ nsCOMPtr<nsIClipboardOwner> mClipboardOwner;
+ };
+
+ mozilla::UniquePtr<ClipboardCache> mCaches[nsIClipboard::kClipboardTypeCount];
+ bool mEmptyingForSetData = false;
+
+ private:
+ const mozilla::dom::ClipboardCapabilities mClipboardCaps;
+ bool mIgnoreEmptyNotification = false;
+};
+
+#endif // nsBaseClipboard_h__