diff options
| author | Manolo Gouy <Manolo> | 2012-06-10 12:33:04 +0000 |
|---|---|---|
| committer | Manolo Gouy <Manolo> | 2012-06-10 12:33:04 +0000 |
| commit | 25b66914d5d798eb858c417e3101164c99e6386a (patch) | |
| tree | 158404e07620e2e7ecb9aa64b314107d06032b7c | |
| parent | 2e2e637c2f7a149fed562fe0f92f8673f2b41373 (diff) | |
Document that the dropping of filenames under X11 produces a URL-encoded, UTF_8 string.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@9584 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
| -rw-r--r-- | documentation/src/events.dox | 12 |
1 files changed, 10 insertions, 2 deletions
diff --git a/documentation/src/events.dox b/documentation/src/events.dox index 3183f94eb..b9ba877e3 100644 --- a/documentation/src/events.dox +++ b/documentation/src/events.dox @@ -265,8 +265,16 @@ selection indication. Most modern programs ignore this. FLTK supports drag and drop of text and files from any application on the desktop to an FLTK widget. Text is transferred using UTF-8 encoding. Files are received as a list of full path -and file names, separated by newline. On some platforms, path -names are prepended with <tt>%file://</tt>. +and file names, separated by newline. + +On some X11 platforms, files are received as a URL-encoded UTF-8 string, +that is, non-ASCII bytes (and a few others such as space and %) are +replaced by the 3 bytes "%XY" where XY are the byte's hexadecimal value. +The \ref fl_decode_uri() function can be used to transform in-place +the received string into a proper UTF-8 string. On these platforms, +strings corresponding to dropped files are further prepended +by <tt>file://</tt> (or other prefixes such as <tt>computer://</tt>). + See Fl::dnd() for drag and drop from an FLTK widget. The drag and drop data is available in Fl::event_text() |