# DropEvent

description
  a drop event will be returned to processing whenever you drop a file or a folder onto your running sketch or application.

+Example

      /**
       * basic example of a drop event and its contained informations.
       * drag an image, a file, a folder, a link into the sketch and see
       * what information the console spits out.
       * code by andreas schlegel. http://www.sojamo.de/libraries/drop
      */
      import sojamo.drop.*;

      SDrop drop;

      void setup() {
        size(400,400);
          frameRate(30);
        drop = new SDrop(this);
      }

      void draw() {
        background(0);
      }

      void dropEvent(DropEvent theDropEvent) {
        // returns a string e.g. if you drag text from a texteditor
        // into the sketch this can be handy.
        println("toString()\t"+theDropEvent.toString());

        // returns true if the dropped object is an image from
        // the harddisk or the browser.
        println("isImage()\t"+theDropEvent.isImage());

        // returns true if the dropped object is a file or folder.
        println("isFile()\t"+theDropEvent.isFile());

        // if the dropped object is a file or a folder you
        // can access it with file() . for more information see
        // http://java.sun.com/j2se/1.4.2/docs/api/java/io/File.html
        println("file()\t"+theDropEvent.file());

        // returns true if the dropped object is a bookmark, a link, or a url.
        println("isURL()\t"+theDropEvent.isURL());

        // returns the url as string.
        println("url()\t"+theDropEvent.url());

        // returns the DropTargetDropEvent, for further information see
        // http://java.sun.com/j2se/1.4.2/docs/api/java/awt/dnd/DropTargetDropEvent.html
        println("dropTargetDropEvent()\t"+theDropEvent.dropTargetDropEvent());
      }

Methods

component ( )
  get the component of the drop event.

dropTargetDropEvent ( )
  get the DropTargetDropEvent of the drop event. take a look at the documentation at api/java/awt/dnd/DropTargetDropEvent

file ( )
  when dropping a file or a folder onto the applet you get a java File back. for accessing the content of this file please see the java documentation at api/java/io/File before making a call to the file() method, make sure the File is not null. you can check this with the theDropEvent.isFile() method, which will return true or false.

filePath ( )
  filePath returns the absolute path of a file.

isFile ( )
  check if the drop event was of type java.io.File.

isImage ( )
  check if drop event is an image of type java.awt.Image

isURL ( )
  check if drop event is an url, e.g. and url drag/dropped from a browser.

listFiles ( )
  list files in a folder, recursive is optional, use true or false. to list with a limited depth use an int between 0 and n. taken from http://snippets.dzone.com/posts/show/1875

listFilesAsArray ( )
  list files in a folder, recursive is optional, use true or false. to list with a limited depth use an int between 0 and n. taken from http://snippets.dzone.com/posts/show/1875

loadImage ( )
  load an image from an URL or from a harddisk. before calling loadImage(), check with isImage() if there is an image available.

text ( )
  when dropping text onto the applet you can access the text with the getText() method.

url ( )
  if an URL was dropped onto the applet the url() method returns the same as String.

x ( )
  get the x coordinate where the object was dropped.

y ( )
  get the y coordinate where the object was dropped.

usage
  Web & Application

related