]> git.saurik.com Git - wxWidgets.git/blame_incremental - include/wx/msw/ole/droptgt.h
1. bug in wxString::find_first_of() fixed
[wxWidgets.git] / include / wx / msw / ole / droptgt.h
... / ...
CommitLineData
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#ifdef __GNUG__
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
27class wxIDropTarget;
28struct 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
40class WXDLLEXPORT wxDropTarget : public wxDropTargetBase
41{
42public:
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
66private:
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
74#endif //_WX_OLEDROPTGT_H