X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Ffrontends%2FClipboard.h;h=3381475cbce95123d80cfcd6c2a3c0f02966135a;hb=9a17e559f289845db02bc114fad5190280548e4e;hp=9e831a455eb6048bb8c5daf26d304cce73cfc4e6;hpb=6c300f72a217722652dc27db9108e1050028979c;p=lyx.git

diff --git a/src/frontends/Clipboard.h b/src/frontends/Clipboard.h
index 9e831a455e..3381475cbc 100644
--- a/src/frontends/Clipboard.h
+++ b/src/frontends/Clipboard.h
@@ -28,22 +28,42 @@ public:
 	virtual ~Clipboard() {}
 
 	/**
-	 * Get the window system clipboard contents.
+	 * Get the system clipboard contents. The format is as written in
+	 * .lyx files (may even be an older version than ours if it comes
+	 * from an older LyX).
+	 * Does not convert plain text to LyX if only plain text is available.
 	 * This should be called when the user requests to paste from the
 	 * clipboard.
 	 */
-	virtual docstring const get() const = 0;
+	virtual std::string const getAsLyX() const = 0;
+	/// Get the contents of the window system clipboard in plain text format.
+	virtual docstring const getAsText() const = 0;
 	/**
-	 * Fill the window system clipboard.
+	 * Fill the system clipboard. The format of \p lyx is as written in
+	 * .lyx files, the format of \p text is plain text.
+	 * We put the clipboard contents in LyX format and plain text into
+	 * the system clipboard if supported, so that it is useful for other
+	 * applications as well as other instances of LyX.
 	 * This should be called when the user requests to cut or copy to
 	 * the clipboard.
 	 */
-	virtual void put(docstring const &) = 0;
+	virtual void put(std::string const & lyx, docstring const & text) = 0;
+
+	/// Does the clipboard contain LyX contents?
+	virtual bool hasLyXContents() const = 0;
+	/// state of clipboard.
+	/// \returns true if the system clipboard has been set within LyX
+	/// (document contents, dialogs count as external here).
+	virtual bool isInternal() const = 0;
+	/// Is the clipboard empty?
+	/// \returns true if both the LyX and the plaintext versions of the
+	/// clipboard are empty.
+	virtual bool empty() const = 0;
 };
 
 } // namespace frontend
 
-/// Implementation is in Application.C
+/// Implementation is in Application.cpp
 extern frontend::Clipboard & theClipboard();
 
 } // namespace lyx