1 /* X Selection processing for Emacs.
2 Copyright (C) 1993-1997, 2000-2011 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
6 GNU Emacs is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
20 /* Rewritten by jwz */
23 #include <stdio.h> /* termhooks.h needs this */
26 #ifdef HAVE_SYS_TYPES_H
27 #include <sys/types.h>
33 #include "xterm.h" /* for all of the X includes */
34 #include "dispextern.h" /* frame.h seems to want this */
35 #include "frame.h" /* Need this to get the X window of selected_frame */
36 #include "blockinput.h"
39 #include "termhooks.h"
42 #include <X11/Xproto.h>
46 static Lisp_Object
x_atom_to_symbol (Display
*dpy
, Atom atom
);
47 static Atom
symbol_to_x_atom (struct x_display_info
*, Display
*,
49 static void x_own_selection (Lisp_Object
, Lisp_Object
);
50 static Lisp_Object
x_get_local_selection (Lisp_Object
, Lisp_Object
, int);
51 static void x_decline_selection_request (struct input_event
*);
52 static Lisp_Object
x_selection_request_lisp_error (Lisp_Object
);
53 static Lisp_Object
queue_selection_requests_unwind (Lisp_Object
);
54 static Lisp_Object
some_frame_on_display (struct x_display_info
*);
55 static Lisp_Object
x_catch_errors_unwind (Lisp_Object
);
56 static void x_reply_selection_request (struct input_event
*, int,
57 unsigned char *, int, Atom
);
58 static int waiting_for_other_props_on_window (Display
*, Window
);
59 static struct prop_location
*expect_property_change (Display
*, Window
,
61 static void unexpect_property_change (struct prop_location
*);
62 static Lisp_Object
wait_for_property_change_unwind (Lisp_Object
);
63 static void wait_for_property_change (struct prop_location
*);
64 static Lisp_Object
x_get_foreign_selection (Lisp_Object
,
67 static void x_get_window_property (Display
*, Window
, Atom
,
68 unsigned char **, int *,
69 Atom
*, int *, unsigned long *, int);
70 static void receive_incremental_selection (Display
*, Window
, Atom
,
71 Lisp_Object
, unsigned,
72 unsigned char **, int *,
73 Atom
*, int *, unsigned long *);
74 static Lisp_Object
x_get_window_property_as_lisp_data (Display
*,
77 static Lisp_Object
selection_data_to_lisp_data (Display
*,
78 const unsigned char *,
80 static void lisp_data_to_selection_data (Display
*, Lisp_Object
,
81 unsigned char **, Atom
*,
82 unsigned *, int *, int *);
83 static Lisp_Object
clean_local_selection_data (Lisp_Object
);
85 /* Printing traces to stderr. */
87 #ifdef TRACE_SELECTION
89 fprintf (stderr, "%d: " fmt "\n", getpid ())
90 #define TRACE1(fmt, a0) \
91 fprintf (stderr, "%d: " fmt "\n", getpid (), a0)
92 #define TRACE2(fmt, a0, a1) \
93 fprintf (stderr, "%d: " fmt "\n", getpid (), a0, a1)
94 #define TRACE3(fmt, a0, a1, a2) \
95 fprintf (stderr, "%d: " fmt "\n", getpid (), a0, a1, a2)
97 #define TRACE0(fmt) (void) 0
98 #define TRACE1(fmt, a0) (void) 0
99 #define TRACE2(fmt, a0, a1) (void) 0
100 #define TRACE3(fmt, a0, a1) (void) 0
104 Lisp_Object QSECONDARY
, QSTRING
, QINTEGER
, QCLIPBOARD
, QTIMESTAMP
,
105 QTEXT
, QDELETE
, QMULTIPLE
, QINCR
, QEMACS_TMP
, QTARGETS
, QATOM
, QNULL
,
108 Lisp_Object QCOMPOUND_TEXT
; /* This is a type of selection. */
109 Lisp_Object QUTF8_STRING
; /* This is a type of selection. */
111 Lisp_Object Qcompound_text_with_extensions
;
113 static Lisp_Object Qforeign_selection
;
115 /* If this is a smaller number than the max-request-size of the display,
116 emacs will use INCR selection transfer when the selection is larger
117 than this. The max-request-size is usually around 64k, so if you want
118 emacs to use incremental selection transfers when the selection is
119 smaller than that, set this. I added this mostly for debugging the
120 incremental transfer stuff, but it might improve server performance. */
121 #define MAX_SELECTION_QUANTUM 0xFFFFFF
123 #define SELECTION_QUANTUM(dpy) ((XMaxRequestSize(dpy) << 2) - 100)
125 /* The timestamp of the last input event Emacs received from the X server. */
126 /* Defined in keyboard.c. */
127 extern unsigned long last_event_timestamp
;
131 /* Define a queue to save up SELECTION_REQUEST_EVENT events for later
134 struct selection_event_queue
136 struct input_event event
;
137 struct selection_event_queue
*next
;
140 static struct selection_event_queue
*selection_queue
;
142 /* Nonzero means queue up SELECTION_REQUEST_EVENT events. */
144 static int x_queue_selection_requests
;
146 /* Queue up an SELECTION_REQUEST_EVENT *EVENT, to be processed later. */
149 x_queue_event (struct input_event
*event
)
151 struct selection_event_queue
*queue_tmp
;
153 /* Don't queue repeated requests.
154 This only happens for large requests which uses the incremental protocol. */
155 for (queue_tmp
= selection_queue
; queue_tmp
; queue_tmp
= queue_tmp
->next
)
157 if (!memcmp (&queue_tmp
->event
, event
, sizeof (*event
)))
159 TRACE1 ("DECLINE DUP SELECTION EVENT %08lx", (unsigned long)queue_tmp
);
160 x_decline_selection_request (event
);
166 = (struct selection_event_queue
*) xmalloc (sizeof (struct selection_event_queue
));
168 if (queue_tmp
!= NULL
)
170 TRACE1 ("QUEUE SELECTION EVENT %08lx", (unsigned long)queue_tmp
);
171 queue_tmp
->event
= *event
;
172 queue_tmp
->next
= selection_queue
;
173 selection_queue
= queue_tmp
;
177 /* Start queuing SELECTION_REQUEST_EVENT events. */
180 x_start_queuing_selection_requests (void)
182 if (x_queue_selection_requests
)
185 x_queue_selection_requests
++;
186 TRACE1 ("x_start_queuing_selection_requests %d", x_queue_selection_requests
);
189 /* Stop queuing SELECTION_REQUEST_EVENT events. */
192 x_stop_queuing_selection_requests (void)
194 TRACE1 ("x_stop_queuing_selection_requests %d", x_queue_selection_requests
);
195 --x_queue_selection_requests
;
197 /* Take all the queued events and put them back
198 so that they get processed afresh. */
200 while (selection_queue
!= NULL
)
202 struct selection_event_queue
*queue_tmp
= selection_queue
;
203 TRACE1 ("RESTORE SELECTION EVENT %08lx", (unsigned long)queue_tmp
);
204 kbd_buffer_unget_event (&queue_tmp
->event
);
205 selection_queue
= queue_tmp
->next
;
206 xfree ((char *)queue_tmp
);
211 /* This converts a Lisp symbol to a server Atom, avoiding a server
212 roundtrip whenever possible. */
215 symbol_to_x_atom (struct x_display_info
*dpyinfo
, Display
*display
, Lisp_Object sym
)
218 if (NILP (sym
)) return 0;
219 if (EQ (sym
, QPRIMARY
)) return XA_PRIMARY
;
220 if (EQ (sym
, QSECONDARY
)) return XA_SECONDARY
;
221 if (EQ (sym
, QSTRING
)) return XA_STRING
;
222 if (EQ (sym
, QINTEGER
)) return XA_INTEGER
;
223 if (EQ (sym
, QATOM
)) return XA_ATOM
;
224 if (EQ (sym
, QCLIPBOARD
)) return dpyinfo
->Xatom_CLIPBOARD
;
225 if (EQ (sym
, QTIMESTAMP
)) return dpyinfo
->Xatom_TIMESTAMP
;
226 if (EQ (sym
, QTEXT
)) return dpyinfo
->Xatom_TEXT
;
227 if (EQ (sym
, QCOMPOUND_TEXT
)) return dpyinfo
->Xatom_COMPOUND_TEXT
;
228 if (EQ (sym
, QUTF8_STRING
)) return dpyinfo
->Xatom_UTF8_STRING
;
229 if (EQ (sym
, QDELETE
)) return dpyinfo
->Xatom_DELETE
;
230 if (EQ (sym
, QMULTIPLE
)) return dpyinfo
->Xatom_MULTIPLE
;
231 if (EQ (sym
, QINCR
)) return dpyinfo
->Xatom_INCR
;
232 if (EQ (sym
, QEMACS_TMP
)) return dpyinfo
->Xatom_EMACS_TMP
;
233 if (EQ (sym
, QTARGETS
)) return dpyinfo
->Xatom_TARGETS
;
234 if (EQ (sym
, QNULL
)) return dpyinfo
->Xatom_NULL
;
235 if (!SYMBOLP (sym
)) abort ();
237 TRACE1 (" XInternAtom %s", SSDATA (SYMBOL_NAME (sym
)));
239 val
= XInternAtom (display
, SSDATA (SYMBOL_NAME (sym
)), False
);
245 /* This converts a server Atom to a Lisp symbol, avoiding server roundtrips
246 and calls to intern whenever possible. */
249 x_atom_to_symbol (Display
*dpy
, Atom atom
)
251 struct x_display_info
*dpyinfo
;
272 dpyinfo
= x_display_info_for_display (dpy
);
273 if (atom
== dpyinfo
->Xatom_CLIPBOARD
)
275 if (atom
== dpyinfo
->Xatom_TIMESTAMP
)
277 if (atom
== dpyinfo
->Xatom_TEXT
)
279 if (atom
== dpyinfo
->Xatom_COMPOUND_TEXT
)
280 return QCOMPOUND_TEXT
;
281 if (atom
== dpyinfo
->Xatom_UTF8_STRING
)
283 if (atom
== dpyinfo
->Xatom_DELETE
)
285 if (atom
== dpyinfo
->Xatom_MULTIPLE
)
287 if (atom
== dpyinfo
->Xatom_INCR
)
289 if (atom
== dpyinfo
->Xatom_EMACS_TMP
)
291 if (atom
== dpyinfo
->Xatom_TARGETS
)
293 if (atom
== dpyinfo
->Xatom_NULL
)
297 str
= XGetAtomName (dpy
, atom
);
299 TRACE1 ("XGetAtomName --> %s", str
);
300 if (! str
) return Qnil
;
303 /* This was allocated by Xlib, so use XFree. */
309 /* Do protocol to assert ourself as a selection owner.
310 Update the Vselection_alist so that we can reply to later requests for
314 x_own_selection (Lisp_Object selection_name
, Lisp_Object selection_value
)
316 struct frame
*sf
= SELECTED_FRAME ();
317 Window selecting_window
;
319 Time time
= last_event_timestamp
;
321 struct x_display_info
*dpyinfo
;
323 if (! FRAME_X_P (sf
))
326 selecting_window
= FRAME_X_WINDOW (sf
);
327 display
= FRAME_X_DISPLAY (sf
);
328 dpyinfo
= FRAME_X_DISPLAY_INFO (sf
);
330 CHECK_SYMBOL (selection_name
);
331 selection_atom
= symbol_to_x_atom (dpyinfo
, display
, selection_name
);
334 x_catch_errors (display
);
335 XSetSelectionOwner (display
, selection_atom
, selecting_window
, time
);
336 x_check_errors (display
, "Can't set selection: %s");
340 /* Now update the local cache */
342 Lisp_Object selection_time
;
343 Lisp_Object selection_data
;
344 Lisp_Object prev_value
;
346 selection_time
= long_to_cons ((unsigned long) time
);
347 selection_data
= list4 (selection_name
, selection_value
,
348 selection_time
, selected_frame
);
349 prev_value
= assq_no_quit (selection_name
, Vselection_alist
);
351 Vselection_alist
= Fcons (selection_data
, Vselection_alist
);
353 /* If we already owned the selection, remove the old selection data.
354 Perhaps we should destructively modify it instead.
355 Don't use Fdelq as that may QUIT. */
356 if (!NILP (prev_value
))
358 Lisp_Object rest
; /* we know it's not the CAR, so it's easy. */
359 for (rest
= Vselection_alist
; CONSP (rest
); rest
= XCDR (rest
))
360 if (EQ (prev_value
, Fcar (XCDR (rest
))))
362 XSETCDR (rest
, Fcdr (XCDR (rest
)));
369 /* Given a selection-name and desired type, look up our local copy of
370 the selection value and convert it to the type.
371 The value is nil or a string.
372 This function is used both for remote requests (LOCAL_REQUEST is zero)
373 and for local x-get-selection-internal (LOCAL_REQUEST is nonzero).
375 This calls random Lisp code, and may signal or gc. */
378 x_get_local_selection (Lisp_Object selection_symbol
, Lisp_Object target_type
, int local_request
)
380 Lisp_Object local_value
;
381 Lisp_Object handler_fn
, value
, type
, check
;
384 local_value
= assq_no_quit (selection_symbol
, Vselection_alist
);
386 if (NILP (local_value
)) return Qnil
;
388 /* TIMESTAMP and MULTIPLE are special cases 'cause that's easiest. */
389 if (EQ (target_type
, QTIMESTAMP
))
392 value
= XCAR (XCDR (XCDR (local_value
)));
395 else if (EQ (target_type
, QDELETE
))
398 Fx_disown_selection_internal
400 XCAR (XCDR (XCDR (local_value
))));
405 #if 0 /* #### MULTIPLE doesn't work yet */
406 else if (CONSP (target_type
)
407 && XCAR (target_type
) == QMULTIPLE
)
412 pairs
= XCDR (target_type
);
413 size
= XVECTOR (pairs
)->size
;
414 /* If the target is MULTIPLE, then target_type looks like
415 (MULTIPLE . [[SELECTION1 TARGET1] [SELECTION2 TARGET2] ... ])
416 We modify the second element of each pair in the vector and
417 return it as [[SELECTION1 <value1>] [SELECTION2 <value2>] ... ]
419 for (i
= 0; i
< size
; i
++)
422 pair
= XVECTOR (pairs
)->contents
[i
];
423 XVECTOR (pair
)->contents
[1]
424 = x_get_local_selection (XVECTOR (pair
)->contents
[0],
425 XVECTOR (pair
)->contents
[1],
433 /* Don't allow a quit within the converter.
434 When the user types C-g, he would be surprised
435 if by luck it came during a converter. */
436 count
= SPECPDL_INDEX ();
437 specbind (Qinhibit_quit
, Qt
);
439 CHECK_SYMBOL (target_type
);
440 handler_fn
= Fcdr (Fassq (target_type
, Vselection_converter_alist
));
441 /* gcpro is not needed here since nothing but HANDLER_FN
442 is live, and that ought to be a symbol. */
444 if (!NILP (handler_fn
))
445 value
= call3 (handler_fn
,
446 selection_symbol
, (local_request
? Qnil
: target_type
),
447 XCAR (XCDR (local_value
)));
450 unbind_to (count
, Qnil
);
453 /* Make sure this value is of a type that we could transmit
454 to another X client. */
458 && SYMBOLP (XCAR (value
)))
460 check
= XCDR (value
);
468 /* Check for a value that cons_to_long could handle. */
469 else if (CONSP (check
)
470 && INTEGERP (XCAR (check
))
471 && (INTEGERP (XCDR (check
))
473 (CONSP (XCDR (check
))
474 && INTEGERP (XCAR (XCDR (check
)))
475 && NILP (XCDR (XCDR (check
))))))
478 signal_error ("Invalid data returned by selection-conversion function",
479 list2 (handler_fn
, value
));
482 /* Subroutines of x_reply_selection_request. */
484 /* Send a SelectionNotify event to the requestor with property=None,
485 meaning we were unable to do what they wanted. */
488 x_decline_selection_request (struct input_event
*event
)
490 XSelectionEvent reply
;
492 reply
.type
= SelectionNotify
;
493 reply
.display
= SELECTION_EVENT_DISPLAY (event
);
494 reply
.requestor
= SELECTION_EVENT_REQUESTOR (event
);
495 reply
.selection
= SELECTION_EVENT_SELECTION (event
);
496 reply
.time
= SELECTION_EVENT_TIME (event
);
497 reply
.target
= SELECTION_EVENT_TARGET (event
);
498 reply
.property
= None
;
500 /* The reason for the error may be that the receiver has
501 died in the meantime. Handle that case. */
503 x_catch_errors (reply
.display
);
504 XSendEvent (reply
.display
, reply
.requestor
, False
, 0L, (XEvent
*) &reply
);
505 XFlush (reply
.display
);
510 /* This is the selection request currently being processed.
511 It is set to zero when the request is fully processed. */
512 static struct input_event
*x_selection_current_request
;
514 /* Display info in x_selection_request. */
516 static struct x_display_info
*selection_request_dpyinfo
;
518 /* Used as an unwind-protect clause so that, if a selection-converter signals
519 an error, we tell the requester that we were unable to do what they wanted
520 before we throw to top-level or go into the debugger or whatever. */
523 x_selection_request_lisp_error (Lisp_Object ignore
)
525 if (x_selection_current_request
!= 0
526 && selection_request_dpyinfo
->display
)
527 x_decline_selection_request (x_selection_current_request
);
532 x_catch_errors_unwind (Lisp_Object dummy
)
541 /* This stuff is so that INCR selections are reentrant (that is, so we can
542 be servicing multiple INCR selection requests simultaneously.) I haven't
543 actually tested that yet. */
545 /* Keep a list of the property changes that are awaited. */
555 struct prop_location
*next
;
558 static struct prop_location
*expect_property_change (Display
*display
, Window window
, Atom property
, int state
);
559 static void wait_for_property_change (struct prop_location
*location
);
560 static void unexpect_property_change (struct prop_location
*location
);
561 static int waiting_for_other_props_on_window (Display
*display
, Window window
);
563 static int prop_location_identifier
;
565 static Lisp_Object property_change_reply
;
567 static struct prop_location
*property_change_reply_object
;
569 static struct prop_location
*property_change_wait_list
;
572 queue_selection_requests_unwind (Lisp_Object tem
)
574 x_stop_queuing_selection_requests ();
578 /* Return some frame whose display info is DPYINFO.
579 Return nil if there is none. */
582 some_frame_on_display (struct x_display_info
*dpyinfo
)
584 Lisp_Object list
, frame
;
586 FOR_EACH_FRAME (list
, frame
)
588 if (FRAME_X_P (XFRAME (frame
))
589 && FRAME_X_DISPLAY_INFO (XFRAME (frame
)) == dpyinfo
)
596 /* Send the reply to a selection request event EVENT.
597 TYPE is the type of selection data requested.
598 DATA and SIZE describe the data to send, already converted.
599 FORMAT is the unit-size (in bits) of the data to be transmitted. */
601 #ifdef TRACE_SELECTION
602 static int x_reply_selection_request_cnt
;
603 #endif /* TRACE_SELECTION */
606 x_reply_selection_request (struct input_event
*event
, int format
, unsigned char *data
, int size
, Atom type
)
608 XSelectionEvent reply
;
609 Display
*display
= SELECTION_EVENT_DISPLAY (event
);
610 Window window
= SELECTION_EVENT_REQUESTOR (event
);
612 int format_bytes
= format
/8;
613 int max_bytes
= SELECTION_QUANTUM (display
);
614 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
615 int count
= SPECPDL_INDEX ();
617 if (max_bytes
> MAX_SELECTION_QUANTUM
)
618 max_bytes
= MAX_SELECTION_QUANTUM
;
620 reply
.type
= SelectionNotify
;
621 reply
.display
= display
;
622 reply
.requestor
= window
;
623 reply
.selection
= SELECTION_EVENT_SELECTION (event
);
624 reply
.time
= SELECTION_EVENT_TIME (event
);
625 reply
.target
= SELECTION_EVENT_TARGET (event
);
626 reply
.property
= SELECTION_EVENT_PROPERTY (event
);
627 if (reply
.property
== None
)
628 reply
.property
= reply
.target
;
631 /* The protected block contains wait_for_property_change, which can
632 run random lisp code (process handlers) or signal. Therefore, we
633 put the x_uncatch_errors call in an unwind. */
634 record_unwind_protect (x_catch_errors_unwind
, Qnil
);
635 x_catch_errors (display
);
637 #ifdef TRACE_SELECTION
639 char *sel
= XGetAtomName (display
, reply
.selection
);
640 char *tgt
= XGetAtomName (display
, reply
.target
);
641 TRACE3 ("%s, target %s (%d)", sel
, tgt
, ++x_reply_selection_request_cnt
);
642 if (sel
) XFree (sel
);
643 if (tgt
) XFree (tgt
);
645 #endif /* TRACE_SELECTION */
647 /* Store the data on the requested property.
648 If the selection is large, only store the first N bytes of it.
650 bytes_remaining
= size
* format_bytes
;
651 if (bytes_remaining
<= max_bytes
)
653 /* Send all the data at once, with minimal handshaking. */
654 TRACE1 ("Sending all %d bytes", bytes_remaining
);
655 XChangeProperty (display
, window
, reply
.property
, type
, format
,
656 PropModeReplace
, data
, size
);
657 /* At this point, the selection was successfully stored; ack it. */
658 XSendEvent (display
, window
, False
, 0L, (XEvent
*) &reply
);
662 /* Send an INCR selection. */
663 struct prop_location
*wait_object
;
667 frame
= some_frame_on_display (dpyinfo
);
669 /* If the display no longer has frames, we can't expect
670 to get many more selection requests from it, so don't
671 bother trying to queue them. */
674 x_start_queuing_selection_requests ();
676 record_unwind_protect (queue_selection_requests_unwind
,
680 if (x_window_to_frame (dpyinfo
, window
)) /* #### debug */
681 error ("Attempt to transfer an INCR to ourself!");
683 TRACE2 ("Start sending %d bytes incrementally (%s)",
684 bytes_remaining
, XGetAtomName (display
, reply
.property
));
685 wait_object
= expect_property_change (display
, window
, reply
.property
,
688 TRACE1 ("Set %s to number of bytes to send",
689 XGetAtomName (display
, reply
.property
));
691 /* XChangeProperty expects an array of long even if long is more than
695 value
[0] = bytes_remaining
;
696 XChangeProperty (display
, window
, reply
.property
, dpyinfo
->Xatom_INCR
,
698 (unsigned char *) value
, 1);
701 XSelectInput (display
, window
, PropertyChangeMask
);
703 /* Tell 'em the INCR data is there... */
704 TRACE0 ("Send SelectionNotify event");
705 XSendEvent (display
, window
, False
, 0L, (XEvent
*) &reply
);
708 had_errors
= x_had_errors_p (display
);
711 /* First, wait for the requester to ack by deleting the property.
712 This can run random lisp code (process handlers) or signal. */
715 TRACE1 ("Waiting for ACK (deletion of %s)",
716 XGetAtomName (display
, reply
.property
));
717 wait_for_property_change (wait_object
);
720 unexpect_property_change (wait_object
);
723 while (bytes_remaining
)
725 int i
= ((bytes_remaining
< max_bytes
)
727 : max_bytes
) / format_bytes
;
732 = expect_property_change (display
, window
, reply
.property
,
735 TRACE1 ("Sending increment of %d elements", i
);
736 TRACE1 ("Set %s to increment data",
737 XGetAtomName (display
, reply
.property
));
739 /* Append the next chunk of data to the property. */
740 XChangeProperty (display
, window
, reply
.property
, type
, format
,
741 PropModeAppend
, data
, i
);
742 bytes_remaining
-= i
* format_bytes
;
744 data
+= i
* sizeof (long);
746 data
+= i
* format_bytes
;
748 had_errors
= x_had_errors_p (display
);
754 /* Now wait for the requester to ack this chunk by deleting the
755 property. This can run random lisp code or signal. */
756 TRACE1 ("Waiting for increment ACK (deletion of %s)",
757 XGetAtomName (display
, reply
.property
));
758 wait_for_property_change (wait_object
);
761 /* Now write a zero-length chunk to the property to tell the
762 requester that we're done. */
764 if (! waiting_for_other_props_on_window (display
, window
))
765 XSelectInput (display
, window
, 0L);
767 TRACE1 ("Set %s to a 0-length chunk to indicate EOF",
768 XGetAtomName (display
, reply
.property
));
769 XChangeProperty (display
, window
, reply
.property
, type
, format
,
770 PropModeReplace
, data
, 0);
771 TRACE0 ("Done sending incrementally");
774 /* rms, 2003-01-03: I think I have fixed this bug. */
775 /* The window we're communicating with may have been deleted
776 in the meantime (that's a real situation from a bug report).
777 In this case, there may be events in the event queue still
778 refering to the deleted window, and we'll get a BadWindow error
779 in XTread_socket when processing the events. I don't have
780 an idea how to fix that. gerd, 2001-01-98. */
781 /* 2004-09-10: XSync and UNBLOCK so that possible protocol errors are
782 delivered before uncatch errors. */
783 XSync (display
, False
);
786 /* GTK queues events in addition to the queue in Xlib. So we
787 UNBLOCK to enter the event loop and get possible errors delivered,
788 and then BLOCK again because x_uncatch_errors requires it. */
790 /* This calls x_uncatch_errors. */
791 unbind_to (count
, Qnil
);
795 /* Handle a SelectionRequest event EVENT.
796 This is called from keyboard.c when such an event is found in the queue. */
799 x_handle_selection_request (struct input_event
*event
)
801 struct gcpro gcpro1
, gcpro2
, gcpro3
;
802 Lisp_Object local_selection_data
;
803 Lisp_Object selection_symbol
;
804 Lisp_Object target_symbol
;
805 Lisp_Object converted_selection
;
806 Time local_selection_time
;
807 Lisp_Object successful_p
;
809 struct x_display_info
*dpyinfo
810 = x_display_info_for_display (SELECTION_EVENT_DISPLAY (event
));
812 TRACE2 ("x_handle_selection_request, from=0x%08lx time=%lu",
813 (unsigned long) SELECTION_EVENT_REQUESTOR (event
),
814 (unsigned long) SELECTION_EVENT_TIME (event
));
816 local_selection_data
= Qnil
;
817 target_symbol
= Qnil
;
818 converted_selection
= Qnil
;
821 GCPRO3 (local_selection_data
, converted_selection
, target_symbol
);
823 selection_symbol
= x_atom_to_symbol (SELECTION_EVENT_DISPLAY (event
),
824 SELECTION_EVENT_SELECTION (event
));
826 local_selection_data
= assq_no_quit (selection_symbol
, Vselection_alist
);
828 if (NILP (local_selection_data
))
830 /* Someone asked for the selection, but we don't have it any more.
832 x_decline_selection_request (event
);
836 local_selection_time
= (Time
)
837 cons_to_long (XCAR (XCDR (XCDR (local_selection_data
))));
839 if (SELECTION_EVENT_TIME (event
) != CurrentTime
840 && local_selection_time
> SELECTION_EVENT_TIME (event
))
842 /* Someone asked for the selection, and we have one, but not the one
845 x_decline_selection_request (event
);
849 x_selection_current_request
= event
;
850 count
= SPECPDL_INDEX ();
851 selection_request_dpyinfo
= dpyinfo
;
852 record_unwind_protect (x_selection_request_lisp_error
, Qnil
);
854 target_symbol
= x_atom_to_symbol (SELECTION_EVENT_DISPLAY (event
),
855 SELECTION_EVENT_TARGET (event
));
857 #if 0 /* #### MULTIPLE doesn't work yet */
858 if (EQ (target_symbol
, QMULTIPLE
))
859 target_symbol
= fetch_multiple_target (event
);
862 /* Convert lisp objects back into binary data */
865 = x_get_local_selection (selection_symbol
, target_symbol
, 0);
867 if (! NILP (converted_selection
))
875 if (CONSP (converted_selection
) && NILP (XCDR (converted_selection
)))
877 x_decline_selection_request (event
);
881 lisp_data_to_selection_data (SELECTION_EVENT_DISPLAY (event
),
883 &data
, &type
, &size
, &format
, &nofree
);
885 x_reply_selection_request (event
, format
, data
, size
, type
);
888 /* Indicate we have successfully processed this event. */
889 x_selection_current_request
= 0;
891 /* Use xfree, not XFree, because lisp_data_to_selection_data
892 calls xmalloc itself. */
898 unbind_to (count
, Qnil
);
902 /* Let random lisp code notice that the selection has been asked for. */
905 rest
= Vx_sent_selection_functions
;
906 if (!EQ (rest
, Qunbound
))
907 for (; CONSP (rest
); rest
= Fcdr (rest
))
908 call3 (Fcar (rest
), selection_symbol
, target_symbol
, successful_p
);
914 /* Handle a SelectionClear event EVENT, which indicates that some
915 client cleared out our previously asserted selection.
916 This is called from keyboard.c when such an event is found in the queue. */
919 x_handle_selection_clear (struct input_event
*event
)
921 Display
*display
= SELECTION_EVENT_DISPLAY (event
);
922 Atom selection
= SELECTION_EVENT_SELECTION (event
);
923 Time changed_owner_time
= SELECTION_EVENT_TIME (event
);
925 Lisp_Object selection_symbol
, local_selection_data
;
926 Time local_selection_time
;
927 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
928 struct x_display_info
*t_dpyinfo
;
930 TRACE0 ("x_handle_selection_clear");
932 /* If the new selection owner is also Emacs,
933 don't clear the new selection. */
935 /* Check each display on the same terminal,
936 to see if this Emacs job now owns the selection
937 through that display. */
938 for (t_dpyinfo
= x_display_list
; t_dpyinfo
; t_dpyinfo
= t_dpyinfo
->next
)
939 if (t_dpyinfo
->terminal
->kboard
== dpyinfo
->terminal
->kboard
)
942 = XGetSelectionOwner (t_dpyinfo
->display
, selection
);
943 if (x_window_to_frame (t_dpyinfo
, owner_window
) != 0)
951 selection_symbol
= x_atom_to_symbol (display
, selection
);
953 local_selection_data
= assq_no_quit (selection_symbol
, Vselection_alist
);
955 /* Well, we already believe that we don't own it, so that's just fine. */
956 if (NILP (local_selection_data
)) return;
958 local_selection_time
= (Time
)
959 cons_to_long (XCAR (XCDR (XCDR (local_selection_data
))));
961 /* This SelectionClear is for a selection that we no longer own, so we can
962 disregard it. (That is, we have reasserted the selection since this
963 request was generated.) */
965 if (changed_owner_time
!= CurrentTime
966 && local_selection_time
> changed_owner_time
)
969 /* Otherwise, we're really honest and truly being told to drop it.
970 Don't use Fdelq as that may QUIT;. */
972 if (EQ (local_selection_data
, Fcar (Vselection_alist
)))
973 Vselection_alist
= Fcdr (Vselection_alist
);
977 for (rest
= Vselection_alist
; CONSP (rest
); rest
= XCDR (rest
))
978 if (EQ (local_selection_data
, Fcar (XCDR (rest
))))
980 XSETCDR (rest
, Fcdr (XCDR (rest
)));
985 /* Let random lisp code notice that the selection has been stolen. */
989 rest
= Vx_lost_selection_functions
;
990 if (!EQ (rest
, Qunbound
))
992 for (; CONSP (rest
); rest
= Fcdr (rest
))
993 call1 (Fcar (rest
), selection_symbol
);
994 prepare_menu_bars ();
995 redisplay_preserve_echo_area (20);
1001 x_handle_selection_event (struct input_event
*event
)
1003 TRACE0 ("x_handle_selection_event");
1005 if (event
->kind
== SELECTION_REQUEST_EVENT
)
1007 if (x_queue_selection_requests
)
1008 x_queue_event (event
);
1010 x_handle_selection_request (event
);
1013 x_handle_selection_clear (event
);
1017 /* Clear all selections that were made from frame F.
1018 We do this when about to delete a frame. */
1021 x_clear_frame_selections (FRAME_PTR f
)
1026 XSETFRAME (frame
, f
);
1028 /* Otherwise, we're really honest and truly being told to drop it.
1029 Don't use Fdelq as that may QUIT;. */
1031 /* Delete elements from the beginning of Vselection_alist. */
1032 while (!NILP (Vselection_alist
)
1033 && EQ (frame
, Fcar (Fcdr (Fcdr (Fcdr (Fcar (Vselection_alist
)))))))
1035 /* Let random Lisp code notice that the selection has been stolen. */
1036 Lisp_Object hooks
, selection_symbol
;
1038 hooks
= Vx_lost_selection_functions
;
1039 selection_symbol
= Fcar (Fcar (Vselection_alist
));
1041 if (!EQ (hooks
, Qunbound
))
1043 for (; CONSP (hooks
); hooks
= Fcdr (hooks
))
1044 call1 (Fcar (hooks
), selection_symbol
);
1045 #if 0 /* This can crash when deleting a frame
1046 from x_connection_closed. Anyway, it seems unnecessary;
1047 something else should cause a redisplay. */
1048 redisplay_preserve_echo_area (21);
1052 Vselection_alist
= Fcdr (Vselection_alist
);
1055 /* Delete elements after the beginning of Vselection_alist. */
1056 for (rest
= Vselection_alist
; CONSP (rest
); rest
= XCDR (rest
))
1057 if (EQ (frame
, Fcar (Fcdr (Fcdr (Fcdr (Fcar (XCDR (rest
))))))))
1059 /* Let random Lisp code notice that the selection has been stolen. */
1060 Lisp_Object hooks
, selection_symbol
;
1062 hooks
= Vx_lost_selection_functions
;
1063 selection_symbol
= Fcar (Fcar (XCDR (rest
)));
1065 if (!EQ (hooks
, Qunbound
))
1067 for (; CONSP (hooks
); hooks
= Fcdr (hooks
))
1068 call1 (Fcar (hooks
), selection_symbol
);
1069 #if 0 /* See above */
1070 redisplay_preserve_echo_area (22);
1073 XSETCDR (rest
, Fcdr (XCDR (rest
)));
1078 /* Nonzero if any properties for DISPLAY and WINDOW
1079 are on the list of what we are waiting for. */
1082 waiting_for_other_props_on_window (Display
*display
, Window window
)
1084 struct prop_location
*rest
= property_change_wait_list
;
1086 if (rest
->display
== display
&& rest
->window
== window
)
1093 /* Add an entry to the list of property changes we are waiting for.
1094 DISPLAY, WINDOW, PROPERTY, STATE describe what we will wait for.
1095 The return value is a number that uniquely identifies
1096 this awaited property change. */
1098 static struct prop_location
*
1099 expect_property_change (Display
*display
, Window window
, Atom property
, int state
)
1101 struct prop_location
*pl
= (struct prop_location
*) xmalloc (sizeof *pl
);
1102 pl
->identifier
= ++prop_location_identifier
;
1103 pl
->display
= display
;
1104 pl
->window
= window
;
1105 pl
->property
= property
;
1106 pl
->desired_state
= state
;
1107 pl
->next
= property_change_wait_list
;
1109 property_change_wait_list
= pl
;
1113 /* Delete an entry from the list of property changes we are waiting for.
1114 IDENTIFIER is the number that uniquely identifies the entry. */
1117 unexpect_property_change (struct prop_location
*location
)
1119 struct prop_location
*prev
= 0, *rest
= property_change_wait_list
;
1122 if (rest
== location
)
1125 prev
->next
= rest
->next
;
1127 property_change_wait_list
= rest
->next
;
1136 /* Remove the property change expectation element for IDENTIFIER. */
1139 wait_for_property_change_unwind (Lisp_Object loc
)
1141 struct prop_location
*location
= XSAVE_VALUE (loc
)->pointer
;
1143 unexpect_property_change (location
);
1144 if (location
== property_change_reply_object
)
1145 property_change_reply_object
= 0;
1149 /* Actually wait for a property change.
1150 IDENTIFIER should be the value that expect_property_change returned. */
1153 wait_for_property_change (struct prop_location
*location
)
1156 int count
= SPECPDL_INDEX ();
1158 if (property_change_reply_object
)
1161 /* Make sure to do unexpect_property_change if we quit or err. */
1162 record_unwind_protect (wait_for_property_change_unwind
,
1163 make_save_value (location
, 0));
1165 XSETCAR (property_change_reply
, Qnil
);
1166 property_change_reply_object
= location
;
1168 /* If the event we are waiting for arrives beyond here, it will set
1169 property_change_reply, because property_change_reply_object says so. */
1170 if (! location
->arrived
)
1172 secs
= x_selection_timeout
/ 1000;
1173 usecs
= (x_selection_timeout
% 1000) * 1000;
1174 TRACE2 (" Waiting %d secs, %d usecs", secs
, usecs
);
1175 wait_reading_process_output (secs
, usecs
, 0, 0,
1176 property_change_reply
, NULL
, 0);
1178 if (NILP (XCAR (property_change_reply
)))
1180 TRACE0 (" Timed out");
1181 error ("Timed out waiting for property-notify event");
1185 unbind_to (count
, Qnil
);
1188 /* Called from XTread_socket in response to a PropertyNotify event. */
1191 x_handle_property_notify (XPropertyEvent
*event
)
1193 struct prop_location
*prev
= 0, *rest
= property_change_wait_list
;
1198 && rest
->property
== event
->atom
1199 && rest
->window
== event
->window
1200 && rest
->display
== event
->display
1201 && rest
->desired_state
== event
->state
)
1203 TRACE2 ("Expected %s of property %s",
1204 (event
->state
== PropertyDelete
? "deletion" : "change"),
1205 XGetAtomName (event
->display
, event
->atom
));
1209 /* If this is the one wait_for_property_change is waiting for,
1210 tell it to wake up. */
1211 if (rest
== property_change_reply_object
)
1212 XSETCAR (property_change_reply
, Qt
);
1224 #if 0 /* #### MULTIPLE doesn't work yet */
1227 fetch_multiple_target (event
)
1228 XSelectionRequestEvent
*event
;
1230 Display
*display
= event
->display
;
1231 Window window
= event
->requestor
;
1232 Atom target
= event
->target
;
1233 Atom selection_atom
= event
->selection
;
1238 x_get_window_property_as_lisp_data (display
, window
, target
,
1239 QMULTIPLE
, selection_atom
));
1243 copy_multiple_data (obj
)
1250 return Fcons (XCAR (obj
), copy_multiple_data (XCDR (obj
)));
1253 vec
= Fmake_vector (size
= XVECTOR (obj
)->size
, Qnil
);
1254 for (i
= 0; i
< size
; i
++)
1256 Lisp_Object vec2
= XVECTOR (obj
)->contents
[i
];
1257 CHECK_VECTOR (vec2
);
1258 if (XVECTOR (vec2
)->size
!= 2)
1259 /* ??? Confusing error message */
1260 signal_error ("Vectors must be of length 2", vec2
);
1261 XVECTOR (vec
)->contents
[i
] = Fmake_vector (2, Qnil
);
1262 XVECTOR (XVECTOR (vec
)->contents
[i
])->contents
[0]
1263 = XVECTOR (vec2
)->contents
[0];
1264 XVECTOR (XVECTOR (vec
)->contents
[i
])->contents
[1]
1265 = XVECTOR (vec2
)->contents
[1];
1273 /* Variables for communication with x_handle_selection_notify. */
1274 static Atom reading_which_selection
;
1275 static Lisp_Object reading_selection_reply
;
1276 static Window reading_selection_window
;
1278 /* Do protocol to read selection-data from the server.
1279 Converts this to Lisp data and returns it. */
1282 x_get_foreign_selection (Lisp_Object selection_symbol
, Lisp_Object target_type
, Lisp_Object time_stamp
)
1284 struct frame
*sf
= SELECTED_FRAME ();
1285 Window requestor_window
;
1287 struct x_display_info
*dpyinfo
;
1288 Time requestor_time
= last_event_timestamp
;
1289 Atom target_property
;
1290 Atom selection_atom
;
1293 int count
= SPECPDL_INDEX ();
1296 if (! FRAME_X_P (sf
))
1299 requestor_window
= FRAME_X_WINDOW (sf
);
1300 display
= FRAME_X_DISPLAY (sf
);
1301 dpyinfo
= FRAME_X_DISPLAY_INFO (sf
);
1302 target_property
= dpyinfo
->Xatom_EMACS_TMP
;
1303 selection_atom
= symbol_to_x_atom (dpyinfo
, display
, selection_symbol
);
1305 if (CONSP (target_type
))
1306 type_atom
= symbol_to_x_atom (dpyinfo
, display
, XCAR (target_type
));
1308 type_atom
= symbol_to_x_atom (dpyinfo
, display
, target_type
);
1310 if (! NILP (time_stamp
))
1312 if (CONSP (time_stamp
))
1313 requestor_time
= (Time
) cons_to_long (time_stamp
);
1314 else if (INTEGERP (time_stamp
))
1315 requestor_time
= (Time
) XUINT (time_stamp
);
1316 else if (FLOATP (time_stamp
))
1317 requestor_time
= (Time
) XFLOAT_DATA (time_stamp
);
1319 error ("TIME_STAMP must be cons or number");
1324 /* The protected block contains wait_reading_process_output, which
1325 can run random lisp code (process handlers) or signal.
1326 Therefore, we put the x_uncatch_errors call in an unwind. */
1327 record_unwind_protect (x_catch_errors_unwind
, Qnil
);
1328 x_catch_errors (display
);
1330 TRACE2 ("Get selection %s, type %s",
1331 XGetAtomName (display
, type_atom
),
1332 XGetAtomName (display
, target_property
));
1334 XConvertSelection (display
, selection_atom
, type_atom
, target_property
,
1335 requestor_window
, requestor_time
);
1338 /* Prepare to block until the reply has been read. */
1339 reading_selection_window
= requestor_window
;
1340 reading_which_selection
= selection_atom
;
1341 XSETCAR (reading_selection_reply
, Qnil
);
1343 frame
= some_frame_on_display (dpyinfo
);
1345 /* If the display no longer has frames, we can't expect
1346 to get many more selection requests from it, so don't
1347 bother trying to queue them. */
1350 x_start_queuing_selection_requests ();
1352 record_unwind_protect (queue_selection_requests_unwind
,
1357 /* This allows quits. Also, don't wait forever. */
1358 secs
= x_selection_timeout
/ 1000;
1359 usecs
= (x_selection_timeout
% 1000) * 1000;
1360 TRACE1 (" Start waiting %d secs for SelectionNotify", secs
);
1361 wait_reading_process_output (secs
, usecs
, 0, 0,
1362 reading_selection_reply
, NULL
, 0);
1363 TRACE1 (" Got event = %d", !NILP (XCAR (reading_selection_reply
)));
1366 if (x_had_errors_p (display
))
1367 error ("Cannot get selection");
1368 /* This calls x_uncatch_errors. */
1369 unbind_to (count
, Qnil
);
1372 if (NILP (XCAR (reading_selection_reply
)))
1373 error ("Timed out waiting for reply from selection owner");
1374 if (EQ (XCAR (reading_selection_reply
), Qlambda
))
1377 /* Otherwise, the selection is waiting for us on the requested property. */
1379 x_get_window_property_as_lisp_data (display
, requestor_window
,
1380 target_property
, target_type
,
1384 /* Subroutines of x_get_window_property_as_lisp_data */
1386 /* Use xfree, not XFree, to free the data obtained with this function. */
1389 x_get_window_property (Display
*display
, Window window
, Atom property
,
1390 unsigned char **data_ret
, int *bytes_ret
,
1391 Atom
*actual_type_ret
, int *actual_format_ret
,
1392 unsigned long *actual_size_ret
, int delete_p
)
1395 unsigned long bytes_remaining
;
1397 unsigned char *tmp_data
= 0;
1399 int buffer_size
= SELECTION_QUANTUM (display
);
1401 if (buffer_size
> MAX_SELECTION_QUANTUM
)
1402 buffer_size
= MAX_SELECTION_QUANTUM
;
1406 /* First probe the thing to find out how big it is. */
1407 result
= XGetWindowProperty (display
, window
, property
,
1408 0L, 0L, False
, AnyPropertyType
,
1409 actual_type_ret
, actual_format_ret
,
1411 &bytes_remaining
, &tmp_data
);
1412 if (result
!= Success
)
1420 /* This was allocated by Xlib, so use XFree. */
1421 XFree ((char *) tmp_data
);
1423 if (*actual_type_ret
== None
|| *actual_format_ret
== 0)
1429 total_size
= bytes_remaining
+ 1;
1430 *data_ret
= (unsigned char *) xmalloc (total_size
);
1432 /* Now read, until we've gotten it all. */
1433 while (bytes_remaining
)
1435 #ifdef TRACE_SELECTION
1436 int last
= bytes_remaining
;
1439 = XGetWindowProperty (display
, window
, property
,
1440 (long)offset
/4, (long)buffer_size
/4,
1443 actual_type_ret
, actual_format_ret
,
1444 actual_size_ret
, &bytes_remaining
, &tmp_data
);
1446 TRACE2 ("Read %ld bytes from property %s",
1447 last
- bytes_remaining
,
1448 XGetAtomName (display
, property
));
1450 /* If this doesn't return Success at this point, it means that
1451 some clod deleted the selection while we were in the midst of
1452 reading it. Deal with that, I guess.... */
1453 if (result
!= Success
)
1456 /* The man page for XGetWindowProperty says:
1457 "If the returned format is 32, the returned data is represented
1458 as a long array and should be cast to that type to obtain the
1460 This applies even if long is more than 32 bits, the X library
1461 converts from 32 bit elements received from the X server to long
1462 and passes the long array to us. Thus, for that case memcpy can not
1463 be used. We convert to a 32 bit type here, because so much code
1466 The bytes and offsets passed to XGetWindowProperty refers to the
1467 property and those are indeed in 32 bit quantities if format is 32. */
1469 if (*actual_format_ret
== 32 && *actual_format_ret
< BITS_PER_LONG
)
1472 int *idata
= (int *) ((*data_ret
) + offset
);
1473 long *ldata
= (long *) tmp_data
;
1475 for (i
= 0; i
< *actual_size_ret
; ++i
)
1477 idata
[i
]= (int) ldata
[i
];
1483 *actual_size_ret
*= *actual_format_ret
/ 8;
1484 memcpy ((*data_ret
) + offset
, tmp_data
, *actual_size_ret
);
1485 offset
+= *actual_size_ret
;
1488 /* This was allocated by Xlib, so use XFree. */
1489 XFree ((char *) tmp_data
);
1494 *bytes_ret
= offset
;
1497 /* Use xfree, not XFree, to free the data obtained with this function. */
1500 receive_incremental_selection (Display
*display
, Window window
, Atom property
,
1501 Lisp_Object target_type
,
1502 unsigned int min_size_bytes
,
1503 unsigned char **data_ret
, int *size_bytes_ret
,
1504 Atom
*type_ret
, int *format_ret
,
1505 unsigned long *size_ret
)
1508 struct prop_location
*wait_object
;
1509 *size_bytes_ret
= min_size_bytes
;
1510 *data_ret
= (unsigned char *) xmalloc (*size_bytes_ret
);
1512 TRACE1 ("Read %d bytes incrementally", min_size_bytes
);
1514 /* At this point, we have read an INCR property.
1515 Delete the property to ack it.
1516 (But first, prepare to receive the next event in this handshake.)
1518 Now, we must loop, waiting for the sending window to put a value on
1519 that property, then reading the property, then deleting it to ack.
1520 We are done when the sender places a property of length 0.
1523 XSelectInput (display
, window
, STANDARD_EVENT_SET
| PropertyChangeMask
);
1524 TRACE1 (" Delete property %s",
1525 SDATA (SYMBOL_NAME (x_atom_to_symbol (display
, property
))));
1526 XDeleteProperty (display
, window
, property
);
1527 TRACE1 (" Expect new value of property %s",
1528 SDATA (SYMBOL_NAME (x_atom_to_symbol (display
, property
))));
1529 wait_object
= expect_property_change (display
, window
, property
,
1536 unsigned char *tmp_data
;
1539 TRACE0 (" Wait for property change");
1540 wait_for_property_change (wait_object
);
1542 /* expect it again immediately, because x_get_window_property may
1543 .. no it won't, I don't get it.
1544 .. Ok, I get it now, the Xt code that implements INCR is broken. */
1545 TRACE0 (" Get property value");
1546 x_get_window_property (display
, window
, property
,
1547 &tmp_data
, &tmp_size_bytes
,
1548 type_ret
, format_ret
, size_ret
, 1);
1550 TRACE1 (" Read increment of %d bytes", tmp_size_bytes
);
1552 if (tmp_size_bytes
== 0) /* we're done */
1554 TRACE0 ("Done reading incrementally");
1556 if (! waiting_for_other_props_on_window (display
, window
))
1557 XSelectInput (display
, window
, STANDARD_EVENT_SET
);
1558 /* Use xfree, not XFree, because x_get_window_property
1559 calls xmalloc itself. */
1565 TRACE1 (" ACK by deleting property %s",
1566 XGetAtomName (display
, property
));
1567 XDeleteProperty (display
, window
, property
);
1568 wait_object
= expect_property_change (display
, window
, property
,
1573 if (*size_bytes_ret
< offset
+ tmp_size_bytes
)
1575 *size_bytes_ret
= offset
+ tmp_size_bytes
;
1576 *data_ret
= (unsigned char *) xrealloc (*data_ret
, *size_bytes_ret
);
1579 memcpy ((*data_ret
) + offset
, tmp_data
, tmp_size_bytes
);
1580 offset
+= tmp_size_bytes
;
1582 /* Use xfree, not XFree, because x_get_window_property
1583 calls xmalloc itself. */
1589 /* Once a requested selection is "ready" (we got a SelectionNotify event),
1590 fetch value from property PROPERTY of X window WINDOW on display DISPLAY.
1591 TARGET_TYPE and SELECTION_ATOM are used in error message if this fails. */
1594 x_get_window_property_as_lisp_data (Display
*display
, Window window
,
1596 Lisp_Object target_type
,
1597 Atom selection_atom
)
1601 unsigned long actual_size
;
1602 unsigned char *data
= 0;
1605 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
1607 TRACE0 ("Reading selection data");
1609 x_get_window_property (display
, window
, property
, &data
, &bytes
,
1610 &actual_type
, &actual_format
, &actual_size
, 1);
1613 int there_is_a_selection_owner
;
1615 there_is_a_selection_owner
1616 = XGetSelectionOwner (display
, selection_atom
);
1618 if (there_is_a_selection_owner
)
1619 signal_error ("Selection owner couldn't convert",
1621 ? list2 (target_type
,
1622 x_atom_to_symbol (display
, actual_type
))
1625 signal_error ("No selection",
1626 x_atom_to_symbol (display
, selection_atom
));
1629 if (actual_type
== dpyinfo
->Xatom_INCR
)
1631 /* That wasn't really the data, just the beginning. */
1633 unsigned int min_size_bytes
= * ((unsigned int *) data
);
1635 /* Use xfree, not XFree, because x_get_window_property
1636 calls xmalloc itself. */
1637 xfree ((char *) data
);
1639 receive_incremental_selection (display
, window
, property
, target_type
,
1640 min_size_bytes
, &data
, &bytes
,
1641 &actual_type
, &actual_format
,
1646 TRACE1 (" Delete property %s", XGetAtomName (display
, property
));
1647 XDeleteProperty (display
, window
, property
);
1651 /* It's been read. Now convert it to a lisp object in some semi-rational
1653 val
= selection_data_to_lisp_data (display
, data
, bytes
,
1654 actual_type
, actual_format
);
1656 /* Use xfree, not XFree, because x_get_window_property
1657 calls xmalloc itself. */
1658 xfree ((char *) data
);
1662 /* These functions convert from the selection data read from the server into
1663 something that we can use from Lisp, and vice versa.
1665 Type: Format: Size: Lisp Type:
1666 ----- ------- ----- -----------
1669 ATOM 32 > 1 Vector of Symbols
1671 * 16 > 1 Vector of Integers
1672 * 32 1 if <=16 bits: Integer
1673 if > 16 bits: Cons of top16, bot16
1674 * 32 > 1 Vector of the above
1676 When converting a Lisp number to C, it is assumed to be of format 16 if
1677 it is an integer, and of format 32 if it is a cons of two integers.
1679 When converting a vector of numbers from Lisp to C, it is assumed to be
1680 of format 16 if every element in the vector is an integer, and is assumed
1681 to be of format 32 if any element is a cons of two integers.
1683 When converting an object to C, it may be of the form (SYMBOL . <data>)
1684 where SYMBOL is what we should claim that the type is. Format and
1685 representation are as above.
1687 Important: When format is 32, data should contain an array of int,
1688 not an array of long as the X library returns. This makes a difference
1689 when sizeof(long) != sizeof(int). */
1694 selection_data_to_lisp_data (Display
*display
, const unsigned char *data
,
1695 int size
, Atom type
, int format
)
1697 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
1699 if (type
== dpyinfo
->Xatom_NULL
)
1702 /* Convert any 8-bit data to a string, for compactness. */
1703 else if (format
== 8)
1705 Lisp_Object str
, lispy_type
;
1707 str
= make_unibyte_string ((char *) data
, size
);
1708 /* Indicate that this string is from foreign selection by a text
1709 property `foreign-selection' so that the caller of
1710 x-get-selection-internal (usually x-get-selection) can know
1711 that the string must be decode. */
1712 if (type
== dpyinfo
->Xatom_COMPOUND_TEXT
)
1713 lispy_type
= QCOMPOUND_TEXT
;
1714 else if (type
== dpyinfo
->Xatom_UTF8_STRING
)
1715 lispy_type
= QUTF8_STRING
;
1717 lispy_type
= QSTRING
;
1718 Fput_text_property (make_number (0), make_number (size
),
1719 Qforeign_selection
, lispy_type
, str
);
1722 /* Convert a single atom to a Lisp_Symbol. Convert a set of atoms to
1723 a vector of symbols.
1725 else if (type
== XA_ATOM
)
1728 /* On a 64 bit machine sizeof(Atom) == sizeof(long) == 8.
1729 But the callers of these function has made sure the data for
1730 format == 32 is an array of int. Thus, use int instead
1732 int *idata
= (int *) data
;
1734 if (size
== sizeof (int))
1735 return x_atom_to_symbol (display
, (Atom
) idata
[0]);
1738 Lisp_Object v
= Fmake_vector (make_number (size
/ sizeof (int)),
1740 for (i
= 0; i
< size
/ sizeof (int); i
++)
1741 Faset (v
, make_number (i
),
1742 x_atom_to_symbol (display
, (Atom
) idata
[i
]));
1747 /* Convert a single 16-bit number or a small 32-bit number to a Lisp_Int.
1748 If the number is 32 bits and won't fit in a Lisp_Int,
1749 convert it to a cons of integers, 16 bits in each half.
1751 else if (format
== 32 && size
== sizeof (int))
1752 return long_to_cons (((unsigned int *) data
) [0]);
1753 else if (format
== 16 && size
== sizeof (short))
1754 return make_number ((int) (((unsigned short *) data
) [0]));
1756 /* Convert any other kind of data to a vector of numbers, represented
1757 as above (as an integer, or a cons of two 16 bit integers.)
1759 else if (format
== 16)
1763 v
= Fmake_vector (make_number (size
/ 2), make_number (0));
1764 for (i
= 0; i
< size
/ 2; i
++)
1766 int j
= (int) ((unsigned short *) data
) [i
];
1767 Faset (v
, make_number (i
), make_number (j
));
1774 Lisp_Object v
= Fmake_vector (make_number (size
/ 4), make_number (0));
1775 for (i
= 0; i
< size
/ 4; i
++)
1777 unsigned int j
= ((unsigned int *) data
) [i
];
1778 Faset (v
, make_number (i
), long_to_cons (j
));
1785 /* Use xfree, not XFree, to free the data obtained with this function. */
1788 lisp_data_to_selection_data (Display
*display
, Lisp_Object obj
,
1789 unsigned char **data_ret
, Atom
*type_ret
,
1790 unsigned int *size_ret
,
1791 int *format_ret
, int *nofree_ret
)
1793 Lisp_Object type
= Qnil
;
1794 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
1798 if (CONSP (obj
) && SYMBOLP (XCAR (obj
)))
1802 if (CONSP (obj
) && NILP (XCDR (obj
)))
1806 if (EQ (obj
, QNULL
) || (EQ (type
, QNULL
)))
1807 { /* This is not the same as declining */
1813 else if (STRINGP (obj
))
1815 if (SCHARS (obj
) < SBYTES (obj
))
1816 /* OBJ is a multibyte string containing a non-ASCII char. */
1817 signal_error ("Non-ASCII string must be encoded in advance", obj
);
1821 *size_ret
= SBYTES (obj
);
1822 *data_ret
= SDATA (obj
);
1825 else if (SYMBOLP (obj
))
1829 *data_ret
= (unsigned char *) xmalloc (sizeof (Atom
) + 1);
1830 (*data_ret
) [sizeof (Atom
)] = 0;
1831 (*(Atom
**) data_ret
) [0] = symbol_to_x_atom (dpyinfo
, display
, obj
);
1832 if (NILP (type
)) type
= QATOM
;
1834 else if (INTEGERP (obj
)
1835 && XINT (obj
) < 0xFFFF
1836 && XINT (obj
) > -0xFFFF)
1840 *data_ret
= (unsigned char *) xmalloc (sizeof (short) + 1);
1841 (*data_ret
) [sizeof (short)] = 0;
1842 (*(short **) data_ret
) [0] = (short) XINT (obj
);
1843 if (NILP (type
)) type
= QINTEGER
;
1845 else if (INTEGERP (obj
)
1846 || (CONSP (obj
) && INTEGERP (XCAR (obj
))
1847 && (INTEGERP (XCDR (obj
))
1848 || (CONSP (XCDR (obj
))
1849 && INTEGERP (XCAR (XCDR (obj
)))))))
1853 *data_ret
= (unsigned char *) xmalloc (sizeof (long) + 1);
1854 (*data_ret
) [sizeof (long)] = 0;
1855 (*(unsigned long **) data_ret
) [0] = cons_to_long (obj
);
1856 if (NILP (type
)) type
= QINTEGER
;
1858 else if (VECTORP (obj
))
1860 /* Lisp_Vectors may represent a set of ATOMs;
1861 a set of 16 or 32 bit INTEGERs;
1862 or a set of ATOM_PAIRs (represented as [[A1 A2] [A3 A4] ...]
1866 if (SYMBOLP (XVECTOR (obj
)->contents
[0]))
1867 /* This vector is an ATOM set */
1869 if (NILP (type
)) type
= QATOM
;
1870 *size_ret
= XVECTOR (obj
)->size
;
1872 *data_ret
= (unsigned char *) xmalloc ((*size_ret
) * sizeof (Atom
));
1873 for (i
= 0; i
< *size_ret
; i
++)
1874 if (SYMBOLP (XVECTOR (obj
)->contents
[i
]))
1875 (*(Atom
**) data_ret
) [i
]
1876 = symbol_to_x_atom (dpyinfo
, display
, XVECTOR (obj
)->contents
[i
]);
1878 signal_error ("All elements of selection vector must have same type", obj
);
1880 #if 0 /* #### MULTIPLE doesn't work yet */
1881 else if (VECTORP (XVECTOR (obj
)->contents
[0]))
1882 /* This vector is an ATOM_PAIR set */
1884 if (NILP (type
)) type
= QATOM_PAIR
;
1885 *size_ret
= XVECTOR (obj
)->size
;
1887 *data_ret
= (unsigned char *)
1888 xmalloc ((*size_ret
) * sizeof (Atom
) * 2);
1889 for (i
= 0; i
< *size_ret
; i
++)
1890 if (VECTORP (XVECTOR (obj
)->contents
[i
]))
1892 Lisp_Object pair
= XVECTOR (obj
)->contents
[i
];
1893 if (XVECTOR (pair
)->size
!= 2)
1895 "Elements of the vector must be vectors of exactly two elements",
1898 (*(Atom
**) data_ret
) [i
* 2]
1899 = symbol_to_x_atom (dpyinfo
, display
,
1900 XVECTOR (pair
)->contents
[0]);
1901 (*(Atom
**) data_ret
) [(i
* 2) + 1]
1902 = symbol_to_x_atom (dpyinfo
, display
,
1903 XVECTOR (pair
)->contents
[1]);
1906 signal_error ("All elements of the vector must be of the same type",
1912 /* This vector is an INTEGER set, or something like it */
1915 *size_ret
= XVECTOR (obj
)->size
;
1916 if (NILP (type
)) type
= QINTEGER
;
1918 for (i
= 0; i
< *size_ret
; i
++)
1919 if (CONSP (XVECTOR (obj
)->contents
[i
]))
1921 else if (!INTEGERP (XVECTOR (obj
)->contents
[i
]))
1922 signal_error (/* Qselection_error */
1923 "Elements of selection vector must be integers or conses of integers",
1926 /* Use sizeof(long) even if it is more than 32 bits. See comment
1927 in x_get_window_property and x_fill_property_data. */
1929 if (*format_ret
== 32) data_size
= sizeof(long);
1930 *data_ret
= (unsigned char *) xmalloc (*size_ret
* data_size
);
1931 for (i
= 0; i
< *size_ret
; i
++)
1932 if (*format_ret
== 32)
1933 (*((unsigned long **) data_ret
)) [i
]
1934 = cons_to_long (XVECTOR (obj
)->contents
[i
]);
1936 (*((unsigned short **) data_ret
)) [i
]
1937 = (unsigned short) cons_to_long (XVECTOR (obj
)->contents
[i
]);
1941 signal_error (/* Qselection_error */ "Unrecognized selection data", obj
);
1943 *type_ret
= symbol_to_x_atom (dpyinfo
, display
, type
);
1947 clean_local_selection_data (Lisp_Object obj
)
1950 && INTEGERP (XCAR (obj
))
1951 && CONSP (XCDR (obj
))
1952 && INTEGERP (XCAR (XCDR (obj
)))
1953 && NILP (XCDR (XCDR (obj
))))
1954 obj
= Fcons (XCAR (obj
), XCDR (obj
));
1957 && INTEGERP (XCAR (obj
))
1958 && INTEGERP (XCDR (obj
)))
1960 if (XINT (XCAR (obj
)) == 0)
1962 if (XINT (XCAR (obj
)) == -1)
1963 return make_number (- XINT (XCDR (obj
)));
1968 int size
= XVECTOR (obj
)->size
;
1971 return clean_local_selection_data (XVECTOR (obj
)->contents
[0]);
1972 copy
= Fmake_vector (make_number (size
), Qnil
);
1973 for (i
= 0; i
< size
; i
++)
1974 XVECTOR (copy
)->contents
[i
]
1975 = clean_local_selection_data (XVECTOR (obj
)->contents
[i
]);
1981 /* Called from XTread_socket to handle SelectionNotify events.
1982 If it's the selection we are waiting for, stop waiting
1983 by setting the car of reading_selection_reply to non-nil.
1984 We store t there if the reply is successful, lambda if not. */
1987 x_handle_selection_notify (XSelectionEvent
*event
)
1989 if (event
->requestor
!= reading_selection_window
)
1991 if (event
->selection
!= reading_which_selection
)
1994 TRACE0 ("Received SelectionNotify");
1995 XSETCAR (reading_selection_reply
,
1996 (event
->property
!= 0 ? Qt
: Qlambda
));
2000 DEFUN ("x-own-selection-internal", Fx_own_selection_internal
,
2001 Sx_own_selection_internal
, 2, 2, 0,
2002 doc
: /* Assert an X selection of the given TYPE with the given VALUE.
2003 TYPE is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.
2004 \(Those are literal upper-case symbol names, since that's what X expects.)
2005 VALUE is typically a string, or a cons of two markers, but may be
2006 anything that the functions on `selection-converter-alist' know about. */)
2007 (Lisp_Object selection_name
, Lisp_Object selection_value
)
2010 CHECK_SYMBOL (selection_name
);
2011 if (NILP (selection_value
)) error ("SELECTION-VALUE may not be nil");
2012 x_own_selection (selection_name
, selection_value
);
2013 return selection_value
;
2017 /* Request the selection value from the owner. If we are the owner,
2018 simply return our selection value. If we are not the owner, this
2019 will block until all of the data has arrived. */
2021 DEFUN ("x-get-selection-internal", Fx_get_selection_internal
,
2022 Sx_get_selection_internal
, 2, 3, 0,
2023 doc
: /* Return text selected from some X window.
2024 SELECTION is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.
2025 \(Those are literal upper-case symbol names, since that's what X expects.)
2026 TYPE is the type of data desired, typically `STRING'.
2027 TIME_STAMP is the time to use in the XConvertSelection call for foreign
2028 selections. If omitted, defaults to the time for the last event. */)
2029 (Lisp_Object selection_symbol
, Lisp_Object target_type
, Lisp_Object time_stamp
)
2031 Lisp_Object val
= Qnil
;
2032 struct gcpro gcpro1
, gcpro2
;
2033 GCPRO2 (target_type
, val
); /* we store newly consed data into these */
2035 CHECK_SYMBOL (selection_symbol
);
2037 #if 0 /* #### MULTIPLE doesn't work yet */
2038 if (CONSP (target_type
)
2039 && XCAR (target_type
) == QMULTIPLE
)
2041 CHECK_VECTOR (XCDR (target_type
));
2042 /* So we don't destructively modify this... */
2043 target_type
= copy_multiple_data (target_type
);
2047 CHECK_SYMBOL (target_type
);
2049 val
= x_get_local_selection (selection_symbol
, target_type
, 1);
2053 val
= x_get_foreign_selection (selection_symbol
, target_type
, time_stamp
);
2058 && SYMBOLP (XCAR (val
)))
2061 if (CONSP (val
) && NILP (XCDR (val
)))
2064 val
= clean_local_selection_data (val
);
2070 DEFUN ("x-disown-selection-internal", Fx_disown_selection_internal
,
2071 Sx_disown_selection_internal
, 1, 2, 0,
2072 doc
: /* If we own the selection SELECTION, disown it.
2073 Disowning it means there is no such selection. */)
2074 (Lisp_Object selection
, Lisp_Object time
)
2077 Atom selection_atom
;
2079 struct selection_input_event sie
;
2080 struct input_event ie
;
2083 struct x_display_info
*dpyinfo
;
2084 struct frame
*sf
= SELECTED_FRAME ();
2087 if (! FRAME_X_P (sf
))
2090 display
= FRAME_X_DISPLAY (sf
);
2091 dpyinfo
= FRAME_X_DISPLAY_INFO (sf
);
2092 CHECK_SYMBOL (selection
);
2094 timestamp
= last_event_timestamp
;
2096 timestamp
= cons_to_long (time
);
2098 if (NILP (assq_no_quit (selection
, Vselection_alist
)))
2099 return Qnil
; /* Don't disown the selection when we're not the owner. */
2101 selection_atom
= symbol_to_x_atom (dpyinfo
, display
, selection
);
2104 XSetSelectionOwner (display
, selection_atom
, None
, timestamp
);
2107 /* It doesn't seem to be guaranteed that a SelectionClear event will be
2108 generated for a window which owns the selection when that window sets
2109 the selection owner to None. The NCD server does, the MIT Sun4 server
2110 doesn't. So we synthesize one; this means we might get two, but
2111 that's ok, because the second one won't have any effect. */
2112 SELECTION_EVENT_DISPLAY (&event
.sie
) = display
;
2113 SELECTION_EVENT_SELECTION (&event
.sie
) = selection_atom
;
2114 SELECTION_EVENT_TIME (&event
.sie
) = timestamp
;
2115 x_handle_selection_clear (&event
.ie
);
2120 /* Get rid of all the selections in buffer BUFFER.
2121 This is used when we kill a buffer. */
2124 x_disown_buffer_selections (Lisp_Object buffer
)
2127 struct buffer
*buf
= XBUFFER (buffer
);
2129 for (tail
= Vselection_alist
; CONSP (tail
); tail
= XCDR (tail
))
2131 Lisp_Object elt
, value
;
2134 if (CONSP (value
) && MARKERP (XCAR (value
))
2135 && XMARKER (XCAR (value
))->buffer
== buf
)
2136 Fx_disown_selection_internal (XCAR (elt
), Qnil
);
2140 DEFUN ("x-selection-owner-p", Fx_selection_owner_p
, Sx_selection_owner_p
,
2142 doc
: /* Whether the current Emacs process owns the given X Selection.
2143 The arg should be the name of the selection in question, typically one of
2144 the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.
2145 \(Those are literal upper-case symbol names, since that's what X expects.)
2146 For convenience, the symbol nil is the same as `PRIMARY',
2147 and t is the same as `SECONDARY'. */)
2148 (Lisp_Object selection
)
2151 CHECK_SYMBOL (selection
);
2152 if (EQ (selection
, Qnil
)) selection
= QPRIMARY
;
2153 if (EQ (selection
, Qt
)) selection
= QSECONDARY
;
2155 if (NILP (Fassq (selection
, Vselection_alist
)))
2160 DEFUN ("x-selection-exists-p", Fx_selection_exists_p
, Sx_selection_exists_p
,
2162 doc
: /* Whether there is an owner for the given X Selection.
2163 The arg should be the name of the selection in question, typically one of
2164 the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.
2165 \(Those are literal upper-case symbol names, since that's what X expects.)
2166 For convenience, the symbol nil is the same as `PRIMARY',
2167 and t is the same as `SECONDARY'. */)
2168 (Lisp_Object selection
)
2173 struct frame
*sf
= SELECTED_FRAME ();
2175 /* It should be safe to call this before we have an X frame. */
2176 if (! FRAME_X_P (sf
))
2179 dpy
= FRAME_X_DISPLAY (sf
);
2180 CHECK_SYMBOL (selection
);
2181 if (!NILP (Fx_selection_owner_p (selection
)))
2183 if (EQ (selection
, Qnil
)) selection
= QPRIMARY
;
2184 if (EQ (selection
, Qt
)) selection
= QSECONDARY
;
2185 atom
= symbol_to_x_atom (FRAME_X_DISPLAY_INFO (sf
), dpy
, selection
);
2189 owner
= XGetSelectionOwner (dpy
, atom
);
2191 return (owner
? Qt
: Qnil
);
2195 /***********************************************************************
2196 Drag and drop support
2197 ***********************************************************************/
2198 /* Check that lisp values are of correct type for x_fill_property_data.
2199 That is, number, string or a cons with two numbers (low and high 16
2200 bit parts of a 32 bit number). */
2203 x_check_property_data (Lisp_Object data
)
2208 for (iter
= data
; CONSP (iter
) && size
!= -1; iter
= XCDR (iter
), ++size
)
2210 Lisp_Object o
= XCAR (iter
);
2212 if (! NUMBERP (o
) && ! STRINGP (o
) && ! CONSP (o
))
2214 else if (CONSP (o
) &&
2215 (! NUMBERP (XCAR (o
)) || ! NUMBERP (XCDR (o
))))
2222 /* Convert lisp values to a C array. Values may be a number, a string
2223 which is taken as an X atom name and converted to the atom value, or
2224 a cons containing the two 16 bit parts of a 32 bit number.
2226 DPY is the display use to look up X atoms.
2227 DATA is a Lisp list of values to be converted.
2228 RET is the C array that contains the converted values. It is assumed
2229 it is big enough to hold all values.
2230 FORMAT is 8, 16 or 32 and denotes char/short/long for each C value to
2231 be stored in RET. Note that long is used for 32 even if long is more
2232 than 32 bits (see man pages for XChangeProperty, XGetWindowProperty and
2233 XClientMessageEvent). */
2236 x_fill_property_data (Display
*dpy
, Lisp_Object data
, void *ret
, int format
)
2239 long *d32
= (long *) ret
;
2240 short *d16
= (short *) ret
;
2241 char *d08
= (char *) ret
;
2244 for (iter
= data
; CONSP (iter
); iter
= XCDR (iter
))
2246 Lisp_Object o
= XCAR (iter
);
2249 val
= (long) XFASTINT (o
);
2250 else if (FLOATP (o
))
2251 val
= (long) XFLOAT_DATA (o
);
2253 val
= (long) cons_to_long (o
);
2254 else if (STRINGP (o
))
2257 val
= (long) XInternAtom (dpy
, SSDATA (o
), False
);
2261 error ("Wrong type, must be string, number or cons");
2264 *d08
++ = (char) val
;
2265 else if (format
== 16)
2266 *d16
++ = (short) val
;
2272 /* Convert an array of C values to a Lisp list.
2273 F is the frame to be used to look up X atoms if the TYPE is XA_ATOM.
2274 DATA is a C array of values to be converted.
2275 TYPE is the type of the data. Only XA_ATOM is special, it converts
2276 each number in DATA to its corresponfing X atom as a symbol.
2277 FORMAT is 8, 16 or 32 and gives the size in bits for each C value to
2279 SIZE is the number of elements in DATA.
2281 Important: When format is 32, data should contain an array of int,
2282 not an array of long as the X library returns. This makes a difference
2283 when sizeof(long) != sizeof(int).
2285 Also see comment for selection_data_to_lisp_data above. */
2288 x_property_data_to_lisp (struct frame
*f
, const unsigned char *data
,
2289 Atom type
, int format
, long unsigned int size
)
2291 return selection_data_to_lisp_data (FRAME_X_DISPLAY (f
),
2292 data
, size
*format
/8, type
, format
);
2295 /* Get the mouse position in frame relative coordinates. */
2298 mouse_position_for_drop (FRAME_PTR f
, int *x
, int *y
)
2300 Window root
, dummy_window
;
2305 XQueryPointer (FRAME_X_DISPLAY (f
),
2306 DefaultRootWindow (FRAME_X_DISPLAY (f
)),
2308 /* The root window which contains the pointer. */
2311 /* Window pointer is on, not used */
2314 /* The position on that root window. */
2317 /* x/y in dummy_window coordinates, not used. */
2320 /* Modifier keys and pointer buttons, about which
2322 (unsigned int *) &dummy
);
2325 /* Absolute to relative. */
2326 *x
-= f
->left_pos
+ FRAME_OUTER_TO_INNER_DIFF_X (f
);
2327 *y
-= f
->top_pos
+ FRAME_OUTER_TO_INNER_DIFF_Y (f
);
2332 DEFUN ("x-get-atom-name", Fx_get_atom_name
,
2333 Sx_get_atom_name
, 1, 2, 0,
2334 doc
: /* Return the X atom name for VALUE as a string.
2335 VALUE may be a number or a cons where the car is the upper 16 bits and
2336 the cdr is the lower 16 bits of a 32 bit value.
2337 Use the display for FRAME or the current frame if FRAME is not given or nil.
2339 If the value is 0 or the atom is not known, return the empty string. */)
2340 (Lisp_Object value
, Lisp_Object frame
)
2342 struct frame
*f
= check_x_frame (frame
);
2345 Lisp_Object ret
= Qnil
;
2346 Display
*dpy
= FRAME_X_DISPLAY (f
);
2350 if (INTEGERP (value
))
2351 atom
= (Atom
) XUINT (value
);
2352 else if (FLOATP (value
))
2353 atom
= (Atom
) XFLOAT_DATA (value
);
2354 else if (CONSP (value
))
2355 atom
= (Atom
) cons_to_long (value
);
2357 error ("Wrong type, value must be number or cons");
2360 x_catch_errors (dpy
);
2361 name
= atom
? XGetAtomName (dpy
, atom
) : empty
;
2362 had_errors
= x_had_errors_p (dpy
);
2363 x_uncatch_errors ();
2366 ret
= make_string (name
, strlen (name
));
2368 if (atom
&& name
) XFree (name
);
2369 if (NILP (ret
)) ret
= empty_unibyte_string
;
2376 DEFUN ("x-register-dnd-atom", Fx_register_dnd_atom
,
2377 Sx_register_dnd_atom
, 1, 2, 0,
2378 doc
: /* Request that dnd events are made for ClientMessages with ATOM.
2379 ATOM can be a symbol or a string. The ATOM is interned on the display that
2380 FRAME is on. If FRAME is nil, the selected frame is used. */)
2381 (Lisp_Object atom
, Lisp_Object frame
)
2384 struct frame
*f
= check_x_frame (frame
);
2386 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
2390 x_atom
= symbol_to_x_atom (dpyinfo
, FRAME_X_DISPLAY (f
), atom
);
2391 else if (STRINGP (atom
))
2394 x_atom
= XInternAtom (FRAME_X_DISPLAY (f
), SSDATA (atom
), False
);
2398 error ("ATOM must be a symbol or a string");
2400 for (i
= 0; i
< dpyinfo
->x_dnd_atoms_length
; ++i
)
2401 if (dpyinfo
->x_dnd_atoms
[i
] == x_atom
)
2404 if (dpyinfo
->x_dnd_atoms_length
== dpyinfo
->x_dnd_atoms_size
)
2406 dpyinfo
->x_dnd_atoms_size
*= 2;
2407 dpyinfo
->x_dnd_atoms
= xrealloc (dpyinfo
->x_dnd_atoms
,
2408 sizeof (*dpyinfo
->x_dnd_atoms
)
2409 * dpyinfo
->x_dnd_atoms_size
);
2412 dpyinfo
->x_dnd_atoms
[dpyinfo
->x_dnd_atoms_length
++] = x_atom
;
2416 /* Convert an XClientMessageEvent to a Lisp event of type DRAG_N_DROP_EVENT. */
2419 x_handle_dnd_message (struct frame
*f
, XClientMessageEvent
*event
, struct x_display_info
*dpyinfo
, struct input_event
*bufp
)
2423 /* format 32 => size 5, format 16 => size 10, format 8 => size 20 */
2424 unsigned long size
= 160/event
->format
;
2426 unsigned char *data
= (unsigned char *) event
->data
.b
;
2430 for (i
= 0; i
< dpyinfo
->x_dnd_atoms_length
; ++i
)
2431 if (dpyinfo
->x_dnd_atoms
[i
] == event
->message_type
) break;
2433 if (i
== dpyinfo
->x_dnd_atoms_length
) return 0;
2435 XSETFRAME (frame
, f
);
2437 /* On a 64 bit machine, the event->data.l array members are 64 bits (long),
2438 but the x_property_data_to_lisp (or rather selection_data_to_lisp_data)
2439 function expects them to be of size int (i.e. 32). So to be able to
2440 use that function, put the data in the form it expects if format is 32. */
2442 if (event
->format
== 32 && event
->format
< BITS_PER_LONG
)
2445 for (i
= 0; i
< 5; ++i
) /* There are only 5 longs in a ClientMessage. */
2446 idata
[i
] = (int) event
->data
.l
[i
];
2447 data
= (unsigned char *) idata
;
2450 vec
= Fmake_vector (make_number (4), Qnil
);
2451 ASET (vec
, 0, SYMBOL_NAME (x_atom_to_symbol (FRAME_X_DISPLAY (f
),
2452 event
->message_type
)));
2453 ASET (vec
, 1, frame
);
2454 ASET (vec
, 2, make_number (event
->format
));
2455 ASET (vec
, 3, x_property_data_to_lisp (f
,
2457 event
->message_type
,
2461 mouse_position_for_drop (f
, &x
, &y
);
2462 bufp
->kind
= DRAG_N_DROP_EVENT
;
2463 bufp
->frame_or_window
= frame
;
2464 bufp
->timestamp
= CurrentTime
;
2465 bufp
->x
= make_number (x
);
2466 bufp
->y
= make_number (y
);
2468 bufp
->modifiers
= 0;
2473 DEFUN ("x-send-client-message", Fx_send_client_event
,
2474 Sx_send_client_message
, 6, 6, 0,
2475 doc
: /* Send a client message of MESSAGE-TYPE to window DEST on DISPLAY.
2477 For DISPLAY, specify either a frame or a display name (a string).
2478 If DISPLAY is nil, that stands for the selected frame's display.
2479 DEST may be a number, in which case it is a Window id. The value 0 may
2480 be used to send to the root window of the DISPLAY.
2481 If DEST is a cons, it is converted to a 32 bit number
2482 with the high 16 bits from the car and the lower 16 bit from the cdr. That
2483 number is then used as a window id.
2484 If DEST is a frame the event is sent to the outer window of that frame.
2485 A value of nil means the currently selected frame.
2486 If DEST is the string "PointerWindow" the event is sent to the window that
2487 contains the pointer. If DEST is the string "InputFocus" the event is
2488 sent to the window that has the input focus.
2489 FROM is the frame sending the event. Use nil for currently selected frame.
2490 MESSAGE-TYPE is the name of an Atom as a string.
2491 FORMAT must be one of 8, 16 or 32 and determines the size of the values in
2492 bits. VALUES is a list of numbers, cons and/or strings containing the values
2493 to send. If a value is a string, it is converted to an Atom and the value of
2494 the Atom is sent. If a value is a cons, it is converted to a 32 bit number
2495 with the high 16 bits from the car and the lower 16 bit from the cdr.
2496 If more values than fits into the event is given, the excessive values
2498 (Lisp_Object display
, Lisp_Object dest
, Lisp_Object from
, Lisp_Object message_type
, Lisp_Object format
, Lisp_Object values
)
2500 struct x_display_info
*dpyinfo
= check_x_display_info (display
);
2502 CHECK_STRING (message_type
);
2503 x_send_client_event(display
, dest
, from
,
2504 XInternAtom (dpyinfo
->display
,
2505 SDATA (message_type
),
2513 x_send_client_event (Lisp_Object display
, Lisp_Object dest
, Lisp_Object from
, Atom message_type
, Lisp_Object format
, Lisp_Object values
)
2515 struct x_display_info
*dpyinfo
= check_x_display_info (display
);
2518 struct frame
*f
= check_x_frame (from
);
2521 CHECK_NUMBER (format
);
2522 CHECK_CONS (values
);
2524 if (x_check_property_data (values
) == -1)
2525 error ("Bad data in VALUES, must be number, cons or string");
2527 event
.xclient
.type
= ClientMessage
;
2528 event
.xclient
.format
= XFASTINT (format
);
2530 if (event
.xclient
.format
!= 8 && event
.xclient
.format
!= 16
2531 && event
.xclient
.format
!= 32)
2532 error ("FORMAT must be one of 8, 16 or 32");
2534 if (FRAMEP (dest
) || NILP (dest
))
2536 struct frame
*fdest
= check_x_frame (dest
);
2537 wdest
= FRAME_OUTER_WINDOW (fdest
);
2539 else if (STRINGP (dest
))
2541 if (strcmp (SDATA (dest
), "PointerWindow") == 0)
2542 wdest
= PointerWindow
;
2543 else if (strcmp (SDATA (dest
), "InputFocus") == 0)
2546 error ("DEST as a string must be one of PointerWindow or InputFocus");
2548 else if (INTEGERP (dest
))
2549 wdest
= (Window
) XFASTINT (dest
);
2550 else if (FLOATP (dest
))
2551 wdest
= (Window
) XFLOAT_DATA (dest
);
2552 else if (CONSP (dest
))
2554 if (! NUMBERP (XCAR (dest
)) || ! NUMBERP (XCDR (dest
)))
2555 error ("Both car and cdr for DEST must be numbers");
2557 wdest
= (Window
) cons_to_long (dest
);
2560 error ("DEST must be a frame, nil, string, number or cons");
2562 if (wdest
== 0) wdest
= dpyinfo
->root_window
;
2563 to_root
= wdest
== dpyinfo
->root_window
;
2567 event
.xclient
.message_type
= message_type
;
2568 event
.xclient
.display
= dpyinfo
->display
;
2570 /* Some clients (metacity for example) expects sending window to be here
2571 when sending to the root window. */
2572 event
.xclient
.window
= to_root
? FRAME_OUTER_WINDOW (f
) : wdest
;
2575 memset (event
.xclient
.data
.b
, 0, sizeof (event
.xclient
.data
.b
));
2576 x_fill_property_data (dpyinfo
->display
, values
, event
.xclient
.data
.b
,
2577 event
.xclient
.format
);
2579 /* If event mask is 0 the event is sent to the client that created
2580 the destination window. But if we are sending to the root window,
2581 there is no such client. Then we set the event mask to 0xffff. The
2582 event then goes to clients selecting for events on the root window. */
2583 x_catch_errors (dpyinfo
->display
);
2585 int propagate
= to_root
? False
: True
;
2586 unsigned mask
= to_root
? 0xffff : 0;
2587 XSendEvent (dpyinfo
->display
, wdest
, propagate
, mask
, &event
);
2588 XFlush (dpyinfo
->display
);
2590 x_uncatch_errors ();
2596 syms_of_xselect (void)
2598 defsubr (&Sx_get_selection_internal
);
2599 defsubr (&Sx_own_selection_internal
);
2600 defsubr (&Sx_disown_selection_internal
);
2601 defsubr (&Sx_selection_owner_p
);
2602 defsubr (&Sx_selection_exists_p
);
2604 defsubr (&Sx_get_atom_name
);
2605 defsubr (&Sx_send_client_message
);
2606 defsubr (&Sx_register_dnd_atom
);
2608 reading_selection_reply
= Fcons (Qnil
, Qnil
);
2609 staticpro (&reading_selection_reply
);
2610 reading_selection_window
= 0;
2611 reading_which_selection
= 0;
2613 property_change_wait_list
= 0;
2614 prop_location_identifier
= 0;
2615 property_change_reply
= Fcons (Qnil
, Qnil
);
2616 staticpro (&property_change_reply
);
2618 Vselection_alist
= Qnil
;
2619 staticpro (&Vselection_alist
);
2621 DEFVAR_LISP ("selection-converter-alist", Vselection_converter_alist
,
2622 doc
: /* An alist associating X Windows selection-types with functions.
2623 These functions are called to convert the selection, with three args:
2624 the name of the selection (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');
2625 a desired type to which the selection should be converted;
2626 and the local selection value (whatever was given to `x-own-selection').
2628 The function should return the value to send to the X server
2629 \(typically a string). A return value of nil
2630 means that the conversion could not be done.
2631 A return value which is the symbol `NULL'
2632 means that a side-effect was executed,
2633 and there is no meaningful selection value. */);
2634 Vselection_converter_alist
= Qnil
;
2636 DEFVAR_LISP ("x-lost-selection-functions", Vx_lost_selection_functions
,
2637 doc
: /* A list of functions to be called when Emacs loses an X selection.
2638 \(This happens when some other X client makes its own selection
2639 or when a Lisp program explicitly clears the selection.)
2640 The functions are called with one argument, the selection type
2641 \(a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'). */);
2642 Vx_lost_selection_functions
= Qnil
;
2644 DEFVAR_LISP ("x-sent-selection-functions", Vx_sent_selection_functions
,
2645 doc
: /* A list of functions to be called when Emacs answers a selection request.
2646 The functions are called with four arguments:
2647 - the selection name (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');
2648 - the selection-type which Emacs was asked to convert the
2649 selection into before sending (for example, `STRING' or `LENGTH');
2650 - a flag indicating success or failure for responding to the request.
2651 We might have failed (and declined the request) for any number of reasons,
2652 including being asked for a selection that we no longer own, or being asked
2653 to convert into a type that we don't know about or that is inappropriate.
2654 This hook doesn't let you change the behavior of Emacs's selection replies,
2655 it merely informs you that they have happened. */);
2656 Vx_sent_selection_functions
= Qnil
;
2658 DEFVAR_INT ("x-selection-timeout", x_selection_timeout
,
2659 doc
: /* Number of milliseconds to wait for a selection reply.
2660 If the selection owner doesn't reply in this time, we give up.
2661 A value of 0 means wait as long as necessary. This is initialized from the
2662 \"*selectionTimeout\" resource. */);
2663 x_selection_timeout
= 0;
2665 /* QPRIMARY is defined in keyboard.c. */
2666 QSECONDARY
= intern_c_string ("SECONDARY"); staticpro (&QSECONDARY
);
2667 QSTRING
= intern_c_string ("STRING"); staticpro (&QSTRING
);
2668 QINTEGER
= intern_c_string ("INTEGER"); staticpro (&QINTEGER
);
2669 QCLIPBOARD
= intern_c_string ("CLIPBOARD"); staticpro (&QCLIPBOARD
);
2670 QTIMESTAMP
= intern_c_string ("TIMESTAMP"); staticpro (&QTIMESTAMP
);
2671 QTEXT
= intern_c_string ("TEXT"); staticpro (&QTEXT
);
2672 QCOMPOUND_TEXT
= intern_c_string ("COMPOUND_TEXT"); staticpro (&QCOMPOUND_TEXT
);
2673 QUTF8_STRING
= intern_c_string ("UTF8_STRING"); staticpro (&QUTF8_STRING
);
2674 QDELETE
= intern_c_string ("DELETE"); staticpro (&QDELETE
);
2675 QMULTIPLE
= intern_c_string ("MULTIPLE"); staticpro (&QMULTIPLE
);
2676 QINCR
= intern_c_string ("INCR"); staticpro (&QINCR
);
2677 QEMACS_TMP
= intern_c_string ("_EMACS_TMP_"); staticpro (&QEMACS_TMP
);
2678 QTARGETS
= intern_c_string ("TARGETS"); staticpro (&QTARGETS
);
2679 QATOM
= intern_c_string ("ATOM"); staticpro (&QATOM
);
2680 QATOM_PAIR
= intern_c_string ("ATOM_PAIR"); staticpro (&QATOM_PAIR
);
2681 QNULL
= intern_c_string ("NULL"); staticpro (&QNULL
);
2682 Qcompound_text_with_extensions
= intern_c_string ("compound-text-with-extensions");
2683 staticpro (&Qcompound_text_with_extensions
);
2685 Qforeign_selection
= intern_c_string ("foreign-selection");
2686 staticpro (&Qforeign_selection
);