Commit | Line | Data |
---|---|---|
edfda783 | 1 | /* NeXT/Open/GNUstep / MacOSX Cocoa selection processing for emacs. |
acaf905b | 2 | Copyright (C) 1993-1994, 2005-2006, 2008-2012 |
32d235f8 | 3 | Free Software Foundation, Inc. |
edfda783 AR |
4 | |
5 | This file is part of GNU Emacs. | |
6 | ||
32d235f8 | 7 | GNU Emacs is free software: you can redistribute it and/or modify |
edfda783 | 8 | it under the terms of the GNU General Public License as published by |
32d235f8 GM |
9 | the Free Software Foundation, either version 3 of the License, or |
10 | (at your option) any later version. | |
edfda783 AR |
11 | |
12 | GNU Emacs is distributed in the hope that it will be useful, | |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | GNU General Public License for more details. | |
16 | ||
17 | You should have received a copy of the GNU General Public License | |
32d235f8 | 18 | along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */ |
edfda783 | 19 | |
32d235f8 | 20 | /* |
edfda783 AR |
21 | Originally by Carl Edman |
22 | Updated by Christian Limpach (chris@nice.ch) | |
23 | OpenStep/Rhapsody port by Scott Bender (sbender@harmony-ds.com) | |
24 | MacOSX/Aqua port by Christophe de Dinechin (descubes@earthlink.net) | |
25 | GNUstep port and post-20 update by Adrian Robert (arobert@cogsci.ucsd.edu) | |
edfda783 AR |
26 | */ |
27 | ||
5a06864f AR |
28 | /* This should be the first include, as it may set up #defines affecting |
29 | interpretation of even the system includes. */ | |
08a494a3 | 30 | #include <config.h> |
b024548b | 31 | #include <setjmp.h> |
5a06864f | 32 | |
edfda783 AR |
33 | #include "lisp.h" |
34 | #include "nsterm.h" | |
35 | #include "termhooks.h" | |
921242c6 | 36 | #include "keyboard.h" |
edfda783 | 37 | |
64cb6c78 | 38 | Lisp_Object QCLIPBOARD, QSECONDARY, QTEXT, QFILE_NAME; |
edfda783 | 39 | |
00b3c7ac TT |
40 | static Lisp_Object Vselection_alist; |
41 | ||
edfda783 AR |
42 | static Lisp_Object Qforeign_selection; |
43 | ||
64cb6c78 J |
44 | /* NSGeneralPboard is pretty much analogous to X11 CLIPBOARD */ |
45 | NSString *NXPrimaryPboard; | |
edfda783 AR |
46 | NSString *NXSecondaryPboard; |
47 | ||
48 | ||
49 | ||
50 | /* ========================================================================== | |
51 | ||
52 | Internal utility functions | |
53 | ||
54 | ========================================================================== */ | |
55 | ||
56 | ||
57 | static NSString * | |
58 | symbol_to_nsstring (Lisp_Object sym) | |
59 | { | |
60 | CHECK_SYMBOL (sym); | |
c803b2b7 | 61 | if (EQ (sym, QCLIPBOARD)) return NSGeneralPboard; |
64cb6c78 | 62 | if (EQ (sym, QPRIMARY)) return NXPrimaryPboard; |
edfda783 AR |
63 | if (EQ (sym, QSECONDARY)) return NXSecondaryPboard; |
64 | if (EQ (sym, QTEXT)) return NSStringPboardType; | |
86fa089e | 65 | return [NSString stringWithUTF8String: SDATA (XSYMBOL (sym)->xname)]; |
edfda783 AR |
66 | } |
67 | ||
c803b2b7 JD |
68 | static NSPasteboard * |
69 | ns_symbol_to_pb (Lisp_Object symbol) | |
70 | { | |
71 | return [NSPasteboard pasteboardWithName: symbol_to_nsstring (symbol)]; | |
72 | } | |
edfda783 AR |
73 | |
74 | static Lisp_Object | |
75 | ns_string_to_symbol (NSString *t) | |
76 | { | |
77 | if ([t isEqualToString: NSGeneralPboard]) | |
64cb6c78 J |
78 | return QCLIPBOARD; |
79 | if ([t isEqualToString: NXPrimaryPboard]) | |
edfda783 AR |
80 | return QPRIMARY; |
81 | if ([t isEqualToString: NXSecondaryPboard]) | |
82 | return QSECONDARY; | |
83 | if ([t isEqualToString: NSStringPboardType]) | |
84 | return QTEXT; | |
85 | if ([t isEqualToString: NSFilenamesPboardType]) | |
86 | return QFILE_NAME; | |
87 | if ([t isEqualToString: NSTabularTextPboardType]) | |
88 | return QTEXT; | |
89 | return intern ([t UTF8String]); | |
90 | } | |
91 | ||
92 | ||
93 | static Lisp_Object | |
94 | clean_local_selection_data (Lisp_Object obj) | |
95 | { | |
96 | if (CONSP (obj) | |
97 | && INTEGERP (XCAR (obj)) | |
98 | && CONSP (XCDR (obj)) | |
99 | && INTEGERP (XCAR (XCDR (obj))) | |
100 | && NILP (XCDR (XCDR (obj)))) | |
101 | obj = Fcons (XCAR (obj), XCDR (obj)); | |
102 | ||
103 | if (CONSP (obj) | |
104 | && INTEGERP (XCAR (obj)) | |
105 | && INTEGERP (XCDR (obj))) | |
106 | { | |
107 | if (XINT (XCAR (obj)) == 0) | |
108 | return XCDR (obj); | |
109 | if (XINT (XCAR (obj)) == -1) | |
110 | return make_number (- XINT (XCDR (obj))); | |
111 | } | |
112 | ||
113 | if (VECTORP (obj)) | |
114 | { | |
115 | int i; | |
facfbbbd | 116 | int size = ASIZE (obj); |
edfda783 AR |
117 | Lisp_Object copy; |
118 | ||
119 | if (size == 1) | |
facfbbbd SM |
120 | return clean_local_selection_data (AREF (obj, 0)); |
121 | copy = Fmake_vector (make_number (size), Qnil); | |
edfda783 | 122 | for (i = 0; i < size; i++) |
86fa089e | 123 | ASET (copy, i, clean_local_selection_data (AREF (obj, i))); |
edfda783 AR |
124 | return copy; |
125 | } | |
126 | ||
127 | return obj; | |
128 | } | |
129 | ||
130 | ||
131 | static void | |
132 | ns_declare_pasteboard (id pb) | |
133 | { | |
134 | [pb declareTypes: ns_send_types owner: NSApp]; | |
135 | } | |
136 | ||
137 | ||
138 | static void | |
139 | ns_undeclare_pasteboard (id pb) | |
140 | { | |
141 | [pb declareTypes: [NSArray array] owner: nil]; | |
142 | } | |
143 | ||
144 | ||
145 | static void | |
146 | ns_string_to_pasteboard_internal (id pb, Lisp_Object str, NSString *gtype) | |
147 | { | |
148 | if (EQ (str, Qnil)) | |
149 | { | |
150 | [pb declareTypes: [NSArray array] owner: nil]; | |
151 | } | |
152 | else | |
153 | { | |
154 | char *utfStr; | |
155 | NSString *type, *nsStr; | |
156 | NSEnumerator *tenum; | |
157 | ||
158 | CHECK_STRING (str); | |
159 | ||
86fa089e | 160 | utfStr = SDATA (str); |
497a1925 JD |
161 | nsStr = [[NSString alloc] initWithBytesNoCopy: utfStr |
162 | length: SBYTES (str) | |
163 | encoding: NSUTF8StringEncoding | |
164 | freeWhenDone: NO]; | |
edfda783 AR |
165 | if (gtype == nil) |
166 | { | |
167 | [pb declareTypes: ns_send_types owner: nil]; | |
168 | tenum = [ns_send_types objectEnumerator]; | |
169 | while ( (type = [tenum nextObject]) ) | |
170 | [pb setString: nsStr forType: type]; | |
171 | } | |
172 | else | |
173 | { | |
174 | [pb setString: nsStr forType: gtype]; | |
175 | } | |
497a1925 | 176 | [nsStr release]; |
edfda783 AR |
177 | } |
178 | } | |
179 | ||
180 | ||
699c10bd | 181 | Lisp_Object |
edfda783 AR |
182 | ns_get_local_selection (Lisp_Object selection_name, |
183 | Lisp_Object target_type) | |
184 | { | |
185 | Lisp_Object local_value; | |
186 | Lisp_Object handler_fn, value, type, check; | |
187 | int count; | |
188 | ||
189 | local_value = assq_no_quit (selection_name, Vselection_alist); | |
190 | ||
191 | if (NILP (local_value)) return Qnil; | |
192 | ||
193 | count = specpdl_ptr - specpdl; | |
194 | specbind (Qinhibit_quit, Qt); | |
195 | CHECK_SYMBOL (target_type); | |
196 | handler_fn = Fcdr (Fassq (target_type, Vselection_converter_alist)); | |
197 | if (!NILP (handler_fn)) | |
facfbbbd | 198 | value = call3 (handler_fn, selection_name, target_type, |
edfda783 AR |
199 | XCAR (XCDR (local_value))); |
200 | else | |
facfbbbd | 201 | value = Qnil; |
edfda783 AR |
202 | unbind_to (count, Qnil); |
203 | ||
facfbbbd | 204 | check = value; |
edfda783 AR |
205 | if (CONSP (value) && SYMBOLP (XCAR (value))) |
206 | { | |
207 | type = XCAR (value); | |
208 | check = XCDR (value); | |
209 | } | |
210 | ||
211 | if (STRINGP (check) || VECTORP (check) || SYMBOLP (check) | |
212 | || INTEGERP (check) || NILP (value)) | |
213 | return value; | |
214 | ||
215 | if (CONSP (check) | |
216 | && INTEGERP (XCAR (check)) | |
217 | && (INTEGERP (XCDR (check))|| | |
218 | (CONSP (XCDR (check)) | |
219 | && INTEGERP (XCAR (XCDR (check))) | |
220 | && NILP (XCDR (XCDR (check)))))) | |
221 | return value; | |
222 | ||
facfbbbd | 223 | // FIXME: Why `quit' rather than `error'? |
edfda783 AR |
224 | Fsignal (Qquit, Fcons (build_string ( |
225 | "invalid data returned by selection-conversion function"), | |
226 | Fcons (handler_fn, Fcons (value, Qnil)))); | |
facfbbbd SM |
227 | // FIXME: Beware, `quit' can return!! |
228 | return Qnil; | |
edfda783 AR |
229 | } |
230 | ||
231 | ||
232 | static Lisp_Object | |
233 | ns_get_foreign_selection (Lisp_Object symbol, Lisp_Object target) | |
234 | { | |
235 | id pb; | |
c803b2b7 JD |
236 | pb = ns_symbol_to_pb (symbol); |
237 | return pb != nil ? ns_string_from_pasteboard (pb) : Qnil; | |
edfda783 AR |
238 | } |
239 | ||
240 | ||
edfda783 AR |
241 | |
242 | ||
243 | /* ========================================================================== | |
244 | ||
245 | Functions used externally | |
246 | ||
247 | ========================================================================== */ | |
248 | ||
249 | ||
250 | Lisp_Object | |
251 | ns_string_from_pasteboard (id pb) | |
252 | { | |
253 | NSString *type, *str; | |
254 | const char *utfStr; | |
497a1925 | 255 | int length; |
edfda783 AR |
256 | |
257 | type = [pb availableTypeFromArray: ns_return_types]; | |
258 | if (type == nil) | |
259 | { | |
260 | Fsignal (Qquit, | |
261 | Fcons (build_string ("empty or unsupported pasteboard type"), | |
262 | Qnil)); | |
263 | return Qnil; | |
264 | } | |
265 | ||
266 | /* get the string */ | |
267 | if (! (str = [pb stringForType: type])) | |
268 | { | |
269 | NSData *data = [pb dataForType: type]; | |
270 | if (data != nil) | |
271 | str = [[NSString alloc] initWithData: data | |
272 | encoding: NSUTF8StringEncoding]; | |
273 | if (str != nil) | |
274 | { | |
275 | [str autorelease]; | |
276 | } | |
277 | else | |
278 | { | |
279 | Fsignal (Qquit, | |
280 | Fcons (build_string ("pasteboard doesn't contain valid data"), | |
281 | Qnil)); | |
282 | return Qnil; | |
283 | } | |
284 | } | |
285 | ||
286 | /* assume UTF8 */ | |
287 | NS_DURING | |
288 | { | |
289 | /* EOL conversion: PENDING- is this too simple? */ | |
290 | NSMutableString *mstr = [[str mutableCopy] autorelease]; | |
291 | [mstr replaceOccurrencesOfString: @"\r\n" withString: @"\n" | |
292 | options: NSLiteralSearch range: NSMakeRange (0, [mstr length])]; | |
293 | [mstr replaceOccurrencesOfString: @"\r" withString: @"\n" | |
294 | options: NSLiteralSearch range: NSMakeRange (0, [mstr length])]; | |
295 | ||
296 | utfStr = [mstr UTF8String]; | |
497a1925 JD |
297 | length = [mstr lengthOfBytesUsingEncoding: NSUTF8StringEncoding]; |
298 | ||
4393663b | 299 | #if ! defined (NS_IMPL_COCOA) || MAC_OS_X_VERSION_MAX_ALLOWED < MAC_OS_X_VERSION_10_4 |
497a1925 JD |
300 | if (!utfStr) |
301 | { | |
302 | utfStr = [mstr cString]; | |
303 | length = strlen (utfStr); | |
304 | } | |
4393663b | 305 | #endif |
edfda783 AR |
306 | } |
307 | NS_HANDLER | |
308 | { | |
309 | message1 ("ns_string_from_pasteboard: UTF8String failed\n"); | |
4393663b JD |
310 | #if defined (NS_IMPL_COCOA) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4 |
311 | utfStr = "Conversion failed"; | |
312 | #else | |
edfda783 | 313 | utfStr = [str lossyCString]; |
4393663b | 314 | #endif |
497a1925 | 315 | length = strlen (utfStr); |
edfda783 AR |
316 | } |
317 | NS_ENDHANDLER | |
318 | ||
497a1925 | 319 | return make_string (utfStr, length); |
edfda783 AR |
320 | } |
321 | ||
322 | ||
323 | void | |
324 | ns_string_to_pasteboard (id pb, Lisp_Object str) | |
325 | { | |
326 | ns_string_to_pasteboard_internal (pb, str, nil); | |
327 | } | |
328 | ||
329 | ||
330 | ||
331 | /* ========================================================================== | |
332 | ||
333 | Lisp Defuns | |
334 | ||
335 | ========================================================================== */ | |
336 | ||
337 | ||
28bf482a DR |
338 | DEFUN ("x-own-selection-internal", Fx_own_selection_internal, |
339 | Sx_own_selection_internal, 2, 2, 0, | |
a5c55c69 CY |
340 | doc: /* Assert a selection. |
341 | SELECTION-NAME is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'. | |
342 | VALUE is typically a string, or a cons of two markers, but may be | |
343 | anything that the functions on `selection-converter-alist' know about. */) | |
5842a27b | 344 | (Lisp_Object selection_name, Lisp_Object selection_value) |
edfda783 AR |
345 | { |
346 | id pb; | |
347 | Lisp_Object old_value, new_value; | |
c803b2b7 JD |
348 | NSString *type; |
349 | Lisp_Object successful_p = Qnil, rest; | |
350 | Lisp_Object target_symbol, data; | |
351 | ||
edfda783 AR |
352 | |
353 | check_ns (); | |
354 | CHECK_SYMBOL (selection_name); | |
355 | if (NILP (selection_value)) | |
356 | error ("selection-value may not be nil."); | |
c803b2b7 JD |
357 | pb = ns_symbol_to_pb (selection_name); |
358 | if (pb == nil) return Qnil; | |
359 | ||
edfda783 | 360 | ns_declare_pasteboard (pb); |
facfbbbd | 361 | old_value = assq_no_quit (selection_name, Vselection_alist); |
edfda783 | 362 | new_value = Fcons (selection_name, Fcons (selection_value, Qnil)); |
c803b2b7 | 363 | |
edfda783 | 364 | if (NILP (old_value)) |
facfbbbd | 365 | Vselection_alist = Fcons (new_value, Vselection_alist); |
edfda783 AR |
366 | else |
367 | Fsetcdr (old_value, Fcdr (new_value)); | |
c803b2b7 JD |
368 | |
369 | /* We only support copy of text. */ | |
370 | type = NSStringPboardType; | |
371 | target_symbol = ns_string_to_symbol (type); | |
372 | data = ns_get_local_selection (selection_name, target_symbol); | |
373 | if (!NILP (data)) | |
374 | { | |
375 | if (STRINGP (data)) | |
376 | ns_string_to_pasteboard_internal (pb, data, type); | |
377 | successful_p = Qt; | |
378 | } | |
379 | ||
380 | if (!EQ (Vns_sent_selection_hooks, Qunbound)) | |
381 | { | |
382 | for (rest = Vns_sent_selection_hooks; CONSP (rest); rest = Fcdr (rest)) | |
383 | call3 (Fcar (rest), selection_name, target_symbol, successful_p); | |
384 | } | |
385 | ||
edfda783 AR |
386 | return selection_value; |
387 | } | |
388 | ||
389 | ||
9e50ff0c DN |
390 | DEFUN ("x-disown-selection-internal", Fx_disown_selection_internal, |
391 | Sx_disown_selection_internal, 1, 2, 0, | |
a5c55c69 | 392 | doc: /* If we own the selection SELECTION, disown it. */) |
5842a27b | 393 | (Lisp_Object selection_name, Lisp_Object time) |
edfda783 AR |
394 | { |
395 | id pb; | |
396 | check_ns (); | |
397 | CHECK_SYMBOL (selection_name); | |
398 | if (NILP (assq_no_quit (selection_name, Vselection_alist))) return Qnil; | |
399 | ||
c803b2b7 JD |
400 | pb = ns_symbol_to_pb (selection_name); |
401 | if (pb != nil) ns_undeclare_pasteboard (pb); | |
edfda783 AR |
402 | return Qt; |
403 | } | |
404 | ||
405 | ||
28bf482a | 406 | DEFUN ("x-selection-exists-p", Fx_selection_exists_p, Sx_selection_exists_p, |
a5c55c69 CY |
407 | 0, 1, 0, doc: /* Whether there is an owner for the given selection. |
408 | The arg should be the name of the selection in question, typically one of | |
409 | the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'. | |
410 | \(Those are literal upper-case symbol names.) | |
411 | For convenience, the symbol nil is the same as `PRIMARY', | |
412 | and t is the same as `SECONDARY'.) */) | |
5842a27b | 413 | (Lisp_Object selection) |
edfda783 AR |
414 | { |
415 | id pb; | |
416 | NSArray *types; | |
417 | ||
418 | check_ns (); | |
419 | CHECK_SYMBOL (selection); | |
420 | if (EQ (selection, Qnil)) selection = QPRIMARY; | |
421 | if (EQ (selection, Qt)) selection = QSECONDARY; | |
c803b2b7 JD |
422 | pb = ns_symbol_to_pb (selection); |
423 | if (pb == nil) return Qnil; | |
424 | ||
425 | types = [pb types]; | |
edfda783 AR |
426 | return ([types count] == 0) ? Qnil : Qt; |
427 | } | |
428 | ||
429 | ||
28bf482a | 430 | DEFUN ("x-selection-owner-p", Fx_selection_owner_p, Sx_selection_owner_p, |
edfda783 | 431 | 0, 1, 0, |
a5c55c69 CY |
432 | doc: /* Whether the current Emacs process owns the given selection. |
433 | The arg should be the name of the selection in question, typically one of | |
434 | the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'. | |
435 | \(Those are literal upper-case symbol names.) | |
436 | For convenience, the symbol nil is the same as `PRIMARY', | |
437 | and t is the same as `SECONDARY'.) */) | |
5842a27b | 438 | (Lisp_Object selection) |
edfda783 AR |
439 | { |
440 | check_ns (); | |
441 | CHECK_SYMBOL (selection); | |
442 | if (EQ (selection, Qnil)) selection = QPRIMARY; | |
443 | if (EQ (selection, Qt)) selection = QSECONDARY; | |
444 | return (NILP (Fassq (selection, Vselection_alist))) ? Qnil : Qt; | |
445 | } | |
446 | ||
447 | ||
9e50ff0c DN |
448 | DEFUN ("x-get-selection-internal", Fx_get_selection_internal, |
449 | Sx_get_selection_internal, 2, 2, 0, | |
a5c55c69 CY |
450 | doc: /* Return text selected from some pasteboard. |
451 | SELECTION is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'. | |
452 | \(Those are literal upper-case symbol names.) | |
453 | TYPE is the type of data desired, typically `STRING'. */) | |
5842a27b | 454 | (Lisp_Object selection_name, Lisp_Object target_type) |
edfda783 AR |
455 | { |
456 | Lisp_Object val; | |
457 | ||
458 | check_ns (); | |
459 | CHECK_SYMBOL (selection_name); | |
460 | CHECK_SYMBOL (target_type); | |
461 | val = ns_get_local_selection (selection_name, target_type); | |
462 | if (NILP (val)) | |
463 | val = ns_get_foreign_selection (selection_name, target_type); | |
464 | if (CONSP (val) && SYMBOLP (Fcar (val))) | |
465 | { | |
466 | val = Fcdr (val); | |
467 | if (CONSP (val) && NILP (Fcdr (val))) | |
468 | val = Fcar (val); | |
469 | } | |
470 | val = clean_local_selection_data (val); | |
471 | return val; | |
472 | } | |
473 | ||
474 | ||
c803b2b7 JD |
475 | DEFUN ("ns-get-selection-internal", Fns_get_selection_internal, |
476 | Sns_get_selection_internal, 1, 1, 0, | |
477 | doc: /* Returns the value of SELECTION as a string. | |
478 | SELECTION is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'. */) | |
479 | (Lisp_Object selection) | |
edfda783 AR |
480 | { |
481 | id pb; | |
482 | check_ns (); | |
c803b2b7 JD |
483 | pb = ns_symbol_to_pb (selection); |
484 | return pb != nil ? ns_string_from_pasteboard (pb) : Qnil; | |
edfda783 AR |
485 | } |
486 | ||
487 | ||
c803b2b7 JD |
488 | DEFUN ("ns-store-selection-internal", Fns_store_selection_internal, |
489 | Sns_store_selection_internal, 2, 2, 0, | |
490 | doc: /* Sets the string value of SELECTION. | |
491 | SELECTION is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'. */) | |
492 | (Lisp_Object selection, Lisp_Object string) | |
edfda783 AR |
493 | { |
494 | id pb; | |
495 | check_ns (); | |
c803b2b7 JD |
496 | pb = ns_symbol_to_pb (selection); |
497 | if (pb != nil) ns_string_to_pasteboard (pb, string); | |
edfda783 AR |
498 | return Qnil; |
499 | } | |
edfda783 AR |
500 | |
501 | ||
502 | void | |
503 | nxatoms_of_nsselect (void) | |
504 | { | |
2c0ac867 J |
505 | NXPrimaryPboard = @"Selection"; |
506 | NXSecondaryPboard = @"Secondary"; | |
edfda783 AR |
507 | } |
508 | ||
509 | void | |
510 | syms_of_nsselect (void) | |
511 | { | |
088dcc3e DN |
512 | QCLIPBOARD = intern_c_string ("CLIPBOARD"); staticpro (&QCLIPBOARD); |
513 | QSECONDARY = intern_c_string ("SECONDARY"); staticpro (&QSECONDARY); | |
514 | QTEXT = intern_c_string ("TEXT"); staticpro (&QTEXT); | |
515 | QFILE_NAME = intern_c_string ("FILE_NAME"); staticpro (&QFILE_NAME); | |
edfda783 | 516 | |
9e50ff0c DN |
517 | defsubr (&Sx_disown_selection_internal); |
518 | defsubr (&Sx_get_selection_internal); | |
28bf482a DR |
519 | defsubr (&Sx_own_selection_internal); |
520 | defsubr (&Sx_selection_exists_p); | |
521 | defsubr (&Sx_selection_owner_p); | |
c803b2b7 JD |
522 | defsubr (&Sns_get_selection_internal); |
523 | defsubr (&Sns_store_selection_internal); | |
edfda783 AR |
524 | |
525 | Vselection_alist = Qnil; | |
526 | staticpro (&Vselection_alist); | |
527 | ||
fb9d0f5a | 528 | DEFVAR_LISP ("ns-sent-selection-hooks", Vns_sent_selection_hooks, |
edfda783 AR |
529 | "A list of functions to be called when Emacs answers a selection request.\n\ |
530 | The functions are called with four arguments:\n\ | |
531 | - the selection name (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');\n\ | |
532 | - the selection-type which Emacs was asked to convert the\n\ | |
533 | selection into before sending (for example, `STRING' or `LENGTH');\n\ | |
534 | - a flag indicating success or failure for responding to the request.\n\ | |
535 | We might have failed (and declined the request) for any number of reasons,\n\ | |
536 | including being asked for a selection that we no longer own, or being asked\n\ | |
537 | to convert into a type that we don't know about or that is inappropriate.\n\ | |
538 | This hook doesn't let you change the behavior of Emacs's selection replies,\n\ | |
539 | it merely informs you that they have happened."); | |
540 | Vns_sent_selection_hooks = Qnil; | |
541 | ||
fb9d0f5a | 542 | DEFVAR_LISP ("selection-converter-alist", Vselection_converter_alist, |
edfda783 AR |
543 | "An alist associating X Windows selection-types with functions.\n\ |
544 | These functions are called to convert the selection, with three args:\n\ | |
545 | the name of the selection (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');\n\ | |
546 | a desired type to which the selection should be converted;\n\ | |
547 | and the local selection value (whatever was given to `x-own-selection').\n\ | |
548 | \n\ | |
549 | The function should return the value to send to the X server\n\ | |
550 | \(typically a string). A return value of nil\n\ | |
551 | means that the conversion could not be done.\n\ | |
552 | A return value which is the symbol `NULL'\n\ | |
553 | means that a side-effect was executed,\n\ | |
554 | and there is no meaningful selection value."); | |
555 | Vselection_converter_alist = Qnil; | |
556 | ||
fb9d0f5a | 557 | DEFVAR_LISP ("ns-lost-selection-hooks", Vns_lost_selection_hooks, |
edfda783 AR |
558 | "A list of functions to be called when Emacs loses an X selection.\n\ |
559 | \(This happens when some other X client makes its own selection\n\ | |
560 | or when a Lisp program explicitly clears the selection.)\n\ | |
561 | The functions are called with one argument, the selection type\n\ | |
562 | \(a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD')."); | |
563 | Vns_lost_selection_hooks = Qnil; | |
564 | ||
088dcc3e | 565 | Qforeign_selection = intern_c_string ("foreign-selection"); |
edfda783 | 566 | staticpro (&Qforeign_selection); |
edfda783 | 567 | } |
0ae1e5e5 | 568 |