- clean working copy for leaving SVN

2022-06-28 19:04:46 +02:00
parent 62a2d47cb3
commit 762b8f0e7d
1966 changed files with 699872 additions and 126 deletions
@@ -0,0 +1,104 @@
+/*
+  ==============================================================================
+
+   This file is part of the JUCE library.
+   Copyright (c) 2013 - Raw Material Software Ltd.
+
+   Permission is granted to use this software under the terms of either:
+   a) the GPL v2 (or any later version)
+   b) the Affero GPL v3
+
+   Details of these licenses can be found at: www.gnu.org/licenses
+
+   JUCE is distributed in the hope that it will be useful, but WITHOUT ANY
+   WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
+   A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
+
+   ------------------------------------------------------------------------------
+
+   To release a closed-source product which uses JUCE, commercial licenses are
+   available: visit www.juce.com for more information.
+
+  ==============================================================================
+*/
+
+#ifndef JUCE_FILEDRAGANDDROPTARGET_H_INCLUDED
+#define JUCE_FILEDRAGANDDROPTARGET_H_INCLUDED
+
+/**
+    Components derived from this class can have files dropped onto them by an external application.
+
+    @see DragAndDropContainer
+*/
+class JUCE_API  FileDragAndDropTarget
+{
+public:
+    /** Destructor. */
+    virtual ~FileDragAndDropTarget()  {}
+
+    /** Callback to check whether this target is interested in the set of files being offered.
+
+        Note that this will be called repeatedly when the user is dragging the mouse around over your
+        component, so don't do anything time-consuming in here, like opening the files to have a look
+        inside them!
+
+        @param files        the set of (absolute) pathnames of the files that the user is dragging
+        @returns            true if this component wants to receive the other callbacks regarging this
+                            type of object; if it returns false, no other callbacks will be made.
+    */
+    virtual bool isInterestedInFileDrag (const StringArray& files) = 0;
+
+    /** Callback to indicate that some files are being dragged over this component.
+
+        This gets called when the user moves the mouse into this component while dragging.
+
+        Use this callback as a trigger to make your component repaint itself to give the
+        user feedback about whether the files can be dropped here or not.
+
+        @param files        the set of (absolute) pathnames of the files that the user is dragging
+        @param x            the mouse x position, relative to this component
+        @param y            the mouse y position, relative to this component
+    */
+    virtual void fileDragEnter (const StringArray& files, int x, int y);
+
+    /** Callback to indicate that the user is dragging some files over this component.
+
+        This gets called when the user moves the mouse over this component while dragging.
+        Normally overriding itemDragEnter() and itemDragExit() are enough, but
+        this lets you know what happens in-between.
+
+        @param files        the set of (absolute) pathnames of the files that the user is dragging
+        @param x            the mouse x position, relative to this component
+        @param y            the mouse y position, relative to this component
+    */
+    virtual void fileDragMove (const StringArray& files, int x, int y);
+
+    /** Callback to indicate that the mouse has moved away from this component.
+
+        This gets called when the user moves the mouse out of this component while dragging
+        the files.
+
+        If you've used fileDragEnter() to repaint your component and give feedback, use this
+        as a signal to repaint it in its normal state.
+
+        @param files        the set of (absolute) pathnames of the files that the user is dragging
+    */
+    virtual void fileDragExit (const StringArray& files);
+
+    /** Callback to indicate that the user has dropped the files onto this component.
+
+        When the user drops the files, this get called, and you can use the files in whatever
+        way is appropriate.
+
+        Note that after this is called, the fileDragExit method may not be called, so you should
+        clean up in here if there's anything you need to do when the drag finishes.
+
+        @param files        the set of (absolute) pathnames of the files that the user is dragging
+        @param x            the mouse x position, relative to this component
+        @param y            the mouse y position, relative to this component
+    */
+    virtual void filesDropped (const StringArray& files, int x, int y) = 0;
+};
+
+
+#endif   // JUCE_FILEDRAGANDDROPTARGET_H_INCLUDED