include/wx/gtk/dataform.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        gtk/dataform.h
   3 // Purpose:     declaration of the wxDataFormat class
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     19.10.99 (extracted from gtk/dataobj.h)
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_GTK_DATAFORM_H
  13 #define _WX_GTK_DATAFORM_H
  14
  15 class WXDLLIMPEXP_CORE wxDataFormat
  16 {
  17 public:
  18     // the clipboard formats under GDK are GdkAtoms
  19     typedef GdkAtom NativeFormat;
  20
  21     wxDataFormat();
  22     wxDataFormat( wxDataFormatId type );
  23     wxDataFormat( NativeFormat format );
  24
  25     // we have to provide all the overloads to allow using strings instead of
  26     // data formats (as a lot of existing code does)
  27     wxDataFormat( const wxString& id ) { InitFromString(id); }
  28     wxDataFormat( const char *id ) { InitFromString(id); }
  29     wxDataFormat( const wchar_t *id ) { InitFromString(id); }
  30     wxDataFormat( const wxCStrData& id ) { InitFromString(id); }
  31
  32     wxDataFormat& operator=(const wxDataFormat& format)
  33         { m_type = format.m_type; m_format = format.m_format; return *this; }
  34     wxDataFormat& operator=(NativeFormat format)
  35         { SetId(format); return *this; }
  36
  37     // comparison (must have both versions)
  38     bool operator==(NativeFormat format) const
  39         { return m_format == (NativeFormat)format; }
  40     bool operator!=(NativeFormat format) const
  41         { return m_format != (NativeFormat)format; }
  42     bool operator==(wxDataFormatId format) const
  43         { return m_type == (wxDataFormatId)format; }
  44     bool operator!=(wxDataFormatId format) const
  45         { return m_type != (wxDataFormatId)format; }
  46
  47     // explicit and implicit conversions to NativeFormat which is one of
  48     // standard data types (implicit conversion is useful for preserving the
  49     // compatibility with old code)
  50     NativeFormat GetFormatId() const { return m_format; }
  51     operator NativeFormat() const { return m_format; }
  52
  53     void SetId( NativeFormat format );
  54
  55     // string ids are used for custom types - this SetId() must be used for
  56     // application-specific formats
  57     wxString GetId() const;
  58     void SetId( const wxString& id );
  59
  60     // implementation
  61     wxDataFormatId GetType() const;
  62     void SetType( wxDataFormatId type );
  63
  64 private:
  65     // common part of ctors from format name
  66     void InitFromString(const wxString& id);
  67
  68     wxDataFormatId   m_type;
  69     NativeFormat     m_format;
  70
  71     void PrepareFormats();
  72 };
  73
  74 #endif // _WX_GTK_DATAFORM_H