OSYSTEM: Add API to copy text to clipboard

This has also been implemented for the SDL2 and macOS backends.

1 files changed, 13 insertions, 2 deletions

diff --git a/common/system.h b/common/system.h
index 206c3134c4..a0034ee874 100644
--- a/common/system.h
+++ b/common/system.h
@@ -324,8 +324,8 @@ public:
 		kFeatureDisplayLogFile,
 
 		/**
-		 * The presence of this feature indicates whether the hasTextInClipboard()
-		 * and getTextFromClipboard() calls are supported.
+		 * The presence of this feature indicates whether the hasTextInClipboard(),
+		 * getTextFromClipboard() and setTextInClipboard() calls are supported.
 		 *
 		 * This feature has no associated state.
 		 */
@@ -1336,6 +1336,17 @@ public:
 	virtual Common::String getTextFromClipboard() { return ""; }
 
 	/**
+	 * Set the content of the clipboard to the given string.
+	 *
+	 * The kFeatureClipboardSupport feature flag can be used to
+	 * test whether this call has been implemented by the active
+	 * backend.
+	 *
+	 * @return true if the text was properly set in the clipboard, false otherwise
+	 */
+	virtual bool setTextInClipboard(const Common::String &text) { return false; }
+
+	/**
 	 * Open the given Url in the default browser (if available on the target
 	 * system).
 	 *