]> code.delx.au - gnu-emacs/blob - lisp/x-dnd.el
* x-dnd.el: Mention support for Motif in commentary.
[gnu-emacs] / lisp / x-dnd.el
1 ;;; x-dnd.el --- drag and drop support for X.
2
3 ;; Copyright (C) 2004
4 ;; Free Software Foundation, Inc.
5
6 ;; Author: Jan Dj\e,Ad\e(Brv <jan.h.d@swipnet.se>
7 ;; Maintainer: FSF
8 ;; Keywords: window, drag, drop
9
10 ;; This file is part of GNU Emacs.
11
12 ;; GNU Emacs is free software; you can redistribute it and/or modify
13 ;; it under the terms of the GNU General Public License as published by
14 ;; the Free Software Foundation; either version 2, or (at your option)
15 ;; any later version.
16
17 ;; GNU Emacs is distributed in the hope that it will be useful,
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 ;; GNU General Public License for more details.
21
22 ;; You should have received a copy of the GNU General Public License
23 ;; along with GNU Emacs; see the file COPYING. If not, write to the
24 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
25 ;; Boston, MA 02111-1307, USA.
26
27 ;;; Commentary:
28
29 ;; This file provides the drop part only. Currently supported protocols
30 ;; are XDND, Motif and the old KDE 1.x protocol.
31
32 ;;; Code:
33
34 ;;; Customizable variables
35
36
37 (defcustom x-dnd-test-function 'x-dnd-default-test-function
38 "The function drag and drop uses to determine if to accept or reject a drop.
39 The function takes three arguments, WINDOW ACTION and TYPES.
40 WINDOW is where the mouse is when the function is called. WINDOW may be a
41 frame if the mouse isn't over a real window (i.e. menu bar, tool bar or
42 scroll bar). ACTION is the suggested action from the drag and drop source,
43 one of the symbols move, copy link or ask. TYPES is a list of available types
44 for the drop.
45
46 The function shall return nil to reject the drop or a cons with two values,
47 the wanted action as car and the wanted type as cdr. The wanted action
48 can be copy, move, link, ask or private.
49 The default value for this variable is `x-dnd-default-test-function'."
50 :type 'symbol
51 :group 'x)
52
53 (defcustom x-dnd-protocol-alist
54 '(
55 ("^file:///" . x-dnd-open-local-file) ; XDND format.
56 ("^file://" . x-dnd-open-file) ; URL with host
57 ("^file:" . x-dnd-open-local-file) ; Old KDE, Motif, Sun
58 )
59
60 "The functions to call for different protocols when a drop is made.
61 This variable is used by `x-dnd-handle-uri-list' and `x-dnd-handle-moz-url'.
62 The list contains of (REGEXP . FUNCTION) pairs.
63 The functions shall take two arguments, URL, which is the URL dropped and
64 ACTION which is the action to be performed for the drop (move, copy, link,
65 private or ask).
66 If no match is found here, and the value of `browse-url-browser-function'
67 is a pair of (REGEXP . FUNCTION), those regexps are tried for a match.
68 Insertion of text is not handeled by these functions, see `x-dnd-types-alist'
69 for that.
70 The function shall return the action done (move, copy, link or private)
71 if some action was made, or nil if the URL is ignored."
72 :type 'alist
73 :group 'x)
74
75
76 (defcustom x-dnd-types-alist
77 '(
78 ("text/uri-list" . x-dnd-handle-uri-list)
79 ("text/x-moz-url" . x-dnd-handle-moz-url)
80 ("_NETSCAPE_URL" . x-dnd-handle-uri-list)
81 ("FILE_NAME" . x-dnd-handle-file-name)
82 ("UTF8_STRING" . x-dnd-insert-utf8-text)
83 ("text/plain;charset=UTF-8" . x-dnd-insert-utf8-text)
84 ("text/plain;charset=utf-8" . x-dnd-insert-utf8-text)
85 ("text/unicode" . x-dnd-insert-utf16-text)
86 ("text/plain" . x-dnd-insert-text)
87 ("COMPOUND_TEXT" . x-dnd-insert-ctext)
88 ("STRING" . x-dnd-insert-text)
89 ("TEXT" . x-dnd-insert-text)
90 )
91 "Which function to call to handle a drop of that type.
92 If the type for the drop is not present, or the function is nil,
93 the drop is rejected. The function takes three arguments, WINDOW, ACTION
94 and DATA. WINDOW is where the drop occured, ACTION is the action for
95 this drop (copy, move, link, private or ask) as determined by a previous
96 call to `x-dnd-test-function'. DATA is the drop data.
97 The function shall return the action used (copy, move, link or private) if drop
98 is successful, nil if not."
99 :type 'alist
100 :group 'x)
101
102 (defcustom x-dnd-open-file-other-window nil
103 "If non-nil, always use find-file-other-window to open dropped files."
104 :type 'boolean
105 :group 'x)
106
107 ;; Internal variables
108
109 (defvar x-dnd-known-types
110 '("text/uri-list"
111 "text/x-moz-url"
112 "_NETSCAPE_URL"
113 "FILE_NAME"
114 "UTF8_STRING"
115 "text/plain;charset=UTF-8"
116 "text/plain;charset=utf-8"
117 "text/unicode"
118 "text/plain"
119 "COMPOUND_TEXT"
120 "STRING"
121 "TEXT"
122 )
123 "The types accepted by default for dropped data.
124 The types are chosen in the order they appear in the list.")
125
126 (defvar x-dnd-current-state nil
127 "The current state for a drop.
128 This is an alist with one entry for each display. The value for each display
129 is a vector that contains the state for drag and drop for that display.
130 Elements in the vector are:
131 Last buffer drag was in,
132 last window drag was in,
133 types available for drop,
134 the action suggested by the source,
135 the type we want for the drop,
136 the action we want for the drop,
137 any protocol specific data.")
138
139 (defvar x-dnd-empty-state [nil nil nil nil nil nil nil])
140
141
142
143 (defun x-dnd-init-frame (&optional frame)
144 "Setup drag and drop for FRAME (i.e. create appropriate properties)."
145 (x-dnd-init-xdnd-for-frame frame)
146 (x-dnd-init-motif-for-frame frame))
147
148 (defun x-dnd-get-state-cons-for-frame (frame-or-window)
149 "Return the entry in x-dnd-current-state for a frame or window."
150 (let* ((frame (if (framep frame-or-window) frame-or-window
151 (window-frame frame-or-window)))
152 (display (frame-parameter frame 'display)))
153 (if (not (assoc display x-dnd-current-state))
154 (push (cons display (copy-sequence x-dnd-empty-state))
155 x-dnd-current-state))
156 (assoc display x-dnd-current-state)))
157
158 (defun x-dnd-get-state-for-frame (frame-or-window)
159 "Return the state in x-dnd-current-state for a frame or window."
160 (cdr (x-dnd-get-state-cons-for-frame frame-or-window)))
161
162 (defun x-dnd-default-test-function (window action types)
163 "The default test function for drag and drop.
164 WINDOW is where the mouse is when this function is called. It may be a frame
165 if the mouse is over the menu bar, scroll bar or tool bar.
166 ACTION is the suggested action from the source, and TYPES are the
167 types the drop data can have. This function only accepts drops with
168 types in `x-dnd-known-types'. It always returns the action private."
169 (let ((type (x-dnd-choose-type types)))
170 (when type (cons 'private type))))
171
172
173 (defun x-dnd-current-type (frame-or-window)
174 "Return the type we want the DND data to be in for the current drop.
175 FRAME-OR-WINDOW is the frame or window that the mouse is over."
176 (aref (x-dnd-get-state-for-frame frame-or-window) 4))
177
178 (defun x-dnd-forget-drop (frame-or-window)
179 "Remove all state for the last drop.
180 FRAME-OR-WINDOW is the frame or window that the mouse is over."
181 (setcdr (x-dnd-get-state-cons-for-frame frame-or-window)
182 (copy-sequence x-dnd-empty-state)))
183
184 (defun x-dnd-maybe-call-test-function (window action)
185 "Call `x-dnd-test-function' if something has changed.
186 WINDOW is the window the mouse is over. ACTION is the suggested
187 action from the source. If nothing has changed, return the last
188 action and type we got from `x-dnd-test-function'."
189 (let ((buffer (when (and (windowp window) (window-live-p window))
190 (window-buffer window)))
191 (current-state (x-dnd-get-state-for-frame window)))
192 (when (or (not (equal buffer (aref current-state 0)))
193 (not (equal window (aref current-state 1)))
194 (not (equal action (aref current-state 3))))
195 (save-excursion
196 (when buffer (set-buffer buffer))
197 (let* ((action-type (funcall x-dnd-test-function
198 window
199 action
200 (aref current-state 2)))
201 (handler (cdr (assoc (cdr action-type) x-dnd-types-alist))))
202 ;; Ignore action-type if we have no handler.
203 (setq current-state
204 (x-dnd-save-state window
205 action
206 (when handler action-type)))))))
207 (let ((current-state (x-dnd-get-state-for-frame window)))
208 (cons (aref current-state 5)
209 (aref current-state 4))))
210
211 (defun x-dnd-save-state (window action action-type &optional types extra-data)
212 "Save the state of the current drag and drop.
213 WINDOW is the window the mouse is over. ACTION is the action suggested
214 by the source. ACTION-TYPE is the result of calling `x-dnd-test-function'.
215 If given, TYPES are the types for the drop data that the source supports.
216 EXTRA-DATA is data needed for a specific protocol."
217 (let ((current-state (x-dnd-get-state-for-frame window)))
218 (aset current-state 5 (car action-type))
219 (aset current-state 4 (cdr action-type))
220 (aset current-state 3 action)
221 (when types (aset current-state 2 types))
222 (when extra-data (aset current-state 6 extra-data))
223 (aset current-state 1 window)
224 (aset current-state 0 (if (and (windowp window)
225 (window-live-p window))
226 (window-buffer window) nil))
227 (setcdr (x-dnd-get-state-cons-for-frame window) current-state)))
228
229
230 (defun x-dnd-handle-one-url (window action arg)
231 "Handle one dropped url by calling the appropriate handler.
232 The handler is first localted by looking at `x-dnd-protocol-alist'.
233 If no match is found here, and the value of `browse-url-browser-function'
234 is a pair of (REGEXP . FUNCTION), those regexps are tried for a match.
235 If no match is found, just call `x-dnd-insert-text'.
236 WINDOW is where the drop happend, ACTION is the action for the drop,
237 ARG is the URL that has been dropped.
238 Returns ACTION."
239 (require 'browse-url)
240 (let* ((uri (replace-regexp-in-string
241 "%[A-Z0-9][A-Z0-9]"
242 (lambda (arg)
243 (format "%c" (string-to-number (substring arg 1) 16)))
244 arg))
245 ret)
246 (or
247 (catch 'done
248 (dolist (bf x-dnd-protocol-alist)
249 (when (string-match (car bf) uri)
250 (setq ret (funcall (cdr bf) uri action))
251 (throw 'done t)))
252 nil)
253 (when (not (functionp browse-url-browser-function))
254 (catch 'done
255 (dolist (bf browse-url-browser-function)
256 (when (string-match (car bf) uri)
257 (setq ret 'private)
258 (funcall (cdr bf) uri action)
259 (throw 'done t)))
260 nil))
261 (progn
262 (x-dnd-insert-text window action uri)
263 (setq ret 'private)))
264 ret))
265
266
267 (defun x-dnd-get-local-file-uri (uri)
268 "Return an uri converted to file:/// syntax if uri is a local file.
269 Return nil if URI is not a local file."
270
271 ;; The hostname may be our hostname, in that case, convert to a local
272 ;; file. Otherwise return nil. TODO: How about an IP-address as hostname?
273 (let ((hostname (when (string-match "^file://\\([^/]*\\)" uri)
274 (downcase (match-string 1 uri))))
275 (system-name-no-dot
276 (downcase (if (string-match "^[^\\.]+" system-name)
277 (match-string 0 system-name)
278 system-name))))
279 (when (and hostname
280 (or (string-equal "localhost" hostname)
281 (string-equal (downcase system-name) hostname)
282 (string-equal system-name-no-dot hostname)))
283 (concat "file://" (substring uri (+ 7 (length hostname)))))))
284
285 (defun x-dnd-get-local-file-name (uri &optional must-exist)
286 "Return file name converted from file:/// or file: syntax.
287 URI is the uri for the file. If MUST-EXIST is given and non-nil,
288 only return non-nil if the file exists.
289 Return nil if URI is not a local file."
290 (let ((f (cond ((string-match "^file:///" uri) ; XDND format.
291 (substring uri (1- (match-end 0))))
292 ((string-match "^file:" uri) ; Old KDE, Motif, Sun
293 (substring uri (match-end 0))))))
294 (when (and f must-exist)
295 (let* ((decoded-f (decode-coding-string
296 f
297 (or file-name-coding-system
298 default-file-name-coding-system)))
299 (try-f (if (file-readable-p decoded-f) decoded-f f)))
300 (when (file-readable-p try-f) try-f)))))
301
302
303 (defun x-dnd-open-local-file (uri action)
304 "Open a local file.
305 The file is opened in the current window, or a new window if
306 `x-dnd-open-file-other-window' is set. URI is the url for the file,
307 and must have the format file:file-name or file:///file-name.
308 The last / in file:/// is part of the file name. ACTION is ignored."
309
310 (let* ((f (x-dnd-get-local-file-name uri t)))
311 (when f
312 (if (file-readable-p f)
313 (progn
314 (if x-dnd-open-file-other-window
315 (find-file-other-window f)
316 (find-file f))
317 'private)
318 (error "Can not read %s (%s)" f uri)))))
319
320 (defun x-dnd-open-file (uri action)
321 "Open a local or remote file.
322 The file is opened in the current window, or a new window if
323 `x-dnd-open-file-other-window' is set. URI is the url for the file,
324 and must have the format file://hostname/file-name. ACTION is ignored.
325 The last / in file://hostname/ is part of the file name."
326
327 ;; The hostname may be our hostname, in that case, convert to a local
328 ;; file. Otherwise return nil.
329 (let ((local-file (x-dnd-get-local-file-uri uri)))
330 (when local-file (x-dnd-open-local-file local-file action))))
331
332
333 (defun x-dnd-handle-moz-url (window action data)
334 "Handle one item of type text/x-moz-url.
335 WINDOW is the window where the drop happened. ACTION is ignored.
336 DATA is the moz-url, which is formatted as two strings separated by \r\n.
337 The first string is the URL, the second string is the title of that URL.
338 DATA is encoded in utf-16. Decode the URL and call `x-dnd-handle-uri-list'."
339 (let* ((string (decode-coding-string data 'utf-16le)) ;; ALWAYS LE???
340 (strings (split-string string "[\r\n]" t))
341 ;; Can one drop more than one moz-url ?? Assume not.
342 (url (car strings))
343 (title (car (cdr strings))))
344 (x-dnd-handle-uri-list window action url)))
345
346 (defun x-dnd-insert-utf8-text (window action text)
347 "Decode the UTF-8 text and insert it at point.
348 TEXT is the text as a string, WINDOW is the window where the drop happened."
349 (x-dnd-insert-text window action (decode-coding-string text 'utf-8)))
350
351 (defun x-dnd-insert-utf16-text (window action text)
352 "Decode the UTF-16 text and insert it at point.
353 TEXT is the text as a string, WINDOW is the window where the drop happened."
354 (x-dnd-insert-text window action (decode-coding-string text 'utf-16le)))
355
356 (defun x-dnd-insert-ctext (window action text)
357 "Decode the compound text and insert it at point.
358 TEXT is the text as a string, WINDOW is the window where the drop happened."
359 (x-dnd-insert-text window action
360 (decode-coding-string text
361 'compound-text-with-extensions)))
362
363 (defun x-dnd-insert-text (window action text)
364 "Insert text at point or push to the kill ring if buffer is read only.
365 TEXT is the text as a string, WINDOW is the window where the drop happened."
366 (if (or buffer-read-only
367 (not (windowp window)))
368 (progn
369 (kill-new text)
370 (message
371 (substitute-command-keys
372 "The dropped text can be accessed with \\[yank]")))
373 (insert text))
374 action)
375
376 (defun x-dnd-handle-uri-list (window action string)
377 "Split an uri-list into separate URIs and call `x-dnd-handle-one-url'.
378 WINDOW is the window where the drop happened.
379 STRING is the uri-list as a string. The URIs are separated by \r\n."
380 (let ((uri-list (split-string string "[\0\r\n]" t))
381 retval)
382 (dolist (bf uri-list)
383 ;; If one URL is handeled, treat as if the whole drop succeeded.
384 (let ((did-action (x-dnd-handle-one-url window action bf)))
385 (when did-action (setq retval did-action))))
386 retval))
387
388 (defun x-dnd-handle-file-name (window action string)
389 "Prepend file:// to file names and call `x-dnd-handle-one-url'.
390 WINDOW is the window where the drop happened.
391 STRING is the file names as a string, separated by nulls."
392 (let ((uri-list (split-string string "[\0\r\n]" t))
393 retval)
394 (dolist (bf uri-list)
395 ;; If one URL is handeled, treat as if the whole drop succeeded.
396 (let* ((file-uri (concat "file://" bf))
397 (did-action (x-dnd-handle-one-url window action file-uri)))
398 (when did-action (setq retval did-action))))
399 retval))
400
401
402 (defun x-dnd-choose-type (types &optional known-types)
403 "Choose which type we want to receive for the drop.
404 TYPES are the types the source of the drop offers, a vector of type names
405 as strings or symbols. Select among the types in `x-dnd-known-types' or
406 KNOWN-TYPES if given, and return that type name.
407 If no suitable type is found, return nil."
408 (let* ((known-list (or known-types x-dnd-known-types))
409 (first-known-type (car known-list))
410 (types-array types)
411 (found (when first-known-type
412 (catch 'done
413 (dotimes (i (length types-array))
414 (let* ((type (aref types-array i))
415 (typename (if (symbolp type)
416 (symbol-name type) type)))
417 (when (equal first-known-type typename)
418 (throw 'done first-known-type))))
419 nil))))
420
421 (if (and (not found) (cdr known-list))
422 (x-dnd-choose-type types (cdr known-list))
423 found)))
424
425 (defun x-dnd-drop-data (event frame window data type)
426 "Drop one data item onto a frame.
427 EVENT is the client message for the drop, FRAME is the frame the drop occurred
428 on. WINDOW is the window of FRAME where the drop happened. DATA is the data
429 received from the source, and type is the type for DATA, see
430 `x-dnd-types-alist').
431
432 Returns the action used (move, copy, link, private) if drop was successful,
433 nil if not."
434 (let* ((type-info (assoc type x-dnd-types-alist))
435 (handler (cdr type-info))
436 (state (x-dnd-get-state-for-frame frame))
437 (action (aref state 5))
438 (w (posn-window (event-start event))))
439 (when handler
440 (if (and (windowp w) (window-live-p w))
441 ;; If dropping in a window, open files in that window rather
442 ;; than in a new widow.
443 (let ((x-dnd-open-file-other-window nil))
444 (goto-char (posn-point (event-start event)))
445 (funcall handler window action data))
446 (let ((x-dnd-open-file-other-window t)) ;; Dropping on non-window.
447 (select-frame frame)
448 (funcall handler window action data))))))
449
450 (defun x-dnd-handle-drag-n-drop-event (event)
451 "Receive drag and drop events (X client messages).
452 Currently XDND, Motif and old KDE 1.x protocols are recognized."
453 (interactive "e")
454 (let* ((client-message (car (cdr (cdr event))))
455 (window (posn-window (event-start event)))
456 (message-atom (aref client-message 0))
457 (frame (aref client-message 1))
458 (format (aref client-message 2))
459 (data (aref client-message 3)))
460
461 (cond ((equal "DndProtocol" message-atom) ; Old KDE 1.x.
462 (x-dnd-handle-old-kde event frame window message-atom format data))
463
464 ((equal "_MOTIF_DRAG_AND_DROP_MESSAGE" message-atom) ; Motif
465 (x-dnd-handle-motif event frame window message-atom format data))
466
467 ((and (> (length message-atom) 4) ; XDND protocol.
468 (equal "Xdnd" (substring message-atom 0 4)))
469 (x-dnd-handle-xdnd event frame window message-atom format data)))))
470
471
472 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
473 ;;; Old KDE protocol. Only dropping of files.
474
475 (defun x-dnd-handle-old-kde (event frame window message format data)
476 "Open the files in a KDE 1.x drop."
477 (let ((values (x-window-property "DndSelection" frame nil 0 t)))
478 (x-dnd-handle-uri-list window 'private
479 (replace-regexp-in-string "\0$" "" values))))
480 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
481
482
483
484 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
485 ;;; XDND protocol.
486
487 (defvar x-dnd-xdnd-to-action
488 '(("XdndActionPrivate" . private)
489 ("XdndActionCopy" . copy)
490 ("XdndActionMove" . move)
491 ("XdndActionLink" . link)
492 ("XdndActionAsk" . ask))
493 "Mapping from XDND action types to lisp symbols.")
494
495 (defun x-dnd-init-xdnd-for-frame (frame)
496 "Set the XdndAware property for FRAME to indicate that we do XDND."
497 (x-change-window-property "XdndAware"
498 '(5) ;; The version of XDND we support.
499 frame "ATOM" 32 t))
500
501 (defun x-dnd-get-drop-width-height (frame w accept)
502 "Return the widht/height to be sent in a XDndStatus message.
503 FRAME is the frame and W is the window where the drop happened.
504 If ACCEPT is nil return 0 (empty rectangle),
505 otherwise if W is a window, return its widht/height,
506 otherwise return the frame width/height."
507 (if accept
508 (if (windowp w) ;; w is not a window if dropping on the menu bar,
509 ;; scroll bar or tool bar.
510 (let ((edges (window-inside-pixel-edges w)))
511 (cons
512 (- (nth 2 edges) (nth 0 edges)) ;; right - left
513 (- (nth 3 edges) (nth 1 edges)))) ;; bottom - top
514 (cons (frame-pixel-width frame)
515 (frame-pixel-height frame)))
516 0))
517
518 (defun x-dnd-get-drop-x-y (frame w)
519 "Return the x/y coordinates to be sent in a XDndStatus message.
520 Coordinates are required to be absolute.
521 FRAME is the frame and W is the window where the drop happened.
522 If W is a window, return its absolute corrdinates,
523 otherwise return the frame coordinates."
524 (let* ((frame-left (frame-parameter frame 'left))
525 ;; If the frame is outside the display, frame-left looks like
526 ;; '(0 -16). Extract the -16.
527 (frame-real-left (if (consp frame-left) (car (cdr frame-left))
528 frame-left))
529 (frame-top (frame-parameter frame 'top))
530 (frame-real-top (if (consp frame-top) (car (cdr frame-top))
531 frame-top)))
532 (if (windowp w)
533 (let ((edges (window-inside-pixel-edges w)))
534 (cons
535 (+ frame-real-left (nth 0 edges))
536 (+ frame-real-top (nth 1 edges))))
537 (cons frame-real-left frame-real-top))))
538
539 (defun x-dnd-handle-xdnd (event frame window message format data)
540 "Receive one XDND event (client message) and send the appropriate reply.
541 EVENT is the client message. FRAME is where the mouse is now.
542 WINDOW is the window within FRAME where the mouse is now.
543 FORMAT is 32 (not used). MESSAGE is the data part of an XClientMessageEvent."
544 (cond ((equal "XdndEnter" message)
545 (let ((version (ash (car (aref data 1)) -8))
546 (more-than-3 (cdr (aref data 1)))
547 (dnd-source (aref data 0)))
548 (x-dnd-save-state
549 window nil nil
550 (if (> more-than-3 0)
551 (x-window-property "XdndTypeList"
552 frame "AnyPropertyType"
553 dnd-source nil t)
554 (vector (x-get-atom-name (aref data 2))
555 (x-get-atom-name (aref data 3))
556 (x-get-atom-name (aref data 4)))))))
557
558 ((equal "XdndPosition" message)
559 (let* ((x (car (aref data 2)))
560 (y (cdr (aref data 2)))
561 (action (x-get-atom-name (aref data 4)))
562 (dnd-source (aref data 0))
563 (dnd-time (aref data 3))
564 (action-type (x-dnd-maybe-call-test-function
565 window
566 (cdr (assoc action x-dnd-xdnd-to-action))))
567 (reply-action (car (rassoc (car action-type)
568 x-dnd-xdnd-to-action)))
569 (accept ;; 1 = accept, 0 = reject
570 (if (and reply-action action-type) 1 0))
571 (list-to-send
572 (list (string-to-number
573 (frame-parameter frame 'outer-window-id))
574 accept ;; 1 = Accept, 0 = reject.
575 (x-dnd-get-drop-x-y frame window)
576 (x-dnd-get-drop-width-height
577 frame window (eq accept 1))
578 (or reply-action 0)
579 )))
580 (x-send-client-message
581 frame dnd-source frame "XdndStatus" 32 list-to-send)
582 ))
583
584 ((equal "XdndLeave" message)
585 (x-dnd-forget-drop window))
586
587 ((equal "XdndDrop" message)
588 (if (windowp window) (select-window window))
589 (let* ((dnd-source (aref data 0))
590 (value (and (x-dnd-current-type window)
591 (x-get-selection-internal
592 'XdndSelection
593 (intern (x-dnd-current-type window)))))
594 success action ret-action)
595
596 (setq action (if value
597 (condition-case info
598 (x-dnd-drop-data event frame window value
599 (x-dnd-current-type window))
600 (error
601 (message "Error: %s" info)
602 nil))))
603
604 (setq success (if action 1 0))
605 (setq ret-action
606 (if (eq success 1)
607 (or (car (rassoc action x-dnd-xdnd-to-action))
608 "XdndActionPrivate")
609 0))
610
611 (x-send-client-message
612 frame dnd-source frame "XdndFinished" 32
613 (list (string-to-number (frame-parameter frame 'outer-window-id))
614 success ;; 1 = Success, 0 = Error
615 (if success "XdndActionPrivate" 0)
616 ))
617 (x-dnd-forget-drop window)))
618
619 (t (error "Unknown XDND message %s %s" message data))))
620
621 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
622 ;;; Motif protocol.
623
624 (defun x-dnd-init-motif-for-frame (frame)
625 "Set _MOTIF_DRAG_RECEIVER_INFO for FRAME to indicate that we do Motif DND."
626 (x-change-window-property "_MOTIF_DRAG_RECEIVER_INFO"
627 (list
628 (byteorder)
629 0 ; The Motif DND version.
630 5 ; We want drag dynamic.
631 0 0 0 0 0 0 0
632 0 0 0 0 0 0) ; Property must be 16 bytes.
633 frame "_MOTIF_DRAG_RECEIVER_INFO" 8 t))
634
635 (defun x-dnd-get-motif-value (data offset size byteorder)
636 (cond ((eq size 2)
637 (if (eq byteorder ?l)
638 (+ (ash (aref data (1+ offset)) 8)
639 (aref data offset))
640 (+ (ash (aref data offset) 8)
641 (aref data (1+ offset)))))
642
643 ((eq size 4)
644 (if (eq byteorder ?l)
645 (cons (+ (ash (aref data (+ 3 offset)) 8)
646 (aref data (+ 2 offset)))
647 (+ (ash (aref data (1+ offset)) 8)
648 (aref data offset)))
649 (cons (+ (ash (aref data offset) 8)
650 (aref data (1+ offset)))
651 (+ (ash (aref data (+ 2 offset)) 8)
652 (aref data (+ 3 offset))))))))
653
654 (defun x-dnd-motif-value-to-list (value size byteorder)
655 (let ((bytes (cond ((eq size 2)
656 (list (logand (lsh value -8) ?\xff)
657 (logand value ?\xff)))
658
659 ((eq size 4)
660 (if (consp value)
661 (list (logand (lsh (car value) -8) ?\xff)
662 (logand (car value) ?\xff)
663 (logand (lsh (cdr value) -8) ?\xff)
664 (logand (cdr value) ?\xff))
665 (list (logand (lsh value -24) ?\xff)
666 (logand (lsh value -16) ?\xff)
667 (logand (lsh value -8) ?\xff)
668 (logand value ?\xff)))))))
669 (if (eq byteorder ?l)
670 (reverse bytes)
671 bytes)))
672
673
674 (defvar x-dnd-motif-message-types
675 '((0 . XmTOP_LEVEL_ENTER)
676 (1 . XmTOP_LEVEL_LEAVE)
677 (2 . XmDRAG_MOTION)
678 (3 . XmDROP_SITE_ENTER)
679 (4 . XmDROP_SITE_LEAVE)
680 (5 . XmDROP_START)
681 (6 . XmDROP_FINISH)
682 (7 . XmDRAG_DROP_FINISH)
683 (8 . XmOPERATION_CHANGED))
684 "Mapping from numbers to Motif DND message types.")
685
686 (defvar x-dnd-motif-to-action
687 '((1 . move)
688 (2 . copy)
689 (3 . link) ; Both 3 and 4 has been seen as link.
690 (4 . link)
691 (2 . private)) ; Motif does not have private, so use copy for private.
692 "Mapping from number to operation for Motif DND.")
693
694 (defun x-dnd-handle-motif (event frame window message-atom format data)
695 (let* ((message-type (cdr (assoc (aref data 0) x-dnd-motif-message-types)))
696 (source-byteorder (aref data 1))
697 (my-byteorder (byteorder))
698 (source-flags (x-dnd-get-motif-value data 2 2 source-byteorder))
699 (source-action (cdr (assoc (logand ?\xF source-flags)
700 x-dnd-motif-to-action))))
701
702 (cond ((eq message-type 'XmTOP_LEVEL_ENTER)
703 (let* ((dnd-source (x-dnd-get-motif-value
704 data 8 4 source-byteorder))
705 (selection-atom (x-dnd-get-motif-value
706 data 12 4 source-byteorder))
707 (atom-name (x-get-atom-name selection-atom))
708 (types (when atom-name
709 (x-get-selection-internal (intern atom-name)
710 'TARGETS))))
711 (x-dnd-forget-drop frame)
712 (when types (x-dnd-save-state window nil nil
713 types
714 dnd-source))))
715
716 ;; Can not forget drop here, LEAVE comes before DROP_START and
717 ;; we need the state in DROP_START.
718 ((eq message-type 'XmTOP_LEVEL_LEAVE)
719 nil)
720
721 ((eq message-type 'XmDRAG_MOTION)
722 (let* ((state (x-dnd-get-state-for-frame frame))
723 (timestamp (x-dnd-motif-value-to-list
724 (x-dnd-get-motif-value data 4 4
725 source-byteorder)
726 4 my-byteorder))
727 (x (x-dnd-motif-value-to-list
728 (x-dnd-get-motif-value data 8 2 source-byteorder)
729 2 my-byteorder))
730 (y (x-dnd-motif-value-to-list
731 (x-dnd-get-motif-value data 10 2 source-byteorder)
732 2 my-byteorder))
733 (dnd-source (aref state 6))
734 (first-move (not (aref state 3)))
735 (action-type (x-dnd-maybe-call-test-function
736 window
737 source-action))
738 (reply-action (car (rassoc (car action-type)
739 x-dnd-motif-to-action)))
740 (reply-flags
741 (x-dnd-motif-value-to-list
742 (if reply-action
743 (+ reply-action
744 ?\x30 ; 30: valid drop site
745 ?\x700) ; 700: can do copy, move or link
746 ?\x30) ; 30: drop site, but noop.
747 2 my-byteorder))
748 (reply (append
749 (list
750 (+ ?\x80 ; 0x80 indicates a reply.
751 (if first-move
752 3 ; First time, reply is SITE_ENTER.
753 2)) ; Not first time, reply is DRAG_MOTION.
754 my-byteorder)
755 reply-flags
756 timestamp
757 x
758 y)))
759 (x-send-client-message frame
760 dnd-source
761 frame
762 "_MOTIF_DRAG_AND_DROP_MESSAGE"
763 8
764 reply)))
765
766 ((eq message-type 'XmOPERATION_CHANGED)
767 (let* ((state (x-dnd-get-state-for-frame frame))
768 (timestamp (x-dnd-motif-value-to-list
769 (x-dnd-get-motif-value data 4 4 source-byteorder)
770 4 my-byteorder))
771 (dnd-source (aref state 6))
772 (action-type (x-dnd-maybe-call-test-function
773 window
774 source-action))
775 (reply-action (car (rassoc (car action-type)
776 x-dnd-motif-to-action)))
777 (reply-flags
778 (x-dnd-motif-value-to-list
779 (if reply-action
780 (+ reply-action
781 ?\x30 ; 30: valid drop site
782 ?\x700) ; 700: can do copy, move or link
783 ?\x30) ; 30: drop site, but noop
784 2 my-byteorder))
785 (reply (append
786 (list
787 (+ ?\x80 ; 0x80 indicates a reply.
788 8) ; 8 is OPERATION_CHANGED
789 my-byteorder)
790 reply-flags
791 timestamp)))
792 (x-send-client-message frame
793 dnd-source
794 frame
795 "_MOTIF_DRAG_AND_DROP_MESSAGE"
796 8
797 reply)))
798
799 ((eq message-type 'XmDROP_START)
800 (let* ((x (x-dnd-motif-value-to-list
801 (x-dnd-get-motif-value data 8 2 source-byteorder)
802 2 my-byteorder))
803 (y (x-dnd-motif-value-to-list
804 (x-dnd-get-motif-value data 10 2 source-byteorder)
805 2 my-byteorder))
806 (selection-atom (x-dnd-get-motif-value
807 data 12 4 source-byteorder))
808 (atom-name (x-get-atom-name selection-atom))
809 (dnd-source (x-dnd-get-motif-value
810 data 16 4 source-byteorder))
811 (action-type (x-dnd-maybe-call-test-function
812 window
813 source-action))
814 (reply-action (car (rassoc (car action-type)
815 x-dnd-motif-to-action)))
816 (reply-flags
817 (x-dnd-motif-value-to-list
818 (if reply-action
819 (+ reply-action
820 ?\x30 ; 30: valid drop site
821 ?\x700) ; 700: can do copy, move or link
822 (+ ?\x30 ; 30: drop site, but noop.
823 ?\x200)) ; 200: drop cancel.
824 2 my-byteorder))
825 (reply (append
826 (list
827 (+ ?\x80 ; 0x80 indicates a reply.
828 5) ; DROP_START.
829 my-byteorder)
830 reply-flags
831 x
832 y))
833 (timestamp (x-dnd-get-motif-value
834 data 4 4 source-byteorder))
835 action)
836
837 (x-send-client-message frame
838 dnd-source
839 frame
840 "_MOTIF_DRAG_AND_DROP_MESSAGE"
841 8
842 reply)
843 (setq action
844 (when (and reply-action atom-name)
845 (let* ((value (x-get-selection-internal
846 (intern atom-name)
847 (intern (x-dnd-current-type window)))))
848 (when value
849 (condition-case info
850 (x-dnd-drop-data event frame window value
851 (x-dnd-current-type window))
852 (error
853 (message "Error: %s" info)
854 nil))))))
855 (x-get-selection-internal
856 (intern atom-name)
857 (if action 'XmTRANSFER_SUCCESS 'XmTRANSFER_FAILURE)
858 timestamp)
859 (x-dnd-forget-drop frame)))
860
861 (t (error "Unknown Motif DND message %s %s" message data)))))
862
863
864 ;;;
865
866
867 (provide 'x-dnd)
868
869 ;;; arch-tag: b621fb7e-50da-4323-850b-5fc71ae64621
870 ;;; x-dnd.el ends here