From: Robin Dunn <robin@alldunn.com>
Date: Thu, 3 May 2012 23:30:33 +0000 (+0000)
Subject: * Change "def" to defResult as def is a reserved word in Python
X-Git-Url: https://git.saurik.com/wxWidgets.git/commitdiff_plain/07b6b12176bc7f1fbe508c77f7e5bfb448484886?ds=sidebyside;hp=4e4fffec1990d6a40e7c7f2e650dee551eb08cf9

* Change "def" to defResult as def is a reserved word in Python
* Correct some methods that were marked pure virtual but which aren't.
* etc.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@71348 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---

diff --git a/interface/wx/dnd.h b/interface/wx/dnd.h
index 20a9bb82a9..278aa057d3 100644
--- a/interface/wx/dnd.h
+++ b/interface/wx/dnd.h
@@ -16,47 +16,6 @@ enum
     wxDrag_DefaultMove = 3  ///< Allow moving and make it default operation.
 };
 
-/**
-    @class wxTextDropTarget
-
-    A predefined drop target for dealing with text data.
-
-    @library{wxcore}
-    @category{dnd}
-
-    @see @ref overview_dnd, wxDropSource, wxDropTarget, wxFileDropTarget
-*/
-class wxTextDropTarget : public wxDropTarget
-{
-public:
-    /**
-        Constructor.
-    */
-    wxTextDropTarget();
-
-    /**
-        See wxDropTarget::OnDrop(). This function is implemented appropriately
-        for text, and calls OnDropText().
-    */
-    virtual bool OnDrop(wxCoord x, wxCoord y);
-
-    /**
-        Override this function to receive dropped text.
-
-        @param x
-            The x coordinate of the mouse.
-        @param y
-            The y coordinate of the mouse.
-        @param data
-            The data being dropped: a wxString.
-
-        Return @true to accept the data, or @false to veto the operation.
-    */
-    virtual bool OnDropText(wxCoord x, wxCoord y, const wxString& data) = 0;
-};
-
-
-
 /**
     Result returned from a wxDropSource::DoDragDrop() call.
 */
@@ -70,6 +29,8 @@ enum wxDragResult
     wxDragCancel    ///< The operation was cancelled by user (not an error).
 };
 
+
+
 /**
     @class wxDropTarget
 
@@ -109,23 +70,23 @@ public:
         associated with this drop target, calling its wxDataObject::SetData()
         method.
     */
-    virtual bool GetData() = 0;
+    virtual bool GetData();
 
     /**
         Called after OnDrop() returns @true. By default this will usually
-        GetData() and will return the suggested default value @a def.
+        GetData() and will return the suggested default value @a defResult.
     */
-    virtual wxDragResult OnData(wxCoord x, wxCoord y, wxDragResult def) = 0;
+    virtual wxDragResult OnData(wxCoord x, wxCoord y, wxDragResult defResult) = 0;
 
     /**
         Called when the mouse is being dragged over the drop target. By
-        default, this calls functions return the suggested return value @a def.
+        default, this calls functions return the suggested return value @a defResult.
 
         @param x
             The x coordinate of the mouse.
         @param y
             The y coordinate of the mouse.
-        @param def
+        @param defResult
             Suggested value for return value. Determined by SHIFT or CONTROL
             key states.
 
@@ -133,7 +94,7 @@ public:
                  feedback from the side of the drop source, typically in form
                  of changing the icon.
     */
-    virtual wxDragResult OnDragOver(wxCoord x, wxCoord y, wxDragResult def);
+    virtual wxDragResult OnDragOver(wxCoord x, wxCoord y, wxDragResult defResult);
 
     /**
         Called when the user drops a data object on the target. Return @false
@@ -146,7 +107,7 @@ public:
 
         @return @true to accept the data, or @false to veto the operation.
     */
-    virtual bool OnDrop(wxCoord x, wxCoord y) = 0;
+    virtual bool OnDrop(wxCoord x, wxCoord y);
 
     /**
         Called when the mouse enters the drop target. By default, this calls
@@ -156,7 +117,7 @@ public:
             The x coordinate of the mouse.
         @param y
             The y coordinate of the mouse.
-        @param def
+        @param defResult
             Suggested default for return value. Determined by SHIFT or CONTROL
             key states.
 
@@ -164,7 +125,7 @@ public:
                  feedback from the side of the drop source, typically in form
                  of changing the icon.
     */
-    virtual wxDragResult OnEnter(wxCoord x, wxCoord y, wxDragResult def);
+    virtual wxDragResult OnEnter(wxCoord x, wxCoord y, wxDragResult defResult);
 
     /**
         Called when the mouse leaves the drop target.
@@ -176,6 +137,22 @@ public:
         any previously associated data object.
     */
     void SetDataObject(wxDataObject* data);
+
+
+    /**
+       Sets the default action for drag and drop.  Use wxDragMove or
+       wxDragCopy to set deafult action to move or copy and use wxDragNone
+       (default) to set default action specified by initialization of draging
+       (see wxDropSource::DoDragDrop())
+    */
+    void SetDefaultAction(wxDragResult action);
+
+    /**
+       Returns default action for drag and drop or wxDragNone if this not
+       specified.
+    */
+    wxDragResult GetDefaultAction();
+
 };
 
 
@@ -346,6 +323,46 @@ public:
 
 
 
+/**
+    @class wxTextDropTarget
+
+    A predefined drop target for dealing with text data.
+
+    @library{wxcore}
+    @category{dnd}
+
+    @see @ref overview_dnd, wxDropSource, wxDropTarget, wxFileDropTarget
+*/
+class wxTextDropTarget : public wxDropTarget
+{
+public:
+    /**
+        Constructor.
+    */
+    wxTextDropTarget();
+
+    /**
+        See wxDropTarget::OnDrop(). This function is implemented appropriately
+        for text, and calls OnDropText().
+    */
+    virtual bool OnDrop(wxCoord x, wxCoord y);
+
+    /**
+        Override this function to receive dropped text.
+
+        @param x
+            The x coordinate of the mouse.
+        @param y
+            The y coordinate of the mouse.
+        @param data
+            The data being dropped: a wxString.
+
+        Return @true to accept the data, or @false to veto the operation.
+    */
+    virtual bool OnDropText(wxCoord x, wxCoord y, const wxString& data) = 0;
+};
+
+
 /**
     @class wxFileDropTarget
 
@@ -410,5 +427,11 @@ public:
 */
 #define wxDROP_ICON(name)
 
+/**
+   Returns true if res indicates that something was done during a DnD operation,
+   i.e. is neither error nor none nor cancel.
+*/
+bool wxIsDragResultOk(wxDragResult res);
+
 //@}