Class JTree.DropLocation

java.lang.Object
javax.swing.TransferHandler.DropLocation
javax.swing.JTree.DropLocation
Enclosing class:
JTree
public static final class JTree.DropLocation extends TransferHandler.DropLocation
A subclass of TransferHandler.DropLocation representing a drop location for a JTree.
Since:
1.6
See Also:

  • Method Summary

    Modifier and Type
    Method
    Description
    int
    getChildIndex()
    Returns the index where the dropped data should be inserted with respect to the path returned by getPath().
    TreePath
    getPath()
    Returns the path where dropped data should be placed in the tree.
    String
    toString()
    Returns a string representation of this drop location.

    Methods declared in class TransferHandler.DropLocation

    getDropPoint
    Modifier and Type
    Method
    Description
    final Point
    getDropPoint()
    Returns the drop point, representing the mouse's current location within the component.

    Methods declared in class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    clone()
    Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
    boolean
    equals(Object o)
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    getClass()
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    int
    hashCode()
    Answers an integer hash code for the receiver.
    final void
    notify()
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    notifyAll()
    Causes all threads which are waiting on the receiver to be made ready to run.
    final void
    wait()
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

  • Method Details

    • getChildIndex

      public int getChildIndex()
      Returns the index where the dropped data should be inserted with respect to the path returned by getPath().

      For drop modes DropMode.USE_SELECTION and DropMode.ON, this index is unimportant (and it will always be -1) as the only interesting data is the path over which the drop operation occurred.

      For drop mode DropMode.INSERT, this index indicates the index at which the data should be inserted into the parent path represented by getPath(). -1 indicates that the drop occurred over the parent itself, and in most cases should be treated as inserting into either the beginning or the end of the parent's list of children.

      For DropMode.ON_OR_INSERT, this value will be an insert index, as described above, or -1 if the drop occurred over the path itself.

      Returns:
      the child index
      See Also:

    • getPath

      public TreePath getPath()
      Returns the path where dropped data should be placed in the tree.

      Interpretation of this value depends on the drop mode set on the component. If the drop mode is DropMode.USE_SELECTION or DropMode.ON, the return value is the path in the tree over which the data has been (or will be) dropped. null indicates that the drop is over empty space, not associated with a particular path.

      If the drop mode is DropMode.INSERT, the return value refers to the path that should become the parent of the new data, in which case getChildIndex() indicates where the new item should be inserted into this parent path. A null path indicates that no parent path has been determined, which can happen for multiple reasons:

      • The tree has no model
      • There is no root in the tree
      • The root is collapsed
      • The root is a leaf node
      It is up to the developer to decide if and how they wish to handle the null case.

      If the drop mode is DropMode.ON_OR_INSERT, getChildIndex can be used to determine whether the drop is on top of the path itself (-1) or the index at which it should be inserted into the path (values other than -1).

      Returns:
      the drop path
      See Also:

    • toString

      public String toString()
      Returns a string representation of this drop location. This method is intended to be used for debugging purposes, and the content and format of the returned string may vary between implementations.
      Overrides:
      toString in class TransferHandler.DropLocation
      Returns:
      a string representation of this drop location