1 ///////////////////////////////////////////////////////////////////////////////
3 // Purpose: Drag and drop classes declarations
4 // Author: Vadim Zeitlin, Robert Roebling
8 // Copyright: (c) wxWindows Team
9 // Licence: wxWindows license
10 ///////////////////////////////////////////////////////////////////////////////
12 #ifndef _WX_DND_H_BASE_
13 #define _WX_DND_H_BASE_
17 #if wxUSE_DRAG_AND_DROP
19 #include "wx/dataobj.h"
21 // ----------------------------------------------------------------------------
23 // ----------------------------------------------------------------------------
25 // result of wxDropSource::DoDragDrop() call
28 wxDragError
, // error prevented the d&d operation from completing
29 wxDragNone
, // drag target didn't accept the data
30 wxDragCopy
, // the data was successfully copied
31 wxDragMove
, // the data was successfully moved (MSW only)
32 wxDragCancel
// the operation was cancelled by user (not an error)
35 inline WXDLLEXPORT
bool wxIsDragResultOk(wxDragResult res
)
37 return res
== wxDragCopy
|| res
== wxDragMove
;
40 // ----------------------------------------------------------------------------
41 // wxDropSource is the object you need to create (and call DoDragDrop on it)
42 // to initiate a drag-and-drop operation
43 // ----------------------------------------------------------------------------
45 class WXDLLEXPORT wxDropSourceBase
48 wxDropSourceBase(const wxCursor
&cursorCopy
= wxNullCursor
,
49 const wxCursor
&cursorMove
= wxNullCursor
,
50 const wxCursor
&cursorStop
= wxNullCursor
)
51 : m_cursorCopy(cursorCopy
),
52 m_cursorMove(cursorMove
),
53 m_cursorStop(cursorStop
)
54 { m_data
= (wxDataObject
*)NULL
; }
55 virtual ~wxDropSourceBase() { }
57 // set the data which is transfered by drag and drop
58 void SetData(wxDataObject
& data
)
61 wxDataObject
*GetDataObject()
64 // set the icon corresponding to given drag result
65 void SetCursor(wxDragResult res
, const wxCursor
& cursor
)
67 if ( res
== wxDragCopy
)
68 m_cursorCopy
= cursor
;
69 else if ( res
== wxDragMove
)
70 m_cursorMove
= cursor
;
72 m_cursorStop
= cursor
;
75 // start drag action, see enum wxDragResult for return value description
77 // if bAllowMove is TRUE, data can be moved, if not - only copied
78 virtual wxDragResult
DoDragDrop(bool bAllowMove
= FALSE
) = 0;
80 // override to give feedback depending on the current operation result
81 // "effect" and return TRUE if you did something, FALSE to let the library
82 // give the default feedback
83 virtual bool GiveFeedback(wxDragResult
WXUNUSED(effect
)) { return FALSE
; }
86 const wxCursor
& GetCursor(wxDragResult res
) const
88 if ( res
== wxDragCopy
)
90 else if ( res
== wxDragMove
)
98 // the cursors to use for feedback
99 wxCursor m_cursorCopy
, m_cursorMove
, m_cursorStop
;
102 // ----------------------------------------------------------------------------
103 // wxDropTarget should be associated with a window if it wants to be able to
104 // receive data via drag and drop.
106 // To use this class, you should derive from wxDropTarget and implement
107 // OnData() pure virtual method. You may also wish to override OnDrop() if you
108 // want to accept the data only inside some region of the window (this may
109 // avoid having to copy the data to this application which happens only when
110 // OnData() is called)
111 // ----------------------------------------------------------------------------
113 class WXDLLEXPORT wxDropTargetBase
116 // ctor takes a pointer to heap-allocated wxDataObject which will be owned
117 // by wxDropTarget and deleted by it automatically. If you don't give it
118 // here, you can use SetDataObject() later.
119 wxDropTargetBase(wxDataObject
*dataObject
= (wxDataObject
*)NULL
)
120 { m_dataObject
= dataObject
; }
121 // dtor deletes our data object
122 virtual ~wxDropTargetBase()
123 { delete m_dataObject
; }
125 // get/set the associated wxDataObject
126 wxDataObject
*GetDataObject() const
127 { return m_dataObject
; }
128 void SetDataObject(wxDataObject
*dataObject
)
129 { if (m_dataObject
) delete m_dataObject
;
130 m_dataObject
= dataObject
; }
132 // these functions are called when data is moved over position (x, y) and
133 // may return either wxDragCopy, wxDragMove or wxDragNone depending on
134 // what would happen if the data were dropped here.
136 // the last parameter is what would happen by default and is determined by
137 // the platform-specific logic (for example, under Windows it's wxDragCopy
138 // if Ctrl key is pressed and wxDragMove otherwise) except that it will
139 // always be wxDragNone if the carried data is in an unsupported format.
141 // called when the mouse enters the window (only once until OnLeave())
142 virtual wxDragResult
OnEnter(wxCoord x
, wxCoord y
, wxDragResult def
)
143 { return OnDragOver(x
, y
, def
); }
145 // called when the mouse moves in the window - shouldn't take long to
146 // execute or otherwise mouse movement would be too slow
147 virtual wxDragResult
OnDragOver(wxCoord
WXUNUSED(x
), wxCoord
WXUNUSED(y
),
151 // called when mouse leaves the window: might be used to remove the
152 // feedback which was given in OnEnter()
153 virtual void OnLeave() { }
155 // this function is called when data is dropped at position (x, y) - if it
156 // returns TRUE, OnData() will be called immediately afterwards which will
157 // allow to retrieve the data dropped.
158 virtual bool OnDrop(wxCoord x
, wxCoord y
) = 0;
160 // called after OnDrop() returns TRUE: you will usually just call
161 // GetData() from here and, probably, also refresh something to update the
162 // new data and, finally, return the code indicating how did the operation
163 // complete (returning default value in case of success and wxDragError on
164 // failure is usually ok)
165 virtual wxDragResult
OnData(wxCoord x
, wxCoord y
, wxDragResult def
) = 0;
167 // may be called *only* from inside OnData() and will fill m_dataObject
168 // with the data from the drop source if it returns TRUE
169 virtual bool GetData() = 0;
172 wxDataObject
*m_dataObject
;
175 // ----------------------------------------------------------------------------
176 // include platform dependent class declarations
177 // ----------------------------------------------------------------------------
179 #if defined(__WXMSW__)
180 #include "wx/msw/ole/dropsrc.h"
181 #include "wx/msw/ole/droptgt.h"
182 #elif defined(__WXMOTIF__)
183 #include "wx/motif/dnd.h"
184 #elif defined(__WXGTK__)
185 #include "wx/gtk/dnd.h"
186 #elif defined(__WXQT__)
187 #include "wx/qt/dnd.h"
188 #elif defined(__WXMAC__)
189 #include "wx/mac/dnd.h"
190 #elif defined(__WXPM__)
191 #include "wx/os2/dnd.h"
192 #elif defined(__WXSTUBS__)
193 #include "wx/stubs/dnd.h"
196 // ----------------------------------------------------------------------------
197 // standard wxDropTarget implementations (implemented in common/dobjcmn.cpp)
198 // ----------------------------------------------------------------------------
200 // A simple wxDropTarget derived class for text data: you only need to
201 // override OnDropText() to get something working
202 class WXDLLEXPORT wxTextDropTarget
: public wxDropTarget
207 virtual bool OnDropText(wxCoord x
, wxCoord y
, const wxString
& text
) = 0;
209 virtual wxDragResult
OnData(wxCoord x
, wxCoord y
, wxDragResult def
);
212 // A drop target which accepts files (dragged from File Manager or Explorer)
213 class WXDLLEXPORT wxFileDropTarget
: public wxDropTarget
218 // parameters are the number of files and the array of file names
219 virtual bool OnDropFiles(wxCoord x
, wxCoord y
,
220 const wxArrayString
& filenames
) = 0;
222 virtual wxDragResult
OnData(wxCoord x
, wxCoord y
, wxDragResult def
);
225 #endif // wxUSE_DRAG_AND_DROP
227 #endif // _WX_DND_H_BASE_