X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/9e2896e5c8944c5f5227fa080e1b781c4a6f2600..3f7bc32b539472f7aa577ffa140e287b0dc4c90d:/include/wx/clipbrd.h diff --git a/include/wx/clipbrd.h b/include/wx/clipbrd.h index ad50734933..e7ab30b41e 100644 --- a/include/wx/clipbrd.h +++ b/include/wx/clipbrd.h @@ -12,10 +12,15 @@ #ifndef _WX_CLIPBRD_H_BASE_ #define _WX_CLIPBRD_H_BASE_ +#ifdef __GNUG__ + #pragma interface "clipboardbase.h" +#endif + #include "wx/defs.h" #if wxUSE_CLIPBOARD + #include "wx/object.h" #include "wx/wxchar.h" @@ -33,30 +38,35 @@ class WXDLLEXPORT wxDataObject; class WXDLLEXPORT wxClipboardBase : public wxObject { public: + wxClipboardBase(); + // open the clipboard before Add/SetData() and GetData() - virtual bool Open(); + virtual bool Open() = 0; // close the clipboard after Add/SetData() and GetData() - virtual void Close(); + virtual void Close() = 0; + + // query whether the clipboard is opened + virtual bool IsOpened() const = 0; // add to the clipboard data // // NB: the clipboard owns the pointer and will delete it, so data must be // allocated on the heap - virtual bool AddData( wxDataObject *data ); + virtual bool AddData( wxDataObject *data ) = 0; // set the clipboard data, this is the same as Clear() followed by // AddData() - virtual bool SetData( wxDataObject *data ); + virtual bool SetData( wxDataObject *data ) = 0; // ask if data in correct format is available - virtual bool IsSupported( const wxDataFormat& format ); + virtual bool IsSupported( const wxDataFormat& format ) = 0; // fill data with data on the clipboard (if available) - virtual bool GetData( wxDataObject& data ); - + virtual bool GetData( wxDataObject& data ) = 0; + // clears wxTheClipboard and the system's clipboard if possible - virtual void Clear(); + virtual void Clear() = 0; // flushes the clipboard: this means that the data which is currently on // clipboard will stay available even after the application exits (possibly @@ -66,15 +76,6 @@ public: // X11 has two clipboards which get selected by this call. Empty on MSW. virtual void UsePrimarySelection( bool WXUNUSED(primary) = FALSE ) { } -#ifdef WXWIN_COMPATIBILITY_2 - // deprecated version - bool GetData(wxDataObject *data) - { - wxCHECK_MSG(data, FALSE, wxT("NULL pointer in wxClipboard")); - - return GetData(*data); - } -#endif // WXWIN_COMPATIBILITY_2 }; // ---------------------------------------------------------------------------- @@ -105,22 +106,33 @@ public: WXDLLEXPORT_DATA(extern wxClipboard *) wxTheClipboard; // ---------------------------------------------------------------------------- -// wxClipboardModule: module responsible for initializing the global clipboard -// object -// -// NB: IMPLEMENT_DYNAMIC_CLASS() for it is in common/appcmn.cpp +// helpful class for opening the clipboard and automatically closing it // ---------------------------------------------------------------------------- -class wxClipboardModule : public wxModule +class WXDLLEXPORT wxClipboardLocker { public: - bool OnInit() - { wxTheClipboard = new wxClipboard; return TRUE; } - void OnExit() - { delete wxTheClipboard; wxTheClipboard = (wxClipboard *)NULL; } + wxClipboardLocker(wxClipboard *clipboard = (wxClipboard *)NULL) + { + m_clipboard = clipboard ? clipboard : wxTheClipboard; + if ( m_clipboard ) + { + m_clipboard->Open(); + } + } + + bool operator!() const { return !m_clipboard->IsOpened(); } + + ~wxClipboardLocker() + { + if ( m_clipboard ) + { + m_clipboard->Close(); + } + } private: - DECLARE_DYNAMIC_CLASS(wxClipboardModule) + wxClipboard *m_clipboard; }; #endif // wxUSE_CLIPBOARD