Added possibility of 2-step initialisation, and wxWIZARD_EX_HELPBUTTON style.

[wxWidgets.git] / include / wx / msw / ole / droptgt.h

diff --git a/include/wx/msw/ole/droptgt.h b/include/wx/msw/ole/droptgt.h
index cd9fbacfa6f2f65242bf875f6871515fe45e82f9..a4648b5edfc81ea3e241e627d98e98e9d4fa9fda 100644 (file)
--- a/include/wx/msw/ole/droptgt.h
+++ b/include/wx/msw/ole/droptgt.h
@@ -2,30 +2,28 @@
 // Name:        ole/droptgt.h
 // Purpose:     declaration of the wxDropTarget class
 // Author:      Vadim Zeitlin
 // Name:        ole/droptgt.h
 // Purpose:     declaration of the wxDropTarget class
 // Author:      Vadim Zeitlin

-// Modified by: 
+// Modified by:

 // Created:     06.03.98
 // RCS-ID:      $Id$
 // Copyright:   (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
 // Created:     06.03.98
 // RCS-ID:      $Id$
 // Copyright:   (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>

-// Licence:     wxWindows license
+// Licence:     wxWindows licence

 ///////////////////////////////////////////////////////////////////////////////
 
 ///////////////////////////////////////////////////////////////////////////////
 

-// ============================================================================
-// prolog
-// ============================================================================
-#ifndef   _OLEDROPTGT_H
-#define   _OLEDROPTGT_H
+#ifndef   _WX_OLEDROPTGT_H
+#define   _WX_OLEDROPTGT_H

 
 #ifdef __GNUG__
 #pragma interface "droptgt.h"
 #endif
 
 
 #ifdef __GNUG__
 #pragma interface "droptgt.h"
 #endif
 

-#if !USE_DRAG_AND_DROP
-  #error  "You should #define USE_DRAG_AND_DROP to 1 to compile this file!"
+#if !wxUSE_DRAG_AND_DROP
+    #error  "You should #define wxUSE_DRAG_AND_DROP to 1 to compile this file!"

 #endif  //WX_DRAG_DROP
 
 // ----------------------------------------------------------------------------
 // forward declarations
 // ----------------------------------------------------------------------------
 #endif  //WX_DRAG_DROP
 
 // ----------------------------------------------------------------------------
 // forward declarations
 // ----------------------------------------------------------------------------

+

 class  wxIDropTarget;
 struct IDataObject;
 
 class  wxIDropTarget;
 struct IDataObject;
 


@@ -33,79 +31,44 @@ struct IDataObject;
 // An instance of the class wxDropTarget may be associated with any wxWindow
 // derived object via SetDropTarget() function. If this is done, the virtual
 // methods of wxDropTarget are called when something is dropped on the window.
 // An instance of the class wxDropTarget may be associated with any wxWindow
 // derived object via SetDropTarget() function. If this is done, the virtual
 // methods of wxDropTarget are called when something is dropped on the window.

-// 
+//

 // Note that wxDropTarget is an abstract base class (ABC) and you should derive
 // your own class from it implementing pure virtual function in order to use it
 // (all of them, including protected ones which are called by the class itself)
 // ----------------------------------------------------------------------------
 // Note that wxDropTarget is an abstract base class (ABC) and you should derive
 // your own class from it implementing pure virtual function in order to use it
 // (all of them, including protected ones which are called by the class itself)
 // ----------------------------------------------------------------------------

-class WXDLLEXPORT wxDropTarget
+
+class WXDLLEXPORT wxDropTarget : public wxDropTargetBase

 {
 public:
 {
 public:

-  // ctor & dtor
-  wxDropTarget();
-  virtual ~wxDropTarget();
+    // ctor & dtor
+    wxDropTarget(wxDataObject *dataObject = NULL);
+    virtual ~wxDropTarget();

 
 

-  // normally called by wxWindow on window creation/destruction, but might be
-  // called `manually' as well. Register() returns true on success.
-  bool Register(WXHWND hwnd);
-  void Revoke(WXHWND hwnd);
+    // normally called by wxWindow on window creation/destruction, but might be
+    // called `manually' as well. Register() returns true on success.
+    bool Register(WXHWND hwnd);
+    void Revoke(WXHWND hwnd);

 
 

-  // do we accept this kind of data?
-  virtual bool IsAcceptedData(IDataObject *pIDataSource) const;
+    // provide default implementation for base class pure virtuals
+    virtual bool OnDrop(wxCoord x, wxCoord y);
+    virtual bool GetData();

 
 

-  // called when mouse enters/leaves the window: might be used to give
-  // some visual feedback to the user
-  virtual void OnEnter() { }
-  virtual void OnLeave() { }
+    // implementation only from now on
+    // -------------------------------

 
 

-  // this function is called when data is dropped.
-  // (x, y) are the coordinates of the drop
-  virtual bool OnDrop(long x, long y, const void *pData) = 0;
+    // do we accept this kind of data?
+    bool IsAcceptedData(IDataObject *pIDataSource) const;

 
 

-protected:
-  // Override these to indicate what kind of data you support: the first
-  // format to which data can be converted is used. The classes below show
-  // how it can be done in the simplest cases.
-    // how many different (clipboard) formats do you support?
-  virtual size_t GetFormatCount() const = 0;
-    // return the n-th supported format
-  virtual wxDataFormat GetFormat(size_t n) const = 0;
+    // give us the data source from IDropTarget::Drop() - this is later used by
+    // GetData() when it's called from inside OnData()
+    void SetDataSource(IDataObject *pIDataSource);

 
 private:
 
 private:

-  wxIDropTarget    *m_pIDropTarget; // the pointer to COM interface
-};
-
-// ----------------------------------------------------------------------------
-// A simple wxDropTarget derived class for text data: you only need to
-// override OnDropText() to get something working
-// ----------------------------------------------------------------------------
-class WXDLLEXPORT wxTextDropTarget : public wxDropTarget
-{
-public:
-  virtual bool OnDrop(long x, long y, const void *pData);
-  virtual bool OnDropText(long x, long y, const char *psz) = 0;
-
-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:
-  virtual bool OnDrop(long x, long y, const void *pData);
-
-  // params: the number of files and the array of file names
-  virtual bool OnDropFiles(long x, long y, 
-                           size_t nFiles, const char * const aszFiles[]) = 0;
+    // helper used by IsAcceptedData() and GetData()
+    wxDataFormat GetSupportedFormat(IDataObject *pIDataSource) const;

 
 

-protected:
-  virtual size_t GetFormatCount() const;
-  virtual wxDataFormat GetFormat(size_t n) const;
+    wxIDropTarget *m_pIDropTarget; // the pointer to our COM interface
+    IDataObject   *m_pIDataSource; // the pointer to the source data object

 };
 
 };
 

-// ============================================================================
-#endif  //_OLEDROPTGT_H
+#endif  //_WX_OLEDROPTGT_H