JTree
public static final class JTree.DropLocation extends TransferHandler.DropLocation
TransferHandler.DropLocation
representing a drop location for a JTree
.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. |
getDropPoint
public int getChildIndex()
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.
public TreePath getPath()
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:
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
).
public String toString()
toString
in class TransferHandler.DropLocation
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/JTree.DropLocation.html