/////////////////////////////////////////////////////////////////////////////
-// Name: clipboard.h
-// Purpose:
-// Author: Robert Roebling
+// Name: wx/gtk/clipboard.h
+// Purpose: wxClipboard for wxGTK
+// Author: Robert Roebling, Vadim Zeitlin
// Id: $Id$
// Copyright: (c) 1998 Robert Roebling
-// Licence: wxWindows licence
+// (c) 2007 Vadim Zeitlin
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
+#ifndef _WX_GTK_CLIPBOARD_H_
+#define _WX_GTK_CLIPBOARD_H_
-#ifndef __GTKCLIPBOARDH__
-#define __GTKCLIPBOARDH__
+// ----------------------------------------------------------------------------
+// wxClipboard
+// ----------------------------------------------------------------------------
-#ifdef __GNUG__
-#pragma interface
-#endif
+class WXDLLIMPEXP_CORE wxClipboard : public wxClipboardBase
+{
+public:
+ // there are several clipboards in X11 (and in GDK)
+ enum Kind
+ {
+ Primary,
+ Clipboard
+ };
-#include "wx/defs.h"
-#include "wx/object.h"
-#include "wx/list.h"
-#include "wx/control.h"
-#include "wx/dnd.h" // for wxDataObject
-#include "wx/module.h"
+ wxClipboard();
+ virtual ~wxClipboard();
-//-----------------------------------------------------------------------------
-// classes
-//-----------------------------------------------------------------------------
+ // open the clipboard before SetData() and GetData()
+ virtual bool Open();
-class wxClipboard;
-class wxClipboardModule;
+ // close the clipboard after SetData() and GetData()
+ virtual void Close();
-//-----------------------------------------------------------------------------
-// global data
-//-----------------------------------------------------------------------------
+ // query whether the clipboard is opened
+ virtual bool IsOpened() const;
-extern wxClipboard* wxTheClipboard;
+ // set the clipboard data. all other formats will be deleted.
+ virtual bool SetData( wxDataObject *data );
-//-----------------------------------------------------------------------------
-// wxClipboard
-//-----------------------------------------------------------------------------
+ // add to the clipboard data.
+ virtual bool AddData( wxDataObject *data );
-class wxClipboard: public wxObject
-{
- DECLARE_DYNAMIC_CLASS(wxClipboard)
+ // ask if data in correct format is available
+ virtual bool IsSupported( const wxDataFormat& format );
-public:
-
- wxClipboard();
- ~wxClipboard();
-
- virtual void SetData( wxDataObject *data );
-
- virtual bool IsSupportedFormat( wxDataFormat format );
- virtual bool ObtainData( wxDataFormat format );
-
- // call these after ObtainData()
- virtual size_t GetDataSize() const;
- virtual void GetDataHere( void *data ) const;
-
- // clears wxTheClipboard and the system's clipboard if possible
- virtual void Clear();
-
- // implementation
-
- wxDataObject *m_data;
- char *m_sentString,
- *m_receivedString;
- void *m_receivedTargets;
- GtkWidget *m_clipboardWidget;
-
- bool m_formatSupported;
- GdkAtom m_targetRequested;
-
- size_t m_receivedSize;
- char *m_receivedData;
-};
+ // fill data with data on the clipboard (if available)
+ virtual bool GetData( wxDataObject& data );
-//-----------------------------------------------------------------------------
-// wxClipboardModule
-//-----------------------------------------------------------------------------
+ // clears wxTheClipboard and the system's clipboard if possible
+ virtual void Clear();
-class wxClipboardModule: public wxModule
-{
- DECLARE_DYNAMIC_CLASS(wxClipboardModule)
-
-public:
- wxClipboardModule() {}
- bool OnInit();
- void OnExit();
-};
-#endif
- // __GTKCLIPBOARDH__
+ // implementation from now on
+ // --------------------------
+
+ // get our clipboard item (depending on m_usePrimary value)
+ GdkAtom GTKGetClipboardAtom() const;
+
+ // get the data object currently being used
+ wxDataObject *GTKGetDataObject() { return Data(); }
+
+ // clear the data for the given clipboard kind
+ void GTKClearData(Kind kind);
+
+ // called when selection data is received
+ void GTKOnSelectionReceived(const GtkSelectionData& sel);
+
+ // called when available target information is received
+ bool GTKOnTargetReceived(const wxDataFormat& format);
+
+private:
+ // the data object we're currently using
+ wxDataObject *& Data()
+ {
+ return m_usePrimary ? m_dataPrimary : m_dataClipboard;
+ }
+
+ // set or unset selection ownership
+ bool SetSelectionOwner(bool set = true);
+
+ // add atom to the list of supported targets
+ void AddSupportedTarget(GdkAtom atom);
+
+ // check if the given format is supported
+ bool DoIsSupported(const wxDataFormat& format);
+
+
+ // both of these pointers can be non-NULL simultaneously but we only use
+ // one of them at any moment depending on m_usePrimary value, use Data()
+ // (from inside) or GTKGetDataObject() (from outside) accessors
+ wxDataObject *m_dataPrimary,
+ *m_dataClipboard;
+
+ // this is used to temporarily hold the object passed to our GetData() so
+ // that GTK callbacks could access it
+ wxDataObject *m_receivedData;
+
+ // used to pass information about the format we need from DoIsSupported()
+ // to GTKOnTargetReceived()
+ GdkAtom m_targetRequested;
+
+ GtkWidget *m_clipboardWidget; // for getting and offering data
+ GtkWidget *m_targetsWidget; // for getting list of supported formats
+
+ bool m_open;
+ bool m_formatSupported;
+
+
+ DECLARE_DYNAMIC_CLASS(wxClipboard)
+};
+
+#endif // _WX_GTK_CLIPBOARD_H_
projects / wxWidgets.git / blobdiff