corpus-services
1.0
|
Classes | |
class | Event |
interface | Listener |
class | TransferableObject |
Public Member Functions | |
FileDrop (final java.awt.Component c, final Listener listener) | |
FileDrop (final java.awt.Component c, final boolean recursive, final Listener listener) | |
FileDrop (final java.io.PrintStream out, final java.awt.Component c, final Listener listener) | |
FileDrop (final java.io.PrintStream out, final java.awt.Component c, final boolean recursive, final Listener listener) | |
FileDrop (final java.awt.Component c, final javax.swing.border.Border dragBorder, final Listener listener) | |
FileDrop (final java.awt.Component c, final javax.swing.border.Border dragBorder, final boolean recursive, final Listener listener) | |
FileDrop (final java.io.PrintStream out, final java.awt.Component c, final javax.swing.border.Border dragBorder, final Listener listener) | |
FileDrop (final java.io.PrintStream out, final java.awt.Component c, final javax.swing.border.Border dragBorder, final boolean recursive, final Listener listener) | |
Static Public Member Functions | |
static boolean | remove (java.awt.Component c) |
static boolean | remove (java.io.PrintStream out, java.awt.Component c, boolean recursive) |
This class makes it easy to drag and drop files from the operating system to a Java program. Any java.awt.Component
can be dropped onto, but only javax.swing.JComponent
s will indicate the drop event with a changed border.
To use this class, construct a new FileDrop
by passing it the target component and a Listener
to receive notification when file(s) have been dropped. Here is an example:
JPanel myPanel = new JPanel(); new FileDrop( myPanel, new FileDrop.Listener() { public void filesDropped( java.io.File[] files ) { // handle file drop ... } // end filesDropped }); // end FileDrop.Listener
You can specify the border that will appear when files are being dragged by calling the constructor with a javax.swing.border.Border
. Only JComponent
s will show any indication with a border.
You can turn on some debugging features by passing a PrintStream
object (such as System.out
) into the full constructor. A null
value will result in no extra debugging information being output.
I'm releasing this code into the Public Domain. Enjoy.
Original author: Robert Harder, rhard er@u sa.ne t
2007-09-12 Nathan Blomquist – Linux (KDE/Gnome) support added.
Definition at line 50 of file FileDrop.java.
de.uni_hamburg.corpora.swing.FileDrop.FileDrop | ( | final java.awt.Component | c, |
final Listener | listener | ||
) |
Constructs a FileDrop with a default light-blue border and, if c is a java.awt.Container, recursively sets all elements contained within as drop targets, though only the top level container will change borders.
c | Component on which files will be dropped. |
listener | Listens for filesDropped . |
Definition at line 72 of file FileDrop.java.
de.uni_hamburg.corpora.swing.FileDrop.FileDrop | ( | final java.awt.Component | c, |
final boolean | recursive, | ||
final Listener | listener | ||
) |
Constructor with a default border and the option to recursively set drop targets. If your component is a java.awt.Container
, then each of its children components will also listen for drops, though only the parent will change borders.
c | Component on which files will be dropped. |
recursive | Recursively set children as drop targets. |
listener | Listens for filesDropped . |
Definition at line 95 of file FileDrop.java.
de.uni_hamburg.corpora.swing.FileDrop.FileDrop | ( | final java.io.PrintStream | out, |
final java.awt.Component | c, | ||
final Listener | listener | ||
) |
Constructor with a default border and debugging optionally turned on. With Debugging turned on, more status messages will be displayed to out
. A common way to use this constructor is with System.out
or System.err
. A null
value for the parameter out
will result in no debugging output.
out | PrintStream to record debugging info or null for no debugging. |
out | |
c | Component on which files will be dropped. |
listener | Listens for filesDropped . |
Definition at line 120 of file FileDrop.java.
de.uni_hamburg.corpora.swing.FileDrop.FileDrop | ( | final java.io.PrintStream | out, |
final java.awt.Component | c, | ||
final boolean | recursive, | ||
final Listener | listener | ||
) |
Constructor with a default border, debugging optionally turned on and the option to recursively set drop targets. If your component is a java.awt.Container
, then each of its children components will also listen for drops, though only the parent will change borders. With Debugging turned on, more status messages will be displayed to out
. A common way to use this constructor is with System.out
or System.err
. A null
value for the parameter out
will result in no debugging output.
out | PrintStream to record debugging info or null for no debugging. |
out | |
c | Component on which files will be dropped. |
recursive | Recursively set children as drop targets. |
listener | Listens for filesDropped . |
Definition at line 150 of file FileDrop.java.
de.uni_hamburg.corpora.swing.FileDrop.FileDrop | ( | final java.awt.Component | c, |
final javax.swing.border.Border | dragBorder, | ||
final Listener | listener | ||
) |
Constructor with a specified border
c | Component on which files will be dropped. |
dragBorder | Border to use on JComponent when dragging occurs. |
listener | Listens for filesDropped . |
Definition at line 173 of file FileDrop.java.
de.uni_hamburg.corpora.swing.FileDrop.FileDrop | ( | final java.awt.Component | c, |
final javax.swing.border.Border | dragBorder, | ||
final boolean | recursive, | ||
final Listener | listener | ||
) |
Constructor with a specified border and the option to recursively set drop targets. If your component is a java.awt.Container
, then each of its children components will also listen for drops, though only the parent will change borders.
c | Component on which files will be dropped. |
dragBorder | Border to use on JComponent when dragging occurs. |
recursive | Recursively set children as drop targets. |
listener | Listens for filesDropped . |
Definition at line 199 of file FileDrop.java.
de.uni_hamburg.corpora.swing.FileDrop.FileDrop | ( | final java.io.PrintStream | out, |
final java.awt.Component | c, | ||
final javax.swing.border.Border | dragBorder, | ||
final Listener | listener | ||
) |
Constructor with a specified border and debugging optionally turned on. With Debugging turned on, more status messages will be displayed to out
. A common way to use this constructor is with System.out
or System.err
. A null
value for the parameter out
will result in no debugging output.
out | PrintStream to record debugging info or null for no debugging. |
c | Component on which files will be dropped. |
dragBorder | Border to use on JComponent when dragging occurs. |
listener | Listens for filesDropped . |
Definition at line 227 of file FileDrop.java.
de.uni_hamburg.corpora.swing.FileDrop.FileDrop | ( | final java.io.PrintStream | out, |
final java.awt.Component | c, | ||
final javax.swing.border.Border | dragBorder, | ||
final boolean | recursive, | ||
final Listener | listener | ||
) |
Full constructor with a specified border and debugging optionally turned on. With Debugging turned on, more status messages will be displayed to out
. A common way to use this constructor is with System.out
or System.err
. A null
value for the parameter out
will result in no debugging output.
out | PrintStream to record debugging info or null for no debugging. |
c | Component on which files will be dropped. |
dragBorder | Border to use on JComponent when dragging occurs. |
recursive | Recursively set children as drop targets. |
listener | Listens for filesDropped . |
Definition at line 258 of file FileDrop.java.
|
static |
Removes the drag-and-drop hooks from the component and optionally from the all children. You should call this if you add and remove components after you've set up the drag-and-drop. This will recursively unregister all components contained within c if c is a java.awt.Container.
c | The component to unregister as a drop target |
Definition at line 568 of file FileDrop.java.
|
static |
Removes the drag-and-drop hooks from the component and optionally from the all children. You should call this if you add and remove components after you've set up the drag-and-drop.
out | Optional java.io.PrintStream for logging drag and drop messages |
c | The component to unregister |
recursive | Recursively unregister components within a container |
Definition at line 584 of file FileDrop.java.