update.
[chise/xemacs-chise.git.1] / tests / Dnd / README
1  * Sun May 3 1998 Oliver Graf <ograf@fga.de>
2
3 This path contains test code for the new XEmacs
4 Drag'n'Drop code.
5
6 To test the code do the following:
7 1) call 'bash droptest.sh' to create the test files in /tmp
8 2) load and eval droptest.el in XEmacs
9 3) Try to do some internal DnD by using the sources and targets
10    in the new buffer
11 4) Do some external DnD:
12    4a) OffiX: use files and editor of OffiX
13               drag something from files or editor into XEmacs
14               drag something from XEmacs to xv (only with OffiX patch,
15               editor or files -- files can only move and copy within
16               itself, cause OffiX is not quite the right thing to do)
17    4b) CDE: use dtfile and dtpad instead, but here everything should
18             work.
19    4c) MSWindows: well, explorer should do. But only file data
20                   should work, and I don't know if the test
21                   already handles this.
22
23 The misc-user-event now also responds as a button-x-event
24 to the event-* query functions.
25
26 The function of a drag is called dragdrop-drop-dispatch
27 as you can see in droptest.el. From within the function
28 you can access the actual misc-user-event through the
29 current-mouse-event variable.
30
31 Short description of the object part of a drop misc-user-event:
32 ( TYPE . DATA )
33 TYPE is either the symbol dragdrop_MIME
34      or the symbol dragdrop_URL
35
36 DATA is a list of URL strings if TYPE is dragdrop_URL
37      if TYPE is dragdrop_MIME DATA is either a string
38      which contains the MIME data, or it is a list of
39      ( CONTENT-TYPE CONTENT-ENCODING MIME-DATA )
40      CONTENT-TYPE is encoded for tm-view (list, first element type,
41         rest key.value conses)
42      CONTENT-ENCODING is a string
43      MIME-DATA is a string
44
45      CONTENT-TYPE and -ENCODING can be directly supplied to mime/viewer-mode.
46