1999-04-08 15:36:00 -04:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
2000-02-14 19:05:36 -05:00
|
|
|
// Name: wx/msw/dragimag.h
|
1999-04-08 15:36:00 -04:00
|
|
|
// Purpose: wxDragImage class: a kind of a cursor, that can cope
|
|
|
|
// with more sophisticated images
|
|
|
|
// Author: Julian Smart
|
|
|
|
// Modified by:
|
|
|
|
// Created: 08/04/99
|
|
|
|
// RCS-ID: $Id$
|
|
|
|
// Copyright: (c) Julian Smart
|
2004-05-23 16:53:33 -04:00
|
|
|
// Licence: wxWindows licence
|
1999-04-08 15:36:00 -04:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
|
|
#ifndef _WX_DRAGIMAG_H_
|
|
|
|
#define _WX_DRAGIMAG_H_
|
|
|
|
|
|
|
|
#include "wx/bitmap.h"
|
|
|
|
#include "wx/icon.h"
|
|
|
|
#include "wx/cursor.h"
|
|
|
|
#include "wx/treectrl.h"
|
|
|
|
#include "wx/listctrl.h"
|
|
|
|
|
2001-04-10 17:01:40 -04:00
|
|
|
// If 1, use a simple wxCursor instead of ImageList_SetDragCursorImage
|
|
|
|
#define wxUSE_SIMPLER_DRAGIMAGE 0
|
2001-04-10 09:44:03 -04:00
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
/*
|
|
|
|
To use this class, create a wxDragImage when you start dragging, for example:
|
|
|
|
|
|
|
|
void MyTreeCtrl::OnBeginDrag(wxTreeEvent& event)
|
|
|
|
{
|
|
|
|
#ifdef __WXMSW__
|
2004-05-23 10:56:36 -04:00
|
|
|
::UpdateWindow((HWND) GetHWND()); // We need to implement this in wxWidgets
|
1999-04-08 15:36:00 -04:00
|
|
|
#endif
|
|
|
|
|
|
|
|
CaptureMouse();
|
|
|
|
|
|
|
|
m_dragImage = new wxDragImage(* this, itemId);
|
|
|
|
m_dragImage->BeginDrag(wxPoint(0, 0), this);
|
|
|
|
m_dragImage->Move(pt, this);
|
|
|
|
m_dragImage->Show(this);
|
|
|
|
...
|
|
|
|
}
|
|
|
|
|
|
|
|
In your OnMouseMove function, hide the image, do any display updating required,
|
|
|
|
then move and show the image again:
|
|
|
|
|
|
|
|
void MyTreeCtrl::OnMouseMove(wxMouseEvent& event)
|
|
|
|
{
|
|
|
|
if (m_dragMode == MY_TREE_DRAG_NONE)
|
|
|
|
{
|
|
|
|
event.Skip();
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Prevent screen corruption by hiding the image
|
|
|
|
if (m_dragImage)
|
|
|
|
m_dragImage->Hide(this);
|
|
|
|
|
|
|
|
// Do some updating of the window, such as highlighting the drop target
|
|
|
|
...
|
|
|
|
|
|
|
|
#ifdef __WXMSW__
|
|
|
|
if (updateWindow)
|
|
|
|
::UpdateWindow((HWND) GetHWND());
|
|
|
|
#endif
|
|
|
|
|
|
|
|
// Move and show the image again
|
|
|
|
m_dragImage->Move(event.GetPosition(), this);
|
|
|
|
m_dragImage->Show(this);
|
|
|
|
}
|
|
|
|
|
|
|
|
Eventually we end the drag and delete the drag image.
|
|
|
|
|
|
|
|
void MyTreeCtrl::OnLeftUp(wxMouseEvent& event)
|
|
|
|
{
|
|
|
|
...
|
|
|
|
|
|
|
|
// End the drag and delete the drag image
|
|
|
|
if (m_dragImage)
|
|
|
|
{
|
|
|
|
m_dragImage->EndDrag(this);
|
|
|
|
delete m_dragImage;
|
|
|
|
m_dragImage = NULL;
|
|
|
|
}
|
|
|
|
ReleaseMouse();
|
|
|
|
}
|
|
|
|
*/
|
|
|
|
|
|
|
|
/*
|
|
|
|
Notes for Unix version:
|
|
|
|
Can we simply use cursors instead, creating a cursor dynamically, setting it into the window
|
|
|
|
in BeginDrag, and restoring the old cursor in EndDrag?
|
|
|
|
For a really bog-standard implementation, we could simply use a normal dragging cursor
|
|
|
|
and ignore the image.
|
|
|
|
*/
|
|
|
|
|
|
|
|
/*
|
|
|
|
* wxDragImage
|
|
|
|
*/
|
|
|
|
|
|
|
|
class WXDLLEXPORT wxDragImage: public wxObject
|
|
|
|
{
|
|
|
|
public:
|
2000-02-14 19:05:36 -05:00
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
// Ctors & dtor
|
|
|
|
////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
|
|
wxDragImage();
|
2001-04-10 17:01:40 -04:00
|
|
|
wxDragImage(const wxBitmap& image, const wxCursor& cursor = wxNullCursor)
|
|
|
|
{
|
|
|
|
Init();
|
|
|
|
|
|
|
|
Create(image, cursor);
|
|
|
|
}
|
|
|
|
|
|
|
|
// Deprecated form of the above
|
|
|
|
wxDragImage(const wxBitmap& image, const wxCursor& cursor, const wxPoint& cursorHotspot)
|
1999-04-08 15:36:00 -04:00
|
|
|
{
|
2000-03-01 06:05:49 -05:00
|
|
|
Init();
|
|
|
|
|
2001-04-10 09:44:03 -04:00
|
|
|
Create(image, cursor, cursorHotspot);
|
1999-04-08 15:36:00 -04:00
|
|
|
}
|
2001-04-10 17:01:40 -04:00
|
|
|
|
|
|
|
wxDragImage(const wxIcon& image, const wxCursor& cursor = wxNullCursor)
|
|
|
|
{
|
|
|
|
Init();
|
|
|
|
|
|
|
|
Create(image, cursor);
|
|
|
|
}
|
|
|
|
|
|
|
|
// Deprecated form of the above
|
|
|
|
wxDragImage(const wxIcon& image, const wxCursor& cursor, const wxPoint& cursorHotspot)
|
1999-04-08 15:36:00 -04:00
|
|
|
{
|
2000-03-01 06:05:49 -05:00
|
|
|
Init();
|
|
|
|
|
2001-04-10 09:44:03 -04:00
|
|
|
Create(image, cursor, cursorHotspot);
|
1999-04-08 15:36:00 -04:00
|
|
|
}
|
2001-04-10 17:01:40 -04:00
|
|
|
|
|
|
|
wxDragImage(const wxString& str, const wxCursor& cursor = wxNullCursor)
|
|
|
|
{
|
|
|
|
Init();
|
|
|
|
|
|
|
|
Create(str, cursor);
|
|
|
|
}
|
|
|
|
|
|
|
|
// Deprecated form of the above
|
|
|
|
wxDragImage(const wxString& str, const wxCursor& cursor, const wxPoint& cursorHotspot)
|
1999-04-08 15:36:00 -04:00
|
|
|
{
|
2000-03-01 06:05:49 -05:00
|
|
|
Init();
|
|
|
|
|
2001-04-10 09:44:03 -04:00
|
|
|
Create(str, cursor, cursorHotspot);
|
1999-04-08 15:36:00 -04:00
|
|
|
}
|
2001-04-10 17:01:40 -04:00
|
|
|
|
2003-06-14 09:00:55 -04:00
|
|
|
#if wxUSE_TREECTRL
|
1999-04-08 15:36:00 -04:00
|
|
|
wxDragImage(const wxTreeCtrl& treeCtrl, wxTreeItemId& id)
|
|
|
|
{
|
2000-03-01 06:05:49 -05:00
|
|
|
Init();
|
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
Create(treeCtrl, id);
|
|
|
|
}
|
2003-06-14 09:00:55 -04:00
|
|
|
#endif
|
2001-04-10 17:01:40 -04:00
|
|
|
|
2003-06-14 09:00:55 -04:00
|
|
|
#if wxUSE_LISTCTRL
|
1999-04-08 15:36:00 -04:00
|
|
|
wxDragImage(const wxListCtrl& listCtrl, long id)
|
|
|
|
{
|
2000-03-01 06:05:49 -05:00
|
|
|
Init();
|
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
Create(listCtrl, id);
|
|
|
|
}
|
2003-06-14 09:00:55 -04:00
|
|
|
#endif
|
2001-04-10 17:01:40 -04:00
|
|
|
|
2006-09-05 16:47:48 -04:00
|
|
|
virtual ~wxDragImage();
|
2000-02-14 19:05:36 -05:00
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
// Attributes
|
|
|
|
////////////////////////////////////////////////////////////////////////////
|
2000-02-14 19:05:36 -05:00
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
// Operations
|
|
|
|
////////////////////////////////////////////////////////////////////////////
|
2000-02-14 19:05:36 -05:00
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
// Create a drag image from a bitmap and optional cursor
|
2001-04-10 17:01:40 -04:00
|
|
|
bool Create(const wxBitmap& image, const wxCursor& cursor = wxNullCursor);
|
|
|
|
bool Create(const wxBitmap& image, const wxCursor& cursor, const wxPoint& WXUNUSED(cursorHotspot))
|
|
|
|
{
|
|
|
|
wxLogDebug(wxT("wxDragImage::Create: use of a cursor hotspot is now deprecated. Please omit this argument."));
|
|
|
|
return Create(image, cursor);
|
|
|
|
}
|
2000-02-14 19:05:36 -05:00
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
// Create a drag image from an icon and optional cursor
|
2001-04-10 17:01:40 -04:00
|
|
|
bool Create(const wxIcon& image, const wxCursor& cursor = wxNullCursor);
|
|
|
|
bool Create(const wxIcon& image, const wxCursor& cursor, const wxPoint& WXUNUSED(cursorHotspot))
|
|
|
|
{
|
|
|
|
wxLogDebug(wxT("wxDragImage::Create: use of a cursor hotspot is now deprecated. Please omit this argument."));
|
|
|
|
return Create(image, cursor);
|
|
|
|
}
|
2000-02-14 19:05:36 -05:00
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
// Create a drag image from a string and optional cursor
|
2001-04-10 17:01:40 -04:00
|
|
|
bool Create(const wxString& str, const wxCursor& cursor = wxNullCursor);
|
|
|
|
bool Create(const wxString& str, const wxCursor& cursor, const wxPoint& WXUNUSED(cursorHotspot))
|
|
|
|
{
|
|
|
|
wxLogDebug(wxT("wxDragImage::Create: use of a cursor hotspot is now deprecated. Please omit this argument."));
|
|
|
|
return Create(str, cursor);
|
|
|
|
}
|
1999-04-08 15:36:00 -04:00
|
|
|
|
2003-06-14 09:00:55 -04:00
|
|
|
#if wxUSE_TREECTRL
|
1999-04-08 15:36:00 -04:00
|
|
|
// Create a drag image for the given tree control item
|
|
|
|
bool Create(const wxTreeCtrl& treeCtrl, wxTreeItemId& id);
|
2003-06-14 09:00:55 -04:00
|
|
|
#endif
|
1999-04-08 15:36:00 -04:00
|
|
|
|
2003-06-14 09:00:55 -04:00
|
|
|
#if wxUSE_LISTCTRL
|
1999-04-08 15:36:00 -04:00
|
|
|
// Create a drag image for the given list control item
|
|
|
|
bool Create(const wxListCtrl& listCtrl, long id);
|
2003-06-14 09:00:55 -04:00
|
|
|
#endif
|
1999-04-08 15:36:00 -04:00
|
|
|
|
|
|
|
// Begin drag. hotspot is the location of the drag position relative to the upper-left
|
|
|
|
// corner of the image.
|
2004-08-24 06:31:41 -04:00
|
|
|
bool BeginDrag(const wxPoint& hotspot, wxWindow* window, bool fullScreen = false, wxRect* rect = (wxRect*) NULL);
|
2000-03-01 06:05:49 -05:00
|
|
|
|
|
|
|
// Begin drag. hotspot is the location of the drag position relative to the upper-left
|
|
|
|
// corner of the image. This is full screen only. fullScreenRect gives the
|
|
|
|
// position of the window on the screen, to restrict the drag to.
|
|
|
|
bool BeginDrag(const wxPoint& hotspot, wxWindow* window, wxWindow* fullScreenRect);
|
2000-02-14 19:05:36 -05:00
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
// End drag
|
2000-03-01 06:05:49 -05:00
|
|
|
bool EndDrag();
|
2000-02-14 19:05:36 -05:00
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
// Move the image: call from OnMouseMove. Pt is in window client coordinates if window
|
|
|
|
// is non-NULL, or in screen coordinates if NULL.
|
2000-03-01 06:05:49 -05:00
|
|
|
bool Move(const wxPoint& pt);
|
1999-04-08 15:36:00 -04:00
|
|
|
|
|
|
|
// Show the image
|
2000-03-01 06:05:49 -05:00
|
|
|
bool Show();
|
1999-04-08 15:36:00 -04:00
|
|
|
|
|
|
|
// Hide the image
|
2000-03-01 06:05:49 -05:00
|
|
|
bool Hide();
|
2000-02-14 19:05:36 -05:00
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
// Implementation
|
|
|
|
////////////////////////////////////////////////////////////////////////////
|
2000-02-14 19:05:36 -05:00
|
|
|
|
2000-03-01 06:05:49 -05:00
|
|
|
// Initialize variables
|
|
|
|
void Init();
|
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
// Returns the native image list handle
|
2000-02-14 19:05:36 -05:00
|
|
|
WXHIMAGELIST GetHIMAGELIST() const { return m_hImageList; }
|
|
|
|
|
2001-04-10 09:44:03 -04:00
|
|
|
#if !wxUSE_SIMPLER_DRAGIMAGE
|
2000-03-01 06:05:49 -05:00
|
|
|
// Returns the native image list handle for the cursor
|
|
|
|
WXHIMAGELIST GetCursorHIMAGELIST() const { return m_hCursorImageList; }
|
2001-04-10 09:44:03 -04:00
|
|
|
#endif
|
2000-03-01 06:05:49 -05:00
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
protected:
|
|
|
|
WXHIMAGELIST m_hImageList;
|
2001-04-10 09:44:03 -04:00
|
|
|
|
|
|
|
#if wxUSE_SIMPLER_DRAGIMAGE
|
|
|
|
wxCursor m_oldCursor;
|
|
|
|
#else
|
2000-03-01 06:05:49 -05:00
|
|
|
WXHIMAGELIST m_hCursorImageList;
|
2001-04-10 09:44:03 -04:00
|
|
|
#endif
|
|
|
|
|
1999-04-08 15:36:00 -04:00
|
|
|
wxCursor m_cursor;
|
2001-04-10 17:01:40 -04:00
|
|
|
// wxPoint m_cursorHotspot; // Obsolete
|
1999-04-08 15:36:00 -04:00
|
|
|
wxPoint m_position;
|
2000-03-01 06:05:49 -05:00
|
|
|
wxWindow* m_window;
|
|
|
|
wxRect m_boundingRect;
|
|
|
|
bool m_fullScreen;
|
2000-02-14 19:05:36 -05:00
|
|
|
|
|
|
|
private:
|
|
|
|
DECLARE_DYNAMIC_CLASS(wxDragImage)
|
2003-01-02 18:38:11 -05:00
|
|
|
DECLARE_NO_COPY_CLASS(wxDragImage)
|
1999-04-08 15:36:00 -04:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|
|
|
|
// _WX_DRAGIMAG_H_
|