| | 1 | /////////////////////////////////////////////////////////////////////////////// |
| | 2 | // Name: ole/droptgt.h |
| | 3 | // Purpose: declaration of the wxDropTarget class |
| | 4 | // Author: Vadim Zeitlin |
| | 5 | // Modified by: |
| | 6 | // Created: 06.03.98 |
| | 7 | // RCS-ID: $Id$ |
| | 8 | // Copyright: (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr> |
| | 9 | // Licence: wxWindows licence |
| | 10 | /////////////////////////////////////////////////////////////////////////////// |
| | 11 | |
| | 12 | #ifndef _WX_OLEDROPTGT_H |
| | 13 | #define _WX_OLEDROPTGT_H |
| | 14 | |
| | 15 | #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA) |
| | 16 | #pragma interface "droptgt.h" |
| | 17 | #endif |
| | 18 | |
| | 19 | #if !wxUSE_DRAG_AND_DROP |
| | 20 | #error "You should #define wxUSE_DRAG_AND_DROP to 1 to compile this file!" |
| | 21 | #endif //WX_DRAG_DROP |
| | 22 | |
| | 23 | // ---------------------------------------------------------------------------- |
| | 24 | // forward declarations |
| | 25 | // ---------------------------------------------------------------------------- |
| | 26 | |
| | 27 | class wxIDropTarget; |
| | 28 | struct IDataObject; |
| | 29 | |
| | 30 | // ---------------------------------------------------------------------------- |
| | 31 | // An instance of the class wxDropTarget may be associated with any wxWindow |
| | 32 | // derived object via SetDropTarget() function. If this is done, the virtual |
| | 33 | // methods of wxDropTarget are called when something is dropped on the window. |
| | 34 | // |
| | 35 | // Note that wxDropTarget is an abstract base class (ABC) and you should derive |
| | 36 | // your own class from it implementing pure virtual function in order to use it |
| | 37 | // (all of them, including protected ones which are called by the class itself) |
| | 38 | // ---------------------------------------------------------------------------- |
| | 39 | |
| | 40 | class WXDLLEXPORT wxDropTarget : public wxDropTargetBase |
| | 41 | { |
| | 42 | public: |
| | 43 | // ctor & dtor |
| | 44 | wxDropTarget(wxDataObject *dataObject = NULL); |
| | 45 | virtual ~wxDropTarget(); |
| | 46 | |
| | 47 | // normally called by wxWindow on window creation/destruction, but might be |
| | 48 | // called `manually' as well. Register() returns true on success. |
| | 49 | bool Register(WXHWND hwnd); |
| | 50 | void Revoke(WXHWND hwnd); |
| | 51 | |
| | 52 | // provide default implementation for base class pure virtuals |
| | 53 | virtual bool OnDrop(wxCoord x, wxCoord y); |
| | 54 | virtual bool GetData(); |
| | 55 | |
| | 56 | // implementation only from now on |
| | 57 | // ------------------------------- |
| | 58 | |
| | 59 | // do we accept this kind of data? |
| | 60 | bool IsAcceptedData(IDataObject *pIDataSource) const; |
| | 61 | |
| | 62 | // give us the data source from IDropTarget::Drop() - this is later used by |
| | 63 | // GetData() when it's called from inside OnData() |
| | 64 | void SetDataSource(IDataObject *pIDataSource); |
| | 65 | |
| | 66 | private: |
| | 67 | // helper used by IsAcceptedData() and GetData() |
| | 68 | wxDataFormat GetSupportedFormat(IDataObject *pIDataSource) const; |
| | 69 | |
| | 70 | wxIDropTarget *m_pIDropTarget; // the pointer to our COM interface |
| | 71 | IDataObject *m_pIDataSource; // the pointer to the source data object |
| | 72 | |
| | 73 | DECLARE_NO_COPY_CLASS(wxDropTarget) |
| | 74 | }; |
| | 75 | |
| | 76 | #endif //_WX_OLEDROPTGT_H |
projects / wxWidgets.git / blame_incremental