///////////////////////////////////////////////////////////////////////////////
// Name: dnd.h
-// Purpose: Declaration of the wxDropTarget, wxDropSource class etc.
-// Author: AUTHOR
+// Purpose: declaration of the wxDropTarget class
+// Author: David Webster
+// Modified by:
+// Created: 10/21/99
// RCS-ID: $Id$
-// Copyright: (c) 1998 AUTHOR
+// Copyright: (c) 1999 David Webster
// Licence: wxWindows licence
///////////////////////////////////////////////////////////////////////////////
-#ifndef _WX_DND_H_
-#define _WX_DND_H_
-#ifdef __GNUG__
-#pragma interface "dnd.h"
-#endif
-
-#include "wx/defs.h"
-#include "wx/object.h"
-#include "wx/string.h"
-#include "wx/cursor.h"
-
-//-------------------------------------------------------------------------
-// classes
-//-------------------------------------------------------------------------
+#ifndef __OS2DNDH__
+#define __OS2DNDH__
-class WXDLLEXPORT wxWindow;
+#if !wxUSE_DRAG_AND_DROP
+ #error "You should #define wxUSE_DRAG_AND_DROP to 1 to compile this file!"
+#endif //WX_DRAG_DROP
-class WXDLLEXPORT wxDataObject;
-class WXDLLEXPORT wxTextDataObject;
-class WXDLLEXPORT wxFileDataObject;
-
-class WXDLLEXPORT wxDropTarget;
-class WXDLLEXPORT wxTextDropTarget;
-class WXDLLEXPORT wxFileDropTarget;
+#define INCL_WINSTDDRAG
+#include <os2.h>
+#ifndef __EMX__
+#include <pmstddlg.h>
+#endif
-class WXDLLEXPORT wxDropSource;
+class CIDropTarget;
//-------------------------------------------------------------------------
-// wxDataBroker (internal)
+// wxDropSource
//-------------------------------------------------------------------------
-class wxDataBroker : public wxObject
+class WXDLLIMPEXP_CORE wxDropSource: public wxDropSourceBase
{
- DECLARE_CLASS( wxDataBroker )
-
public:
+ /* constructor. set data later with SetData() */
+ wxDropSource(wxWindow* pWin);
- /* constructor */
- wxDataBroker();
-
- /* add data object */
- void Add( wxDataObject *dataObject, bool preferred = FALSE );
-
-private:
-
- /* OLE implementation, the methods don't need to be overridden */
-
- /* get number of supported formats */
- virtual size_t GetFormatCount() const;
-
- /* return nth supported format */
- virtual wxDataFormat &GetNthFormat( size_t nth ) const;
-
- /* return preferrd/best supported format */
- virtual wxDataFormatId GetPreferredFormat() const;
-
- /* search through m_dataObjects, return TRUE if found */
- virtual bool IsSupportedFormat( wxDataFormat &format ) const;
-
- /* search through m_dataObjects and call child's GetSize() */
- virtual size_t GetSize( wxDataFormat& format ) const;
+ /* constructor for setting one data object */
+ wxDropSource( wxDataObject& rData,
+ wxWindow* pWin
+ );
+ virtual ~wxDropSource();
- /* search through m_dataObjects and call child's WriteData(dest) */
- virtual void WriteData( wxDataFormat& format, void *dest ) const;
+ /* start drag action */
+ virtual wxDragResult DoDragDrop(int flags = wxDrag_CopyOnly);
+ virtual bool GiveFeedback(wxDragResult eEffect);
- /* implementation */
+protected:
+ void Init(void);
-public:
-
- wxList m_dataObjects;
- size_t m_preferred;
-};
+ ULONG m_ulItems;
+ PDRAGINFO m_pDragInfo;
+ DRAGIMAGE m_vDragImage;
+ PDRAGITEM m_pDragItem;
+ wxWindow* m_pWindow;
+}; // end of CLASS wxDropSource
//-------------------------------------------------------------------------
-// wxDataObject
+// wxDropTarget
//-------------------------------------------------------------------------
-class WXDLLEXPORT wxDataObject: public wxDataObjectBase
-{
-public:
- // all data formats (values are the same as in windows.h, do not change!)
- enum StdFormat
- {
- Invalid,
- Text,
- Bitmap,
- MetafilePict,
- Sylk,
- Dif,
- Tiff,
- OemText,
- Dib,
- Palette,
- Pendata,
- Riff,
- Wave,
- UnicodeText,
- EnhMetafile,
- Hdrop,
- Locale,
- Max
- };
-
- // function to return symbolic name of clipboard format (debug messages)
- static const char *GetFormatName(wxDataFormat format);
-
- // ctor & dtor
- wxDataObject() {};
- ~wxDataObject() {};
-
- // pure virtuals to override
- // get the best suited format for our data
- virtual wxDataFormat GetPreferredFormat() const = 0;
- // decide if we support this format (should be one of values of
- // StdFormat enumerations or a user-defined format)
- virtual bool IsSupportedFormat(wxDataFormat format) const = 0;
- // get the (total) size of data
- virtual size_t GetDataSize() const = 0;
- // copy raw data to provided pointer
- virtual bool GetDataHere(void *pBuf) const = 0;
-
-};
-
-// ----------------------------------------------------------------------------
-// wxFileDataObject is a specialization of wxDataObject for file names
-// ----------------------------------------------------------------------------
-
-class WXDLLEXPORT wxFileDataObject : public wxDataObject
+class WXDLLIMPEXP_CORE wxDropTarget : public wxDropTargetBase
{
public:
-
- wxFileDataObject(void) { }
- void AddFile( const wxString &file )
- { m_files += file; m_files += ";"; }
-
- // implement base class pure virtuals
- virtual wxDataFormat GetPreferredFormat() const
- { return wxDF_FILENAME; }
- virtual bool IsSupportedFormat(wxDataFormat format) const
- { return format == (unsigned short)wxDF_FILENAME; }
- virtual size_t GetDataSize() const
- { return m_files.Len() + 1; } // +1 for trailing '\0'of course
- virtual bool GetDataHere(void *pBuf) const
- { memcpy(pBuf, m_files.c_str(), GetDataSize()); }
+ wxDropTarget(wxDataObject* pDataObject = (wxDataObject*)NULL);
+ virtual ~wxDropTarget();
+
+ //
+ // These functions are called when data is moved over position (x, y) and
+ // may return either wxDragCopy, wxDragMove or wxDragNone depending on
+ // what would happen if the data were dropped here.
+ //
+ // The last parameter is what would happen by default and is determined by
+ // the platform-specific logic (for example, under Windows it's wxDragCopy
+ // if Ctrl key is pressed and wxDragMove otherwise) except that it will
+ // always be wxDragNone if the carried data is in an unsupported format.
+ //
+ // OnData must be implemented and other should be overridden by derived classes
+ //
+ virtual wxDragResult OnData( wxCoord vX
+ ,wxCoord vY
+ ,wxDragResult eResult
+ );
+ virtual bool OnDrop( wxCoord vX
+ ,wxCoord vY
+ );
+ bool IsAcceptedData(PDRAGINFO pDataSource) const;
+
+protected:
+ virtual bool GetData(void);
+ wxDataFormat GetSupportedFormat(PDRAGINFO pDataSource) const;
+ void Release(void);
private:
- wxString m_files;
-
-};
-//-------------------------------------------------------------------------
-// wxDropTarget
-//-------------------------------------------------------------------------
-
-class WXDLLEXPORT wxDropTarget: public wxObject
-{
- public:
-
- wxDropTarget();
- ~wxDropTarget();
-
- virtual void OnEnter() { }
- virtual void OnLeave() { }
- virtual bool OnDrop( long x, long y, const void *pData ) = 0;
-
-// protected:
-
- friend wxWindow;
-
- // Override these to indicate what kind of data you support:
-
- virtual size_t GetFormatCount() const = 0;
- virtual wxDataFormat GetFormat(size_t n) const = 0;
-};
-
-//-------------------------------------------------------------------------
-// wxTextDropTarget
-//-------------------------------------------------------------------------
-
-class WXDLLEXPORT wxTextDropTarget: public wxDropTarget
-{
- public:
-
- wxTextDropTarget() {};
- virtual bool OnDrop( long x, long y, const void *pData );
- virtual bool OnDropText( long x, long y, const char *psz );
-
- protected:
-
- virtual size_t GetFormatCount() const;
- virtual wxDataFormat GetFormat(size_t n) const;
-};
-
-// ----------------------------------------------------------------------------
-// A drop target which accepts files (dragged from File Manager or Explorer)
-// ----------------------------------------------------------------------------
-
-class WXDLLEXPORT wxFileDropTarget: public wxDropTarget
-{
- public:
+ CIDropTarget* m_pDropTarget;
+}; // end of CLASS wxDropTarget
- wxFileDropTarget() {};
-
- virtual bool OnDrop(long x, long y, const void *pData);
- virtual bool OnDropFiles( long x, long y,
- size_t nFiles, const char * const aszFiles[]);
-
- protected:
-
- virtual size_t GetFormatCount() const;
- virtual wxDataFormat GetFormat(size_t n) const;
-};
-
-//-------------------------------------------------------------------------
-// wxDropSource
-//-------------------------------------------------------------------------
-
-enum wxDragResult
- {
- wxDragError, // error prevented the d&d operation from completing
- wxDragNone, // drag target didn't accept the data
- wxDragCopy, // the data was successfully copied
- wxDragMove, // the data was successfully moved
- wxDragCancel // the operation was cancelled by user (not an error)
- };
-
-class WXDLLEXPORT wxDropSource: public wxObject
-{
- public:
-
- wxDropSource( wxWindow *win );
- wxDropSource( wxDataObject &data, wxWindow *win );
-
- ~wxDropSource(void);
-
- void SetData( wxDataObject &data );
- wxDragResult DoDragDrop( bool bAllowMove = FALSE );
-
- virtual bool GiveFeedback( wxDragResult WXUNUSED(effect), bool WXUNUSED(bScrolling) ) { return TRUE; };
-
- protected:
-
- wxDataObject *m_data;
-};
-
-#endif
- //_WX_DND_H_
+#endif //__OS2DNDH__