X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/06cfab17389f4bbd38560dd86ee39931e979bb1e..465de0be705e52c7f97e9bb6169af9d20a7f72a8:/include/wx/gtk/clipbrd.h?ds=sidebyside diff --git a/include/wx/gtk/clipbrd.h b/include/wx/gtk/clipbrd.h index ace437d5d9..4af988f80c 100644 --- a/include/wx/gtk/clipbrd.h +++ b/include/wx/gtk/clipbrd.h @@ -1,110 +1,133 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: clipboard.h -// Purpose: -// Author: Robert Roebling +// Name: wx/gtk/clipbrd.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 +#include "wx/weakref.h" -#include "wx/defs.h" +class WXDLLIMPEXP_CORE wxClipboard : public wxClipboardBase +{ +public: + // there are several clipboards in X11 (and in GDK) + enum Kind + { + Primary, + Clipboard + }; -#if wxUSE_CLIPBOARD + wxClipboard(); + virtual ~wxClipboard(); -#include "wx/object.h" -#include "wx/list.h" -#include "wx/dataobj.h" -#include "wx/control.h" -#include "wx/module.h" + // open the clipboard before SetData() and GetData() + virtual bool Open(); -//----------------------------------------------------------------------------- -// classes -//----------------------------------------------------------------------------- + // close the clipboard after SetData() and GetData() + virtual void Close(); -class wxClipboard; -class wxClipboardModule; + // query whether the clipboard is opened + virtual bool IsOpened() const; -//----------------------------------------------------------------------------- -// global data -//----------------------------------------------------------------------------- + // set the clipboard data. all other formats will be deleted. + virtual bool SetData( wxDataObject *data ); -extern wxClipboard* wxTheClipboard; + // add to the clipboard data. + virtual bool AddData( wxDataObject *data ); -//----------------------------------------------------------------------------- -// wxClipboard -//----------------------------------------------------------------------------- + // ask if data in correct format is available + virtual bool IsSupported( const wxDataFormat& format ); -class wxClipboard: public wxObject -{ - DECLARE_DYNAMIC_CLASS(wxClipboard) + // ask if data in correct format is available + virtual bool IsSupportedAsync( wxEvtHandler *sink ); -public: - - wxClipboard(); - ~wxClipboard(); - - // open the clipboard before SetData() and GetData() - virtual bool Open(); - - // close the clipboard after SetData() and GetData() - virtual void Close(); - - // can be called several times - virtual bool SetData( wxDataObject *data ); - - // format available on the clipboard ? - // supply ID if private format, the same as wxPrivateDataObject::SetId() - virtual bool IsSupportedFormat( wxDataFormat format, const wxString &id = "" ); - - // fill data with data on the clipboard (if available) - virtual bool GetData( wxDataObject *data ); - - // clears wxTheClipboard and the system's clipboard if possible - virtual void Clear(); - - // implementation - - GdkAtom GetTargetAtom( wxDataFormat format, const wxString &id = "" ); - - bool m_open; - - bool m_ownsClipboard; - bool m_ownsPrimarySelection; - - wxList m_dataObjects; - GtkWidget *m_clipboardWidget; - - bool m_formatSupported; - GdkAtom m_targetRequested; - - wxDataObject *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 - // wxUSE_CLIPBOARD + // implementation from now on + // -------------------------- + + // get our clipboard item (depending on m_usePrimary value) + GdkAtom GTKGetClipboardAtom() const; + + // get the data object currently being requested + wxDataObject *GTKGetDataObject( GdkAtom atom ); + + // 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 for the specific selection + wxDataObject *& Data(Kind kind) + { + return kind == Primary ? m_dataPrimary : m_dataClipboard; + } + + // the data object we're currently using + wxDataObject *& Data() + { + return Data(m_usePrimary ? Primary : Clipboard); + } + + + // 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; + +public: + // async stuff + wxEvtHandlerRef m_sink; +private: + GtkWidget *m_targetsWidgetAsync; // for getting list of supported formats + + DECLARE_DYNAMIC_CLASS(wxClipboard) +}; -#endif - // __GTKCLIPBOARDH__ +#endif // _WX_GTK_CLIPBOARD_H_