include/wx/msw/ole/droptgt.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        ole/droptgt.h
   3 // Purpose:     declaration of the wxDropTarget class
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     06.03.98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef   _WX_OLEDROPTGT_H
  13 #define   _WX_OLEDROPTGT_H
  14
  15 #ifdef __GNUG__
  16 #pragma interface "droptgt.h"
  17 #endif
  18
  19 #if !wxUSE_DRAG_AND_DROP
  20     #error  "You should #define wxUSE_DRAG_AND_DROP to 1 to compile this file!"
  21 #endif  //WX_DRAG_DROP
  22
  23 // ----------------------------------------------------------------------------
  24 // forward declarations
  25 // ----------------------------------------------------------------------------
  26
  27 class  wxIDropTarget;
  28 struct IDataObject;
  29
  30 // ----------------------------------------------------------------------------
  31 // An instance of the class wxDropTarget may be associated with any wxWindow
  32 // derived object via SetDropTarget() function. If this is done, the virtual
  33 // methods of wxDropTarget are called when something is dropped on the window.
  34 //
  35 // Note that wxDropTarget is an abstract base class (ABC) and you should derive
  36 // your own class from it implementing pure virtual function in order to use it
  37 // (all of them, including protected ones which are called by the class itself)
  38 // ----------------------------------------------------------------------------
  39
  40 class WXDLLEXPORT wxDropTarget : public wxDropTargetBase
  41 {
  42 public:
  43     // ctor & dtor
  44     wxDropTarget(wxDataObject *dataObject = NULL);
  45     virtual ~wxDropTarget();
  46
  47     // normally called by wxWindow on window creation/destruction, but might be
  48     // called `manually' as well. Register() returns true on success.
  49     bool Register(WXHWND hwnd);
  50     void Revoke(WXHWND hwnd);
  51
  52     // provide default implementation for base class pure virtuals
  53     virtual bool OnDrop(wxCoord x, wxCoord y);
  54     virtual bool GetData();
  55
  56     // implementation only from now on
  57     // -------------------------------
  58
  59     // do we accept this kind of data?
  60     bool IsAcceptedData(IDataObject *pIDataSource) const;
  61
  62     // give us the data source from IDropTarget::Drop() - this is later used by
  63     // GetData() when it's called from inside OnData()
  64     void SetDataSource(IDataObject *pIDataSource);
  65
  66 private:
  67     // helper used by IsAcceptedData() and GetData()
  68     wxDataFormat GetSupportedFormat(IDataObject *pIDataSource) const;
  69
  70     wxIDropTarget *m_pIDropTarget; // the pointer to our COM interface
  71     IDataObject   *m_pIDataSource; // the pointer to the source data object
  72
  73     DECLARE_NO_COPY_CLASS(wxDropTarget)
  74 };
  75
  76 #endif  //_WX_OLEDROPTGT_H