ui.DragDrop.getBuffer
Get drag & drop data from the buffer.
Syntax
getBuffer()
RETURNS STRING
Usage
After identifying the MIME type of a dropped object with getSelectedMimeType()
,
you can call the getBuffer()
method to get text data from the drag & drop
buffer.
Drag & drop data is only available at ON DROP
time, therefore, the
getBuffer()
method must be called in ON DROP
only.
When using URI MIME types (for file paths for example), the string
returned from the getBuffer()
method can contain URL-encoded characters such as
%5E
, which represents the ^
caret. Therefore, you must URL-decode
strings returned from getBuffer()
with util.Strings.urlDecode()
. When
setting the drag & drop buffer content, if required by the front-end platform, the string can be
URL-encoded using util.Strings.urlEncode()
for setBuffer()
. However, URL-encoding
file paths for setBuffer()
is usually not required.