]> git.saurik.com Git - wxWidgets.git/blame_incremental - include/wx/msw/ole/droptgt.h
implemented wxDC::DoGetSize() correctly for metafile DC classes
[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#if wxUSE_DRAG_AND_DROP
16
17// ----------------------------------------------------------------------------
18// forward declarations
19// ----------------------------------------------------------------------------
20
21class wxIDropTarget;
22struct IDataObject;
23
24// ----------------------------------------------------------------------------
25// An instance of the class wxDropTarget may be associated with any wxWindow
26// derived object via SetDropTarget() function. If this is done, the virtual
27// methods of wxDropTarget are called when something is dropped on the window.
28//
29// Note that wxDropTarget is an abstract base class (ABC) and you should derive
30// your own class from it implementing pure virtual function in order to use it
31// (all of them, including protected ones which are called by the class itself)
32// ----------------------------------------------------------------------------
33
34class WXDLLEXPORT wxDropTarget : public wxDropTargetBase
35{
36public:
37 // ctor & dtor
38 wxDropTarget(wxDataObject *dataObject = NULL);
39 virtual ~wxDropTarget();
40
41 // normally called by wxWindow on window creation/destruction, but might be
42 // called `manually' as well. Register() returns true on success.
43 bool Register(WXHWND hwnd);
44 void Revoke(WXHWND hwnd);
45
46 // provide default implementation for base class pure virtuals
47 virtual bool OnDrop(wxCoord x, wxCoord y);
48 virtual bool GetData();
49
50 // implementation only from now on
51 // -------------------------------
52
53 // do we accept this kind of data?
54 bool IsAcceptedData(IDataObject *pIDataSource) const;
55
56 // give us the data source from IDropTarget::Drop() - this is later used by
57 // GetData() when it's called from inside OnData()
58 void SetDataSource(IDataObject *pIDataSource);
59
60private:
61 // helper used by IsAcceptedData() and GetData()
62 wxDataFormat GetSupportedFormat(IDataObject *pIDataSource) const;
63
64 wxIDropTarget *m_pIDropTarget; // the pointer to our COM interface
65 IDataObject *m_pIDataSource; // the pointer to the source data object
66
67 DECLARE_NO_COPY_CLASS(wxDropTarget)
68};
69
70#endif //wxUSE_DRAG_AND_DROP
71
72#endif //_WX_OLEDROPTGT_H