// Name: clipbrd.h
// Purpose: Clipboard functionality.
// Note: this functionality is under review, and
-// is derived from wxWindows 1.xx code. Please contact
-// the wxWindows developers for further information.
+// is derived from wxWidgets 1.xx code. Please contact
+// the wxWidgets developers for further information.
// Author: David Webster
// Modified by:
// Created: 10/13/99
#ifndef _WX_CLIPBRD_H_
#define _WX_CLIPBRD_H_
-#include "wx/defs.h"
-#include "wx/setup.h"
-
#if wxUSE_CLIPBOARD
#include "wx/list.h"
//-----------------------------------------------------------------------------
class WXDLLEXPORT wxDataObject;
-class WXDLLEXPORT wxClipboard : public wxObject
+class WXDLLEXPORT wxClipboard : public wxClipboardBase
{
DECLARE_DYNAMIC_CLASS(wxClipboard)
public:
wxClipboard();
- ~wxClipboard();
+ virtual ~wxClipboard();
// open the clipboard before SetData() and GetData()
virtual bool Open();
// close the clipboard after SetData() and GetData()
virtual void Close();
+ // query whether the clipboard is opened
+ virtual bool IsOpened() const;
+
// set the clipboard data. all other formats will be deleted.
virtual bool SetData( wxDataObject *data );
virtual bool AddData( wxDataObject *data );
// ask if data in correct format is available
- virtual bool IsSupported( wxDataFormat format );
+ virtual bool IsSupported( const wxDataFormat& format );
// fill data with data on the clipboard (if available)
- virtual bool GetData( wxDataObject *data );
+ virtual bool GetData( wxDataObject& data );
// clears wxTheClipboard and the system's clipboard if possible
virtual void Clear();
- /// X11 has two clipboards which get selected by this call. Empty on MSW.
- void UsePrimarySelection( bool WXUNUSED(primary) = FALSE ) { }
-
-};
-
-// The global clipboard object
-WXDLLEXPORT_DATA(extern wxClipboard*) wxTheClipboard;
-
-//-----------------------------------------------------------------------------
-// wxClipboardModule: module responsible for initializing the global clipboard
-// object
-//-----------------------------------------------------------------------------
-
-class wxClipboardModule : public wxModule
-{
- DECLARE_DYNAMIC_CLASS(wxClipboardModule)
-
-public:
- wxClipboardModule() { }
+ // flushes the clipboard: this means that the data which is currently on
+ // clipboard will stay available even after the application exits (possibly
+ // eating memory), otherwise the clipboard will be emptied on exit
+ virtual bool Flush();
- bool OnInit();
- void OnExit();
+private:
+ bool m_clearOnExit;
};
#endif // wxUSE_CLIPBOARD
-#endif
- // _WX_CLIPBRD_H_
+#endif // _WX_CLIPBRD_H_