updated comments after latest commit (Tim Kosse)

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@44351 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Vadim Zeitlin
2007-02-03 15:56:44 +00:00
parent 207ddcc988
commit 08291defc2

View File

@@ -99,8 +99,11 @@ static DWORD ConvertDragResultToEffect(wxDragResult result);
// Name : static wxIDropTarget::GetDropEffect // Name : static wxIDropTarget::GetDropEffect
// Purpose : determine the drop operation from keyboard/mouse state. // Purpose : determine the drop operation from keyboard/mouse state.
// Returns : DWORD combined from DROPEFFECT_xxx constants // Returns : DWORD combined from DROPEFFECT_xxx constants
// Params : [in] DWORD flags kbd & mouse flags as passed to // Params : [in] DWORD flags kbd & mouse flags as passed to
// IDropTarget methods // IDropTarget methods
// [in] wxDragResult defaultAction the default action of the drop target
// [in] DWORD pdwEffect the supported actions of the drop
// source passed to IDropTarget methods
// Notes : We do "move" normally and "copy" if <Ctrl> is pressed, // Notes : We do "move" normally and "copy" if <Ctrl> is pressed,
// which is the standard behaviour (currently there is no // which is the standard behaviour (currently there is no
// way to redefine it) // way to redefine it)
@@ -151,10 +154,12 @@ IMPLEMENT_IUNKNOWN_METHODS(wxIDropTarget)
// Name : wxIDropTarget::DragEnter // Name : wxIDropTarget::DragEnter
// Purpose : Called when the mouse enters the window (dragging something) // Purpose : Called when the mouse enters the window (dragging something)
// Returns : S_OK // Returns : S_OK
// Params : [in] IDataObject *pIDataSource : source data // Params : [in] IDataObject *pIDataSource : source data
// [in] DWORD grfKeyState : kbd & mouse state // [in] DWORD grfKeyState : kbd & mouse state
// [in] POINTL pt : mouse coordinates // [in] POINTL pt : mouse coordinates
// [out]DWORD *pdwEffect : effect flag // [in/out]DWORD *pdwEffect : effect flag
// In: Supported effects
// Out: Resulting effect
// Notes : // Notes :
STDMETHODIMP wxIDropTarget::DragEnter(IDataObject *pIDataSource, STDMETHODIMP wxIDropTarget::DragEnter(IDataObject *pIDataSource,
DWORD grfKeyState, DWORD grfKeyState,
@@ -218,9 +223,9 @@ STDMETHODIMP wxIDropTarget::DragEnter(IDataObject *pIDataSource,
// Purpose : Indicates that the mouse was moved inside the window represented // Purpose : Indicates that the mouse was moved inside the window represented
// by this drop target. // by this drop target.
// Returns : S_OK // Returns : S_OK
// Params : [in] DWORD grfKeyState kbd & mouse state // Params : [in] DWORD grfKeyState kbd & mouse state
// [in] POINTL pt mouse coordinates // [in] POINTL pt mouse coordinates
// [out]LPDWORD pdwEffect effect flag // [in/out]LPDWORD pdwEffect current effect flag
// Notes : We're called on every WM_MOUSEMOVE, so this function should be // Notes : We're called on every WM_MOUSEMOVE, so this function should be
// very efficient. // very efficient.
STDMETHODIMP wxIDropTarget::DragOver(DWORD grfKeyState, STDMETHODIMP wxIDropTarget::DragOver(DWORD grfKeyState,
@@ -273,10 +278,10 @@ STDMETHODIMP wxIDropTarget::DragLeave()
// Purpose : Instructs the drop target to paste data that was just now // Purpose : Instructs the drop target to paste data that was just now
// dropped on it. // dropped on it.
// Returns : S_OK // Returns : S_OK
// Params : [in] IDataObject *pIDataSource the data to paste // Params : [in] IDataObject *pIDataSource the data to paste
// [in] DWORD grfKeyState kbd & mouse state // [in] DWORD grfKeyState kbd & mouse state
// [in] POINTL pt where the drop occurred? // [in] POINTL pt where the drop occurred?
// [ouy]DWORD *pdwEffect operation effect // [in/out]DWORD *pdwEffect operation effect
// Notes : // Notes :
STDMETHODIMP wxIDropTarget::Drop(IDataObject *pIDataSource, STDMETHODIMP wxIDropTarget::Drop(IDataObject *pIDataSource,
DWORD grfKeyState, DWORD grfKeyState,