changeset 5460:f3940e0bd74d

[DOC-ONLY]: RT-32524: DataFormat clarifies accepted format values
author Pavel Safrata <pavel.safrata@oracle.com>
date Mon, 21 Oct 2013 12:32:46 +0100
parents 4d2baac37b29
children 8b5c116a1f6b
files modules/graphics/src/main/java/javafx/scene/input/DataFormat.java
diffstat 1 files changed, 7 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/modules/graphics/src/main/java/javafx/scene/input/DataFormat.java	Mon Oct 21 12:58:16 2013 +0300
+++ b/modules/graphics/src/main/java/javafx/scene/input/DataFormat.java	Mon Oct 21 12:32:46 2013 +0100
@@ -117,6 +117,13 @@
      *
      * With the above code, if I were to look on the clipboard, I'd find the String "Hello"
      * listed both for "text/foo" and "text/bar" on the clipboard.
+     *
+     * <p>
+     * Note that the ids may be subject to platform restrictions in some cases.
+     * For instance, Swing requires a mime type so if an {@code id} is not
+     * of the "type/subtype" format it won't be possible
+     * to drag data of this type from/to {@link javafx.embed.swing.JFXPanel}.
+     * </p>
      * @param ids The set of ids used to represent this DataFormat on the clipboard.
      * @throws IllegalArgumentException if one of the given mime types is already
      *         assigned to another DataFormat.