annotate src/dragdrop.c @ 304:c6de09ad3017 r21-0b50

Import from CVS: tag r21-0b50
author cvs
date Mon, 13 Aug 2007 10:41:12 +0200
parents 558f606b08ae
children 19dcec799385
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
282
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
1 /* Drag'n'Drop definitions
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
2 created 03-may-98 by Oliver Graf <ograf@fga.de>
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
3 Copyright (C) 1998 Oliver Graf <ograf@fga.de>
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
4
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
5 This file is part of XEmacs.
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
6
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
7 XEmacs is free software; you can redistribute it and/or modify it
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
8 under the terms of the GNU General Public License as published by the
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
9 Free Software Foundation; either version 2, or (at your option) any
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
10 later version.
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
11
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
12 XEmacs is distributed in the hope that it will be useful, but WITHOUT
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
13 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
15 for more details.
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
16
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
17 You should have received a copy of the GNU General Public License
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
18 along with XEmacs; see the file COPYING. If not, write to
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
20 Boston, MA 02111-1307, USA. */
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
21
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
22 /* Synched up with: Not in FSF. */
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
23
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
24 /* This file should be Mule-ized. */
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
25
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
26 /* A short introduction to the new Drag'n'Drop Model:
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
27
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
28 Currently only drops from OffiX are implemented.
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
29
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
30 A drop generates a extended misc-user-event, as defined in events.[ch].
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
31 This event contains the same as a eval and a button event.
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
32 The function of a drop is set to 'dragdrop-drop-dispatch' which will be
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
33 defined in ../lisp/dragdrop.el.
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
34 The object of the misc-user-event has the following format:
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
35 ( TYPE . DATA )
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
36 TYPE is one of 'dragdrop-MIME and 'dragdrop-URL
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
37 DATA - if TYPE is 'dragdrop-URL, DATA is a list of valid URL strings. It
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
38 is always a list, also if only one URL string is within it.
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
39 - if TYPE is 'dragdrop-MIME, DATA is a list of MIME elements.
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
40 Each can be a string or a list.
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
41 if it is a string it is the pure MIME data complete with header
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
42 and body.
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
43 if it is a list it should look like
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
44 ( MIME-TYPE MIME-ENCODING MIME-DATA )
284
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
45 MIME-TYPE list of type and key.value conses. Same as in tm-view
282
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
46 MIME-ENC the same (a string in this case)
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
47 MIME-DATA is a string
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
48 */
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
49
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
50 #include <config.h>
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
51 #include "lisp.h"
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
52 #include "dragdrop.h"
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
53
284
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
54 /* The supported protocol list */
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
55 Lisp_Object Vdragdrop_protocols;
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
56
282
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
57 /* Drag'n'Drop data types known by XEmacs */
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
58 Lisp_Object Qdragdrop_MIME;
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
59 Lisp_Object Qdragdrop_URL;
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
60
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
61 /* External defined functions to handle Drag'n'Drop */
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
62 Lisp_Object Qdragdrop_drop_dispatch;
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
63
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
64 /* from wget -- thanxx Hrvoje */
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
65 /* A list of unsafe characters for encoding, as per RFC1738. '@' and
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
66 ':' (not listed in RFC) were added because of user/password
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
67 encoding, and \033 for safe printing. */
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
68
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
69 #define URL_UNSAFE " <>\"#%{}|\\^~[]`@:\033"
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
70
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
71 /* HEX digit -> ASCII char */
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
72 #define HEXD2ASC(x) (((x) < 10) ? ((x) + '0') : ((x) - 10 + 'A'))
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
73
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
74 /* Encodes the unsafe characters (listed in URL_UNSAFE) in a given
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
75 string, returning a malloc-ed %XX encoded string.
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
76 if method is != NULL it is prepended to the string. */
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
77 char *
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
78 dnd_url_hexify_string (const char *s, const char *m)
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
79 {
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
80 const char *b;
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
81 char *p, *res;
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
82 int i;
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
83
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
84 b = s;
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
85 for (i = 0; *s; s++, i++)
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
86 if (strchr (URL_UNSAFE, *s))
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
87 i += 2; /* Two more characters (hex digits) */
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
88 if (m)
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
89 {
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
90 res = (char *)xmalloc (i + 1 + strlen (m));
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
91 strcpy (res, m);
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
92 p = res + strlen (m);
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
93 }
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
94 else
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
95 {
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
96 res = (char *)xmalloc (i + 1);
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
97 p = res;
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
98 }
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
99 for (s = b; *s; s++)
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
100 if (strchr (URL_UNSAFE, *s))
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
101 {
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
102 const unsigned char c = *s;
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
103 *p++ = '%';
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
104 *p++ = HEXD2ASC (c >> 4);
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
105 *p++ = HEXD2ASC (c & 0xf);
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
106 }
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
107 else
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
108 *p++ = *s;
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
109 *p = '\0';
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
110 return res;
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
111 }
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
112
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
113 void
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
114 syms_of_dragdrop (void)
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
115 {
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
116 defsymbol (&Qdragdrop_MIME, "dragdrop-MIME");
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
117 defsymbol (&Qdragdrop_URL, "dragdrop-URL");
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
118 defsymbol (&Qdragdrop_drop_dispatch, "dragdrop-drop-dispatch");
c42ec1d1cded Import from CVS: tag r21-0b39
cvs
parents:
diff changeset
119 }
284
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
120
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
121 void
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
122 vars_of_dragdrop (void)
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
123 {
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
124 Fprovide (intern ("dragdrop-api"));
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
125
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
126 DEFVAR_CONST_LISP ("dragdrop-protocols", &Vdragdrop_protocols /*
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
127 A list of supported Drag'n'drop protocols.
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
128 Each element is the feature symbol of the protocol.
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
129 */ );
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
130
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
131 Vdragdrop_protocols = Qnil;
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
132
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
133 #ifdef HAVE_MSWINDOWS
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
134 Vdragdrop_protocols = Fcons ( Qmswindows , Vdragdrop_protocols );
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
135 #endif
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
136 #ifdef HAVE_CDE
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
137 Vdragdrop_protocols = Fcons ( intern ("cde") , Vdragdrop_protocols );
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
138 #endif
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
139 #ifdef HAVE_OFFIX_DND
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
140 Vdragdrop_protocols = Fcons ( intern ("offix") , Vdragdrop_protocols );
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
141 #endif
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 282
diff changeset
142 }