include/wx/generic/dragimgg.h

   1 //////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/generic/dragimgg.h
   3 // Purpose:     wxDragImage class: a kind of a cursor, that can cope
   4 //              with more sophisticated images
   5 // Author:      Julian Smart
   6 // Modified by:
   7 // Created:     29/2/2000
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) Julian Smart
  10 // Licence:     wxWindows licence
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13 #ifndef _WX_DRAGIMGG_H_
  14 #define _WX_DRAGIMGG_H_
  15
  16 #include "wx/bitmap.h"
  17 #include "wx/icon.h"
  18 #include "wx/cursor.h"
  19 #include "wx/treectrl.h"
  20 #include "wx/listctrl.h"
  21 #include "wx/log.h"
  22 #include "wx/overlay.h"
  23
  24 /*
  25   To use this class, create a wxDragImage when you start dragging, for example:
  26
  27   void MyTreeCtrl::OnBeginDrag(wxTreeEvent& event)
  28   {
  29 #ifdef __WXMSW__
  30     ::UpdateWindow((HWND) GetHWND()); // We need to implement this in wxWidgets
  31 #endif
  32
  33     CaptureMouse();
  34
  35     m_dragImage = new wxDragImage(* this, itemId);
  36     m_dragImage->BeginDrag(wxPoint(0, 0), this);
  37     m_dragImage->Move(pt, this);
  38     m_dragImage->Show(this);
  39     ...
  40   }
  41
  42   In your OnMouseMove function, hide the image, do any display updating required,
  43   then move and show the image again:
  44
  45   void MyTreeCtrl::OnMouseMove(wxMouseEvent& event)
  46   {
  47     if (m_dragMode == MY_TREE_DRAG_NONE)
  48     {
  49         event.Skip();
  50         return;
  51     }
  52
  53     // Prevent screen corruption by hiding the image
  54     if (m_dragImage)
  55         m_dragImage->Hide(this);
  56
  57     // Do some updating of the window, such as highlighting the drop target
  58     ...
  59
  60 #ifdef __WXMSW__
  61     if (updateWindow)
  62         ::UpdateWindow((HWND) GetHWND());
  63 #endif
  64
  65     // Move and show the image again
  66     m_dragImage->Move(event.GetPosition(), this);
  67     m_dragImage->Show(this);
  68  }
  69
  70  Eventually we end the drag and delete the drag image.
  71
  72  void MyTreeCtrl::OnLeftUp(wxMouseEvent& event)
  73  {
  74     ...
  75
  76     // End the drag and delete the drag image
  77     if (m_dragImage)
  78     {
  79         m_dragImage->EndDrag(this);
  80         delete m_dragImage;
  81         m_dragImage = NULL;
  82     }
  83     ReleaseMouse();
  84  }
  85 */
  86
  87 /*
  88  * wxGenericDragImage
  89  */
  90
  91 class WXDLLEXPORT wxGenericDragImage: public wxObject
  92 {
  93 public:
  94
  95     // Ctors & dtor
  96     ////////////////////////////////////////////////////////////////////////////
  97
  98     wxGenericDragImage(const wxCursor& cursor = wxNullCursor)
  99     {
 100         Init();
 101         Create(cursor);
 102     }
 103
 104     wxGenericDragImage(const wxBitmap& image, const wxCursor& cursor = wxNullCursor)
 105     {
 106         Init();
 107
 108         Create(image, cursor);
 109     }
 110
 111     wxGenericDragImage(const wxIcon& image, const wxCursor& cursor = wxNullCursor)
 112     {
 113         Init();
 114
 115         Create(image, cursor);
 116     }
 117
 118     wxGenericDragImage(const wxString& str, const wxCursor& cursor = wxNullCursor)
 119     {
 120         Init();
 121
 122         Create(str, cursor);
 123     }
 124
 125 #if WXWIN_COMPATIBILITY_2_6
 126     // don't use in new code, use versions without hot spot parameter
 127     wxDEPRECATED( wxGenericDragImage(const wxCursor& cursor, const wxPoint& cursorHotspot) );
 128     wxDEPRECATED( wxGenericDragImage(const wxBitmap& image, const wxCursor& cursor, const wxPoint& cursorHotspot) );
 129     wxDEPRECATED( wxGenericDragImage(const wxIcon& image, const wxCursor& cursor, const wxPoint& cursorHotspot) );
 130     wxDEPRECATED( wxGenericDragImage(const wxString& str, const wxCursor& cursor, const wxPoint& cursorHotspot) );
 131     wxDEPRECATED( bool Create(const wxCursor& cursor, const wxPoint& cursorHotspot) );
 132     wxDEPRECATED( bool Create(const wxBitmap& image, const wxCursor& cursor, const wxPoint& cursorHotspot) );
 133     wxDEPRECATED( bool Create(const wxIcon& image, const wxCursor& cursor, const wxPoint& cursorHotspot) );
 134     wxDEPRECATED( bool Create(const wxString& str, const wxCursor& cursor, const wxPoint& cursorHotspot) );
 135 #endif // WXWIN_COMPATIBILITY_2_6
 136
 137 #if wxUSE_TREECTRL
 138     wxGenericDragImage(const wxTreeCtrl& treeCtrl, wxTreeItemId& id)
 139     {
 140         Init();
 141
 142         Create(treeCtrl, id);
 143     }
 144 #endif
 145
 146 #if wxUSE_LISTCTRL
 147     wxGenericDragImage(const wxListCtrl& listCtrl, long id)
 148     {
 149         Init();
 150
 151         Create(listCtrl, id);
 152     }
 153 #endif
 154
 155     virtual ~wxGenericDragImage();
 156
 157     // Attributes
 158     ////////////////////////////////////////////////////////////////////////////
 159
 160     // For efficiency, tell wxGenericDragImage to use a bitmap that's already
 161     // created (e.g. from last drag)
 162     void SetBackingBitmap(wxBitmap* bitmap) {
 163 #ifndef wxHAS_NATIVE_OVERLAY
 164         m_pBackingBitmap = bitmap;
 165 #endif
 166     }
 167
 168     // Operations
 169     ////////////////////////////////////////////////////////////////////////////
 170
 171     // Create a drag image with a virtual image (need to override DoDrawImage, GetImageRect)
 172     bool Create(const wxCursor& cursor = wxNullCursor);
 173
 174     // Create a drag image from a bitmap and optional cursor
 175     bool Create(const wxBitmap& image, const wxCursor& cursor = wxNullCursor);
 176
 177     // Create a drag image from an icon and optional cursor
 178     bool Create(const wxIcon& image, const wxCursor& cursor = wxNullCursor);
 179
 180     // Create a drag image from a string and optional cursor
 181     bool Create(const wxString& str, const wxCursor& cursor = wxNullCursor);
 182
 183 #if wxUSE_TREECTRL
 184     // Create a drag image for the given tree control item
 185     bool Create(const wxTreeCtrl& treeCtrl, wxTreeItemId& id);
 186 #endif
 187
 188 #if wxUSE_LISTCTRL
 189     // Create a drag image for the given list control item
 190     bool Create(const wxListCtrl& listCtrl, long id);
 191 #endif
 192
 193     // Begin drag. hotspot is the location of the drag position relative to the upper-left
 194     // corner of the image.
 195     bool BeginDrag(const wxPoint& hotspot, wxWindow* window, bool fullScreen = false, wxRect* rect = (wxRect*) NULL);
 196
 197     // Begin drag. hotspot is the location of the drag position relative to the upper-left
 198     // corner of the image. This is full screen only. fullScreenRect gives the
 199     // position of the window on the screen, to restrict the drag to.
 200     bool BeginDrag(const wxPoint& hotspot, wxWindow* window, wxWindow* fullScreenRect);
 201
 202     // End drag
 203     bool EndDrag();
 204
 205     // Move the image: call from OnMouseMove. Pt is in window client coordinates if window
 206     // is non-NULL, or in screen coordinates if NULL.
 207     bool Move(const wxPoint& pt);
 208
 209     // Show the image
 210     bool Show();
 211
 212     // Hide the image
 213     bool Hide();
 214
 215     // Implementation
 216     ////////////////////////////////////////////////////////////////////////////
 217
 218     void Init();
 219
 220     // Override this if you are using a virtual image (drawing your own image)
 221     virtual wxRect GetImageRect(const wxPoint& pos) const;
 222
 223     // Override this if you are using a virtual image (drawing your own image)
 224     virtual bool DoDrawImage(wxDC& dc, const wxPoint& pos) const;
 225
 226     // Override this if you wish to draw the window contents to the backing bitmap
 227     // yourself. This can be desirable if you wish to avoid flicker by not having to
 228     // redraw the window itself before dragging in order to be graphic-minus-dragged-objects.
 229     // Instead, paint the drag image's backing bitmap to be correct, and leave the window
 230     // to be updated only when dragging the objects away (thus giving a smoother appearance).
 231     virtual bool UpdateBackingFromWindow(wxDC& windowDC, wxMemoryDC& destDC,
 232                                          const wxRect& sourceRect, const wxRect& destRect) const;
 233
 234     // Erase and redraw simultaneously if possible
 235     virtual bool RedrawImage(const wxPoint& oldPos, const wxPoint& newPos, bool eraseOld, bool drawNew);
 236
 237 protected:
 238     wxBitmap        m_bitmap;
 239     wxIcon          m_icon;
 240     wxCursor        m_cursor;
 241     wxCursor        m_oldCursor;
 242 //    wxPoint         m_hotspot;
 243     wxPoint         m_offset; // The hostpot value passed to BeginDrag
 244     wxPoint         m_position;
 245     bool            m_isDirty;
 246     bool            m_isShown;
 247     wxWindow*       m_window;
 248     wxDC*           m_windowDC;
 249
 250 #ifdef wxHAS_NATIVE_OVERLAY
 251     wxOverlay       m_overlay;
 252     wxDCOverlay*     m_dcOverlay;
 253 #else
 254     // Stores the window contents while we're dragging the image around
 255     wxBitmap        m_backingBitmap;
 256     wxBitmap*       m_pBackingBitmap; // Pointer to existing backing bitmap
 257                                       // (pass to wxGenericDragImage as an efficiency measure)
 258     // A temporary bitmap for repairing/redrawing
 259     wxBitmap        m_repairBitmap;
 260 #endif // !wxHAS_NATIVE_OVERLAY
 261
 262     wxRect          m_boundingRect;
 263     bool            m_fullScreen;
 264
 265 private:
 266     DECLARE_DYNAMIC_CLASS(wxGenericDragImage)
 267     DECLARE_NO_COPY_CLASS(wxGenericDragImage)
 268 };
 269
 270 #endif
 271     // _WX_DRAGIMGG_H_