include/wx/msw/ole/dropsrc.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        ole/dropsrc.h
   3 // Purpose:     declaration of the wxDropSource 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_OLEDROPSRC_H
  13 #define   _WX_OLEDROPSRC_H
  14
  15 #ifdef __GNUG__
  16     #pragma interface
  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 wxIDropSource;
  28 class WXDLLEXPORT wxDataObject;
  29 class WXDLLEXPORT wxWindow;
  30
  31 // ----------------------------------------------------------------------------
  32 // wxDropSource is used to start the drag-&-drop operation on associated
  33 // wxDataObject object. It's responsible for giving UI feedback while dragging.
  34 // ----------------------------------------------------------------------------
  35
  36 class WXDLLEXPORT wxDropSource : public wxDropSourceBase
  37 {
  38 public:
  39     // ctors: if you use default ctor you must call SetData() later!
  40     //
  41     // NB: the "wxWindow *win" parameter is unused and is here only for wxGTK
  42     //     compatibility, as well as both icon parameters
  43     wxDropSource(wxWindow *win = NULL,
  44                  const wxCursor &cursorCopy = wxNullCursor,
  45                  const wxCursor &cursorMove = wxNullCursor,
  46                  const wxCursor &cursorStop = wxNullCursor);
  47     wxDropSource(wxDataObject& data,
  48                  wxWindow *win = NULL,
  49                  const wxCursor &cursorCopy = wxNullCursor,
  50                  const wxCursor &cursorMove = wxNullCursor,
  51                  const wxCursor &cursorStop = wxNullCursor);
  52
  53     virtual ~wxDropSource();
  54
  55     // do it (call this in response to a mouse button press, for example)
  56     // params: if bAllowMove is false, data can be only copied
  57     virtual wxDragResult DoDragDrop(bool bAllowMove = FALSE);
  58
  59     // overridable: you may give some custom UI feedback during d&d operation
  60     // in this function (it's called on each mouse move, so it shouldn't be
  61     // too slow). Just return false if you want default feedback.
  62     virtual bool GiveFeedback(wxDragResult effect);
  63
  64 protected:
  65     void Init();
  66
  67 private:
  68     wxIDropSource *m_pIDropSource;  // the pointer to COM interface
  69 };
  70
  71 #endif  //_WX_OLEDROPSRC_H