|
284
|
1 @c -*-texinfo-*-
|
|
|
2 @c This is part of the XEmacs Lisp Reference Manual.
|
|
|
3 @c Copyright (C) 1998 Oliver Graf <ograf@fga.de>
|
|
|
4 @c Original reference is (c) 1990, 1991, 1992, 1993, 1994 Free Software Foundation, Inc.
|
|
|
5 @c See the file lispref.texi for copying conditions.
|
|
|
6 @setfilename ../../info/dragndrop.texi
|
|
|
7 @node Drag'n'Drop, Modes, Scrollbars, Top
|
|
|
8 @chapter Drag'n'Drop
|
|
|
9 @cindex drag'n'drop
|
|
|
10
|
|
288
|
11 @emph{WARNING}: the Drag'n'Drop API is still under development and the
|
|
|
12 interface may change!
|
|
|
13
|
|
284
|
14 Drag'n'drop is a way to transfer information between multiple applications.
|
|
|
15 To do this serveral GUIs define their own protocols. Examples are OffiX, CDE,
|
|
|
16 Motif, KDE, MSWindows, GNOME, and many more. To catch all these protocols,
|
|
|
17 XEmacs provides a generic API.
|
|
|
18
|
|
288
|
19 One prime idea behind the API is to use a data interface that is
|
|
|
20 transparent for all systems. The author thinks that this is best
|
|
|
21 archived by using URL and MIME data, cause any internet enabled system
|
|
|
22 must support these for email already. XEmacs also already provides
|
|
|
23 powerful interfaces to support these types of data (tm and w3).
|
|
|
24
|
|
284
|
25 @menu
|
|
|
26 * Supported Protocols:: Which low-level protocols are supported.
|
|
|
27 * Drop Interface:: How XEmacs handles a drop from another application.
|
|
|
28 * Drag Interface:: Calls to initiate a drag from XEmacs.
|
|
|
29 @end menu
|
|
|
30
|
|
|
31 @node Supported Protocols
|
|
|
32 @section Supported Protocols
|
|
|
33
|
|
|
34 The current release of XEmacs only support a small set of Drag'n'drop
|
|
|
35 protocols. Some of these only support limited options avaiable in the API.
|
|
|
36
|
|
|
37 @menu
|
|
|
38 * OffiX DND:: A generic X based protocol.
|
|
|
39 * CDE dt:: Common Desktop Environment used on suns.
|
|
|
40 * MSWindows OLE:: Mr. Gates way of live.
|
|
288
|
41 * Loose ends:: The other protocols.
|
|
284
|
42 @end menu
|
|
|
43
|
|
|
44 @node OffiX DND
|
|
|
45 @subsection OffiX DND
|
|
|
46 @cindex OffiX DND
|
|
|
47
|
|
|
48 The OffiX Drag'n'Drop protocol is part of a X API/Widget library created by
|
|
|
49 Cesar Crusius. It is based on X-Atoms and ClientMessage events, and works with
|
|
|
50 any X platform supporting them.
|
|
|
51
|
|
|
52 OffiX is supported if 'offix is member of the variable dragdrop-protocols, or
|
|
|
53 the feature 'offix is defined.
|
|
|
54
|
|
288
|
55 Unfortunately it uses it's own data types. Examples are: File, Files,
|
|
|
56 Exe, Link, URL, MIME. The API tries to choose the right type for the data that
|
|
|
57 is dragged from XEmacs (well, not yet...).
|
|
|
58
|
|
284
|
59 XEmacs supports both MIME and URL drags and drops using this API. No application
|
|
|
60 interaction is possible while dragging is in progress.
|
|
|
61
|
|
|
62 For infomation about the OffiX project have a look at http://leb.net/~offix/
|
|
|
63
|
|
|
64 @node CDE dt
|
|
|
65 @subsection CDE dt
|
|
|
66 @cindex CDE dt
|
|
|
67
|
|
288
|
68 CDE stands for Common Desktop Environment. It is based on the Motif
|
|
|
69 widget library. It's drag'n'drop protocol is also an abstraction of the
|
|
|
70 Motif protocol (so it might be possible, that XEmacs will also support
|
|
|
71 the Motif protocol soon).
|
|
|
72
|
|
|
73 CDE has three different types: file, buffer, and text. XEmacs only uses
|
|
|
74 file and buffer drags. The API will disallow full URL drags, only file
|
|
|
75 method URLs are passed through.
|
|
|
76
|
|
|
77 Buffer drags are always converted to plain text.
|
|
284
|
78
|
|
|
79 @node MSWindows OLE
|
|
|
80 @subsection MSWindows OLE
|
|
|
81 @cindex MSWindows OLE
|
|
|
82
|
|
288
|
83 Only allows file drags and drops.
|
|
|
84
|
|
|
85 @node Loose ends
|
|
|
86 @subsection Loose ends
|
|
|
87
|
|
|
88 The following protocols will be supported soon: Xdnd, Motif, Xde (if I
|
|
|
89 get some specs).
|
|
|
90
|
|
|
91 In particular Xdnd will be one of the protocols that can benefit from
|
|
|
92 the XEmacs API, cause it also uses MIME types to encode dragged data.
|
|
284
|
93
|
|
|
94 @node Drop Interface
|
|
|
95 @section Drop Interface
|
|
|
96 @cindex drop
|
|
288
|
97 @cindex Drop API
|
|
284
|
98
|
|
288
|
99 For each activated low-level protocol, a internal routine will catch
|
|
|
100 incoming drops and convert them to a dragdrop-drop type
|
|
|
101 misc-user-event.
|
|
|
102
|
|
|
103 This misc-user-event has its function argument set to
|
|
|
104 dragdrop-drop-dispatch and the object contains the data of the drop
|
|
|
105 (converted to URL/MIME specific data).
|
|
284
|
106
|
|
|
107 @node Drag Interface
|
|
|
108 @section Drag Interface
|
|
288
|
109 @cindex drag
|
|
|
110 @cindex Drag API
|
|
284
|
111
|
|
|
112 This describes the drag API (not implemented yet).
|
