1 /* X Selection processing for Emacs.
2 Copyright (C) 1993, 1994, 1995, 1996, 1997, 2000, 2001, 2002, 2003,
3 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
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.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 /* Rewritten by jwz */
24 #include <stdio.h> /* termhooks.h needs this */
27 #ifdef HAVE_SYS_TYPES_H
28 #include <sys/types.h>
35 #include "xterm.h" /* for all of the X includes */
36 #include "dispextern.h" /* frame.h seems to want this */
37 #include "frame.h" /* Need this to get the X window of selected_frame */
38 #include "blockinput.h"
41 #include "termhooks.h"
44 #include <X11/Xproto.h>
48 static Lisp_Object
x_atom_to_symbol (Display
*dpy
, Atom atom
);
49 static Atom
symbol_to_x_atom (struct x_display_info
*, Display
*,
51 static void x_own_selection (Lisp_Object
, Lisp_Object
);
52 static Lisp_Object
x_get_local_selection (Lisp_Object
, Lisp_Object
, int);
53 static void x_decline_selection_request (struct input_event
*);
54 static Lisp_Object
x_selection_request_lisp_error (Lisp_Object
);
55 static Lisp_Object
queue_selection_requests_unwind (Lisp_Object
);
56 static Lisp_Object
some_frame_on_display (struct x_display_info
*);
57 static Lisp_Object
x_catch_errors_unwind (Lisp_Object
);
58 static void x_reply_selection_request (struct input_event
*, int,
59 unsigned char *, int, Atom
);
60 static int waiting_for_other_props_on_window (Display
*, Window
);
61 static struct prop_location
*expect_property_change (Display
*, Window
,
63 static void unexpect_property_change (struct prop_location
*);
64 static Lisp_Object
wait_for_property_change_unwind (Lisp_Object
);
65 static void wait_for_property_change (struct prop_location
*);
66 static Lisp_Object
x_get_foreign_selection (Lisp_Object
,
69 static void x_get_window_property (Display
*, Window
, Atom
,
70 unsigned char **, int *,
71 Atom
*, int *, unsigned long *, int);
72 static void receive_incremental_selection (Display
*, Window
, Atom
,
73 Lisp_Object
, unsigned,
74 unsigned char **, int *,
75 Atom
*, int *, unsigned long *);
76 static Lisp_Object
x_get_window_property_as_lisp_data (Display
*,
79 static Lisp_Object
selection_data_to_lisp_data (Display
*,
80 const unsigned char *,
82 static void lisp_data_to_selection_data (Display
*, Lisp_Object
,
83 unsigned char **, Atom
*,
84 unsigned *, int *, int *);
85 static Lisp_Object
clean_local_selection_data (Lisp_Object
);
87 /* Printing traces to stderr. */
89 #ifdef TRACE_SELECTION
91 fprintf (stderr, "%d: " fmt "\n", getpid ())
92 #define TRACE1(fmt, a0) \
93 fprintf (stderr, "%d: " fmt "\n", getpid (), a0)
94 #define TRACE2(fmt, a0, a1) \
95 fprintf (stderr, "%d: " fmt "\n", getpid (), a0, a1)
96 #define TRACE3(fmt, a0, a1, a2) \
97 fprintf (stderr, "%d: " fmt "\n", getpid (), a0, a1, a2)
99 #define TRACE0(fmt) (void) 0
100 #define TRACE1(fmt, a0) (void) 0
101 #define TRACE2(fmt, a0, a1) (void) 0
102 #define TRACE3(fmt, a0, a1) (void) 0
106 Lisp_Object QSECONDARY
, QSTRING
, QINTEGER
, QCLIPBOARD
, QTIMESTAMP
,
107 QTEXT
, QDELETE
, QMULTIPLE
, QINCR
, QEMACS_TMP
, QTARGETS
, QATOM
, QNULL
,
110 Lisp_Object QCOMPOUND_TEXT
; /* This is a type of selection. */
111 Lisp_Object QUTF8_STRING
; /* This is a type of selection. */
113 Lisp_Object Qcompound_text_with_extensions
;
115 static Lisp_Object Vx_lost_selection_functions
;
116 static Lisp_Object Vx_sent_selection_functions
;
117 static Lisp_Object Qforeign_selection
;
119 /* If this is a smaller number than the max-request-size of the display,
120 emacs will use INCR selection transfer when the selection is larger
121 than this. The max-request-size is usually around 64k, so if you want
122 emacs to use incremental selection transfers when the selection is
123 smaller than that, set this. I added this mostly for debugging the
124 incremental transfer stuff, but it might improve server performance. */
125 #define MAX_SELECTION_QUANTUM 0xFFFFFF
127 #define SELECTION_QUANTUM(dpy) ((XMaxRequestSize(dpy) << 2) - 100)
129 /* The timestamp of the last input event Emacs received from the X server. */
130 /* Defined in keyboard.c. */
131 extern unsigned long last_event_timestamp
;
133 /* This is an association list whose elements are of the form
134 ( SELECTION-NAME SELECTION-VALUE SELECTION-TIMESTAMP FRAME)
135 SELECTION-NAME is a lisp symbol, whose name is the name of an X Atom.
136 SELECTION-VALUE is the value that emacs owns for that selection.
137 It may be any kind of Lisp object.
138 SELECTION-TIMESTAMP is the time at which emacs began owning this selection,
139 as a cons of two 16-bit numbers (making a 32 bit time.)
140 FRAME is the frame for which we made the selection.
141 If there is an entry in this alist, then it can be assumed that Emacs owns
143 The only (eq) parts of this list that are visible from Lisp are the
145 static Lisp_Object Vselection_alist
;
147 /* This is an alist whose CARs are selection-types (whose names are the same
148 as the names of X Atoms) and whose CDRs are the names of Lisp functions to
149 call to convert the given Emacs selection value to a string representing
150 the given selection type. This is for Lisp-level extension of the emacs
151 selection handling. */
152 static Lisp_Object Vselection_converter_alist
;
154 /* If the selection owner takes too long to reply to a selection request,
155 we give up on it. This is in milliseconds (0 = no timeout.) */
156 static EMACS_INT x_selection_timeout
;
160 /* Define a queue to save up SELECTION_REQUEST_EVENT events for later
163 struct selection_event_queue
165 struct input_event event
;
166 struct selection_event_queue
*next
;
169 static struct selection_event_queue
*selection_queue
;
171 /* Nonzero means queue up SELECTION_REQUEST_EVENT events. */
173 static int x_queue_selection_requests
;
175 /* Queue up an SELECTION_REQUEST_EVENT *EVENT, to be processed later. */
178 x_queue_event (struct input_event
*event
)
180 struct selection_event_queue
*queue_tmp
;
182 /* Don't queue repeated requests.
183 This only happens for large requests which uses the incremental protocol. */
184 for (queue_tmp
= selection_queue
; queue_tmp
; queue_tmp
= queue_tmp
->next
)
186 if (!memcmp (&queue_tmp
->event
, event
, sizeof (*event
)))
188 TRACE1 ("DECLINE DUP SELECTION EVENT %08lx", (unsigned long)queue_tmp
);
189 x_decline_selection_request (event
);
195 = (struct selection_event_queue
*) xmalloc (sizeof (struct selection_event_queue
));
197 if (queue_tmp
!= NULL
)
199 TRACE1 ("QUEUE SELECTION EVENT %08lx", (unsigned long)queue_tmp
);
200 queue_tmp
->event
= *event
;
201 queue_tmp
->next
= selection_queue
;
202 selection_queue
= queue_tmp
;
206 /* Start queuing SELECTION_REQUEST_EVENT events. */
209 x_start_queuing_selection_requests (void)
211 if (x_queue_selection_requests
)
214 x_queue_selection_requests
++;
215 TRACE1 ("x_start_queuing_selection_requests %d", x_queue_selection_requests
);
218 /* Stop queuing SELECTION_REQUEST_EVENT events. */
221 x_stop_queuing_selection_requests (void)
223 TRACE1 ("x_stop_queuing_selection_requests %d", x_queue_selection_requests
);
224 --x_queue_selection_requests
;
226 /* Take all the queued events and put them back
227 so that they get processed afresh. */
229 while (selection_queue
!= NULL
)
231 struct selection_event_queue
*queue_tmp
= selection_queue
;
232 TRACE1 ("RESTORE SELECTION EVENT %08lx", (unsigned long)queue_tmp
);
233 kbd_buffer_unget_event (&queue_tmp
->event
);
234 selection_queue
= queue_tmp
->next
;
235 xfree ((char *)queue_tmp
);
240 /* This converts a Lisp symbol to a server Atom, avoiding a server
241 roundtrip whenever possible. */
244 symbol_to_x_atom (struct x_display_info
*dpyinfo
, Display
*display
, Lisp_Object sym
)
247 if (NILP (sym
)) return 0;
248 if (EQ (sym
, QPRIMARY
)) return XA_PRIMARY
;
249 if (EQ (sym
, QSECONDARY
)) return XA_SECONDARY
;
250 if (EQ (sym
, QSTRING
)) return XA_STRING
;
251 if (EQ (sym
, QINTEGER
)) return XA_INTEGER
;
252 if (EQ (sym
, QATOM
)) return XA_ATOM
;
253 if (EQ (sym
, QCLIPBOARD
)) return dpyinfo
->Xatom_CLIPBOARD
;
254 if (EQ (sym
, QTIMESTAMP
)) return dpyinfo
->Xatom_TIMESTAMP
;
255 if (EQ (sym
, QTEXT
)) return dpyinfo
->Xatom_TEXT
;
256 if (EQ (sym
, QCOMPOUND_TEXT
)) return dpyinfo
->Xatom_COMPOUND_TEXT
;
257 if (EQ (sym
, QUTF8_STRING
)) return dpyinfo
->Xatom_UTF8_STRING
;
258 if (EQ (sym
, QDELETE
)) return dpyinfo
->Xatom_DELETE
;
259 if (EQ (sym
, QMULTIPLE
)) return dpyinfo
->Xatom_MULTIPLE
;
260 if (EQ (sym
, QINCR
)) return dpyinfo
->Xatom_INCR
;
261 if (EQ (sym
, QEMACS_TMP
)) return dpyinfo
->Xatom_EMACS_TMP
;
262 if (EQ (sym
, QTARGETS
)) return dpyinfo
->Xatom_TARGETS
;
263 if (EQ (sym
, QNULL
)) return dpyinfo
->Xatom_NULL
;
264 if (!SYMBOLP (sym
)) abort ();
266 TRACE1 (" XInternAtom %s", (char *) SDATA (SYMBOL_NAME (sym
)));
268 val
= XInternAtom (display
, (char *) SDATA (SYMBOL_NAME (sym
)), False
);
274 /* This converts a server Atom to a Lisp symbol, avoiding server roundtrips
275 and calls to intern whenever possible. */
278 x_atom_to_symbol (Display
*dpy
, Atom atom
)
280 struct x_display_info
*dpyinfo
;
301 dpyinfo
= x_display_info_for_display (dpy
);
302 if (atom
== dpyinfo
->Xatom_CLIPBOARD
)
304 if (atom
== dpyinfo
->Xatom_TIMESTAMP
)
306 if (atom
== dpyinfo
->Xatom_TEXT
)
308 if (atom
== dpyinfo
->Xatom_COMPOUND_TEXT
)
309 return QCOMPOUND_TEXT
;
310 if (atom
== dpyinfo
->Xatom_UTF8_STRING
)
312 if (atom
== dpyinfo
->Xatom_DELETE
)
314 if (atom
== dpyinfo
->Xatom_MULTIPLE
)
316 if (atom
== dpyinfo
->Xatom_INCR
)
318 if (atom
== dpyinfo
->Xatom_EMACS_TMP
)
320 if (atom
== dpyinfo
->Xatom_TARGETS
)
322 if (atom
== dpyinfo
->Xatom_NULL
)
326 str
= XGetAtomName (dpy
, atom
);
328 TRACE1 ("XGetAtomName --> %s", str
);
329 if (! str
) return Qnil
;
332 /* This was allocated by Xlib, so use XFree. */
338 /* Do protocol to assert ourself as a selection owner.
339 Update the Vselection_alist so that we can reply to later requests for
343 x_own_selection (Lisp_Object selection_name
, Lisp_Object selection_value
)
345 struct frame
*sf
= SELECTED_FRAME ();
346 Window selecting_window
;
348 Time time
= last_event_timestamp
;
350 struct x_display_info
*dpyinfo
;
352 if (! FRAME_X_P (sf
))
355 selecting_window
= FRAME_X_WINDOW (sf
);
356 display
= FRAME_X_DISPLAY (sf
);
357 dpyinfo
= FRAME_X_DISPLAY_INFO (sf
);
359 CHECK_SYMBOL (selection_name
);
360 selection_atom
= symbol_to_x_atom (dpyinfo
, display
, selection_name
);
363 x_catch_errors (display
);
364 XSetSelectionOwner (display
, selection_atom
, selecting_window
, time
);
365 x_check_errors (display
, "Can't set selection: %s");
369 /* Now update the local cache */
371 Lisp_Object selection_time
;
372 Lisp_Object selection_data
;
373 Lisp_Object prev_value
;
375 selection_time
= long_to_cons ((unsigned long) time
);
376 selection_data
= list4 (selection_name
, selection_value
,
377 selection_time
, selected_frame
);
378 prev_value
= assq_no_quit (selection_name
, Vselection_alist
);
380 Vselection_alist
= Fcons (selection_data
, Vselection_alist
);
382 /* If we already owned the selection, remove the old selection data.
383 Perhaps we should destructively modify it instead.
384 Don't use Fdelq as that may QUIT. */
385 if (!NILP (prev_value
))
387 Lisp_Object rest
; /* we know it's not the CAR, so it's easy. */
388 for (rest
= Vselection_alist
; CONSP (rest
); rest
= XCDR (rest
))
389 if (EQ (prev_value
, Fcar (XCDR (rest
))))
391 XSETCDR (rest
, Fcdr (XCDR (rest
)));
398 /* Given a selection-name and desired type, look up our local copy of
399 the selection value and convert it to the type.
400 The value is nil or a string.
401 This function is used both for remote requests (LOCAL_REQUEST is zero)
402 and for local x-get-selection-internal (LOCAL_REQUEST is nonzero).
404 This calls random Lisp code, and may signal or gc. */
407 x_get_local_selection (Lisp_Object selection_symbol
, Lisp_Object target_type
, int local_request
)
409 Lisp_Object local_value
;
410 Lisp_Object handler_fn
, value
, type
, check
;
413 local_value
= assq_no_quit (selection_symbol
, Vselection_alist
);
415 if (NILP (local_value
)) return Qnil
;
417 /* TIMESTAMP and MULTIPLE are special cases 'cause that's easiest. */
418 if (EQ (target_type
, QTIMESTAMP
))
421 value
= XCAR (XCDR (XCDR (local_value
)));
424 else if (EQ (target_type
, QDELETE
))
427 Fx_disown_selection_internal
429 XCAR (XCDR (XCDR (local_value
))));
434 #if 0 /* #### MULTIPLE doesn't work yet */
435 else if (CONSP (target_type
)
436 && XCAR (target_type
) == QMULTIPLE
)
441 pairs
= XCDR (target_type
);
442 size
= XVECTOR (pairs
)->size
;
443 /* If the target is MULTIPLE, then target_type looks like
444 (MULTIPLE . [[SELECTION1 TARGET1] [SELECTION2 TARGET2] ... ])
445 We modify the second element of each pair in the vector and
446 return it as [[SELECTION1 <value1>] [SELECTION2 <value2>] ... ]
448 for (i
= 0; i
< size
; i
++)
451 pair
= XVECTOR (pairs
)->contents
[i
];
452 XVECTOR (pair
)->contents
[1]
453 = x_get_local_selection (XVECTOR (pair
)->contents
[0],
454 XVECTOR (pair
)->contents
[1],
462 /* Don't allow a quit within the converter.
463 When the user types C-g, he would be surprised
464 if by luck it came during a converter. */
465 count
= SPECPDL_INDEX ();
466 specbind (Qinhibit_quit
, Qt
);
468 CHECK_SYMBOL (target_type
);
469 handler_fn
= Fcdr (Fassq (target_type
, Vselection_converter_alist
));
470 /* gcpro is not needed here since nothing but HANDLER_FN
471 is live, and that ought to be a symbol. */
473 if (!NILP (handler_fn
))
474 value
= call3 (handler_fn
,
475 selection_symbol
, (local_request
? Qnil
: target_type
),
476 XCAR (XCDR (local_value
)));
479 unbind_to (count
, Qnil
);
482 /* Make sure this value is of a type that we could transmit
483 to another X client. */
487 && SYMBOLP (XCAR (value
)))
489 check
= XCDR (value
);
497 /* Check for a value that cons_to_long could handle. */
498 else if (CONSP (check
)
499 && INTEGERP (XCAR (check
))
500 && (INTEGERP (XCDR (check
))
502 (CONSP (XCDR (check
))
503 && INTEGERP (XCAR (XCDR (check
)))
504 && NILP (XCDR (XCDR (check
))))))
507 signal_error ("Invalid data returned by selection-conversion function",
508 list2 (handler_fn
, value
));
511 /* Subroutines of x_reply_selection_request. */
513 /* Send a SelectionNotify event to the requestor with property=None,
514 meaning we were unable to do what they wanted. */
517 x_decline_selection_request (struct input_event
*event
)
519 XSelectionEvent reply
;
521 reply
.type
= SelectionNotify
;
522 reply
.display
= SELECTION_EVENT_DISPLAY (event
);
523 reply
.requestor
= SELECTION_EVENT_REQUESTOR (event
);
524 reply
.selection
= SELECTION_EVENT_SELECTION (event
);
525 reply
.time
= SELECTION_EVENT_TIME (event
);
526 reply
.target
= SELECTION_EVENT_TARGET (event
);
527 reply
.property
= None
;
529 /* The reason for the error may be that the receiver has
530 died in the meantime. Handle that case. */
532 x_catch_errors (reply
.display
);
533 XSendEvent (reply
.display
, reply
.requestor
, False
, 0L, (XEvent
*) &reply
);
534 XFlush (reply
.display
);
539 /* This is the selection request currently being processed.
540 It is set to zero when the request is fully processed. */
541 static struct input_event
*x_selection_current_request
;
543 /* Display info in x_selection_request. */
545 static struct x_display_info
*selection_request_dpyinfo
;
547 /* Used as an unwind-protect clause so that, if a selection-converter signals
548 an error, we tell the requester that we were unable to do what they wanted
549 before we throw to top-level or go into the debugger or whatever. */
552 x_selection_request_lisp_error (Lisp_Object ignore
)
554 if (x_selection_current_request
!= 0
555 && selection_request_dpyinfo
->display
)
556 x_decline_selection_request (x_selection_current_request
);
561 x_catch_errors_unwind (Lisp_Object dummy
)
570 /* This stuff is so that INCR selections are reentrant (that is, so we can
571 be servicing multiple INCR selection requests simultaneously.) I haven't
572 actually tested that yet. */
574 /* Keep a list of the property changes that are awaited. */
584 struct prop_location
*next
;
587 static struct prop_location
*expect_property_change (Display
*display
, Window window
, Atom property
, int state
);
588 static void wait_for_property_change (struct prop_location
*location
);
589 static void unexpect_property_change (struct prop_location
*location
);
590 static int waiting_for_other_props_on_window (Display
*display
, Window window
);
592 static int prop_location_identifier
;
594 static Lisp_Object property_change_reply
;
596 static struct prop_location
*property_change_reply_object
;
598 static struct prop_location
*property_change_wait_list
;
601 queue_selection_requests_unwind (Lisp_Object tem
)
603 x_stop_queuing_selection_requests ();
607 /* Return some frame whose display info is DPYINFO.
608 Return nil if there is none. */
611 some_frame_on_display (struct x_display_info
*dpyinfo
)
613 Lisp_Object list
, frame
;
615 FOR_EACH_FRAME (list
, frame
)
617 if (FRAME_X_P (XFRAME (frame
))
618 && FRAME_X_DISPLAY_INFO (XFRAME (frame
)) == dpyinfo
)
625 /* Send the reply to a selection request event EVENT.
626 TYPE is the type of selection data requested.
627 DATA and SIZE describe the data to send, already converted.
628 FORMAT is the unit-size (in bits) of the data to be transmitted. */
630 #ifdef TRACE_SELECTION
631 static int x_reply_selection_request_cnt
;
632 #endif /* TRACE_SELECTION */
635 x_reply_selection_request (struct input_event
*event
, int format
, unsigned char *data
, int size
, Atom type
)
637 XSelectionEvent reply
;
638 Display
*display
= SELECTION_EVENT_DISPLAY (event
);
639 Window window
= SELECTION_EVENT_REQUESTOR (event
);
641 int format_bytes
= format
/8;
642 int max_bytes
= SELECTION_QUANTUM (display
);
643 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
644 int count
= SPECPDL_INDEX ();
646 if (max_bytes
> MAX_SELECTION_QUANTUM
)
647 max_bytes
= MAX_SELECTION_QUANTUM
;
649 reply
.type
= SelectionNotify
;
650 reply
.display
= display
;
651 reply
.requestor
= window
;
652 reply
.selection
= SELECTION_EVENT_SELECTION (event
);
653 reply
.time
= SELECTION_EVENT_TIME (event
);
654 reply
.target
= SELECTION_EVENT_TARGET (event
);
655 reply
.property
= SELECTION_EVENT_PROPERTY (event
);
656 if (reply
.property
== None
)
657 reply
.property
= reply
.target
;
660 /* The protected block contains wait_for_property_change, which can
661 run random lisp code (process handlers) or signal. Therefore, we
662 put the x_uncatch_errors call in an unwind. */
663 record_unwind_protect (x_catch_errors_unwind
, Qnil
);
664 x_catch_errors (display
);
666 #ifdef TRACE_SELECTION
668 char *sel
= XGetAtomName (display
, reply
.selection
);
669 char *tgt
= XGetAtomName (display
, reply
.target
);
670 TRACE3 ("%s, target %s (%d)", sel
, tgt
, ++x_reply_selection_request_cnt
);
671 if (sel
) XFree (sel
);
672 if (tgt
) XFree (tgt
);
674 #endif /* TRACE_SELECTION */
676 /* Store the data on the requested property.
677 If the selection is large, only store the first N bytes of it.
679 bytes_remaining
= size
* format_bytes
;
680 if (bytes_remaining
<= max_bytes
)
682 /* Send all the data at once, with minimal handshaking. */
683 TRACE1 ("Sending all %d bytes", bytes_remaining
);
684 XChangeProperty (display
, window
, reply
.property
, type
, format
,
685 PropModeReplace
, data
, size
);
686 /* At this point, the selection was successfully stored; ack it. */
687 XSendEvent (display
, window
, False
, 0L, (XEvent
*) &reply
);
691 /* Send an INCR selection. */
692 struct prop_location
*wait_object
;
696 frame
= some_frame_on_display (dpyinfo
);
698 /* If the display no longer has frames, we can't expect
699 to get many more selection requests from it, so don't
700 bother trying to queue them. */
703 x_start_queuing_selection_requests ();
705 record_unwind_protect (queue_selection_requests_unwind
,
709 if (x_window_to_frame (dpyinfo
, window
)) /* #### debug */
710 error ("Attempt to transfer an INCR to ourself!");
712 TRACE2 ("Start sending %d bytes incrementally (%s)",
713 bytes_remaining
, XGetAtomName (display
, reply
.property
));
714 wait_object
= expect_property_change (display
, window
, reply
.property
,
717 TRACE1 ("Set %s to number of bytes to send",
718 XGetAtomName (display
, reply
.property
));
720 /* XChangeProperty expects an array of long even if long is more than
724 value
[0] = bytes_remaining
;
725 XChangeProperty (display
, window
, reply
.property
, dpyinfo
->Xatom_INCR
,
727 (unsigned char *) value
, 1);
730 XSelectInput (display
, window
, PropertyChangeMask
);
732 /* Tell 'em the INCR data is there... */
733 TRACE0 ("Send SelectionNotify event");
734 XSendEvent (display
, window
, False
, 0L, (XEvent
*) &reply
);
737 had_errors
= x_had_errors_p (display
);
740 /* First, wait for the requester to ack by deleting the property.
741 This can run random lisp code (process handlers) or signal. */
744 TRACE1 ("Waiting for ACK (deletion of %s)",
745 XGetAtomName (display
, reply
.property
));
746 wait_for_property_change (wait_object
);
749 unexpect_property_change (wait_object
);
752 while (bytes_remaining
)
754 int i
= ((bytes_remaining
< max_bytes
)
756 : max_bytes
) / format_bytes
;
761 = expect_property_change (display
, window
, reply
.property
,
764 TRACE1 ("Sending increment of %d elements", i
);
765 TRACE1 ("Set %s to increment data",
766 XGetAtomName (display
, reply
.property
));
768 /* Append the next chunk of data to the property. */
769 XChangeProperty (display
, window
, reply
.property
, type
, format
,
770 PropModeAppend
, data
, i
);
771 bytes_remaining
-= i
* format_bytes
;
773 data
+= i
* sizeof (long);
775 data
+= i
* format_bytes
;
777 had_errors
= x_had_errors_p (display
);
783 /* Now wait for the requester to ack this chunk by deleting the
784 property. This can run random lisp code or signal. */
785 TRACE1 ("Waiting for increment ACK (deletion of %s)",
786 XGetAtomName (display
, reply
.property
));
787 wait_for_property_change (wait_object
);
790 /* Now write a zero-length chunk to the property to tell the
791 requester that we're done. */
793 if (! waiting_for_other_props_on_window (display
, window
))
794 XSelectInput (display
, window
, 0L);
796 TRACE1 ("Set %s to a 0-length chunk to indicate EOF",
797 XGetAtomName (display
, reply
.property
));
798 XChangeProperty (display
, window
, reply
.property
, type
, format
,
799 PropModeReplace
, data
, 0);
800 TRACE0 ("Done sending incrementally");
803 /* rms, 2003-01-03: I think I have fixed this bug. */
804 /* The window we're communicating with may have been deleted
805 in the meantime (that's a real situation from a bug report).
806 In this case, there may be events in the event queue still
807 refering to the deleted window, and we'll get a BadWindow error
808 in XTread_socket when processing the events. I don't have
809 an idea how to fix that. gerd, 2001-01-98. */
810 /* 2004-09-10: XSync and UNBLOCK so that possible protocol errors are
811 delivered before uncatch errors. */
812 XSync (display
, False
);
815 /* GTK queues events in addition to the queue in Xlib. So we
816 UNBLOCK to enter the event loop and get possible errors delivered,
817 and then BLOCK again because x_uncatch_errors requires it. */
819 /* This calls x_uncatch_errors. */
820 unbind_to (count
, Qnil
);
824 /* Handle a SelectionRequest event EVENT.
825 This is called from keyboard.c when such an event is found in the queue. */
828 x_handle_selection_request (struct input_event
*event
)
830 struct gcpro gcpro1
, gcpro2
, gcpro3
;
831 Lisp_Object local_selection_data
;
832 Lisp_Object selection_symbol
;
833 Lisp_Object target_symbol
;
834 Lisp_Object converted_selection
;
835 Time local_selection_time
;
836 Lisp_Object successful_p
;
838 struct x_display_info
*dpyinfo
839 = x_display_info_for_display (SELECTION_EVENT_DISPLAY (event
));
841 TRACE2 ("x_handle_selection_request, from=0x%08lx time=%lu",
842 (unsigned long) SELECTION_EVENT_REQUESTOR (event
),
843 (unsigned long) SELECTION_EVENT_TIME (event
));
845 local_selection_data
= Qnil
;
846 target_symbol
= Qnil
;
847 converted_selection
= Qnil
;
850 GCPRO3 (local_selection_data
, converted_selection
, target_symbol
);
852 selection_symbol
= x_atom_to_symbol (SELECTION_EVENT_DISPLAY (event
),
853 SELECTION_EVENT_SELECTION (event
));
855 local_selection_data
= assq_no_quit (selection_symbol
, Vselection_alist
);
857 if (NILP (local_selection_data
))
859 /* Someone asked for the selection, but we don't have it any more.
861 x_decline_selection_request (event
);
865 local_selection_time
= (Time
)
866 cons_to_long (XCAR (XCDR (XCDR (local_selection_data
))));
868 if (SELECTION_EVENT_TIME (event
) != CurrentTime
869 && local_selection_time
> SELECTION_EVENT_TIME (event
))
871 /* Someone asked for the selection, and we have one, but not the one
874 x_decline_selection_request (event
);
878 x_selection_current_request
= event
;
879 count
= SPECPDL_INDEX ();
880 selection_request_dpyinfo
= dpyinfo
;
881 record_unwind_protect (x_selection_request_lisp_error
, Qnil
);
883 target_symbol
= x_atom_to_symbol (SELECTION_EVENT_DISPLAY (event
),
884 SELECTION_EVENT_TARGET (event
));
886 #if 0 /* #### MULTIPLE doesn't work yet */
887 if (EQ (target_symbol
, QMULTIPLE
))
888 target_symbol
= fetch_multiple_target (event
);
891 /* Convert lisp objects back into binary data */
894 = x_get_local_selection (selection_symbol
, target_symbol
, 0);
896 if (! NILP (converted_selection
))
904 if (CONSP (converted_selection
) && NILP (XCDR (converted_selection
)))
906 x_decline_selection_request (event
);
910 lisp_data_to_selection_data (SELECTION_EVENT_DISPLAY (event
),
912 &data
, &type
, &size
, &format
, &nofree
);
914 x_reply_selection_request (event
, format
, data
, size
, type
);
917 /* Indicate we have successfully processed this event. */
918 x_selection_current_request
= 0;
920 /* Use xfree, not XFree, because lisp_data_to_selection_data
921 calls xmalloc itself. */
927 unbind_to (count
, Qnil
);
931 /* Let random lisp code notice that the selection has been asked for. */
934 rest
= Vx_sent_selection_functions
;
935 if (!EQ (rest
, Qunbound
))
936 for (; CONSP (rest
); rest
= Fcdr (rest
))
937 call3 (Fcar (rest
), selection_symbol
, target_symbol
, successful_p
);
943 /* Handle a SelectionClear event EVENT, which indicates that some
944 client cleared out our previously asserted selection.
945 This is called from keyboard.c when such an event is found in the queue. */
948 x_handle_selection_clear (struct input_event
*event
)
950 Display
*display
= SELECTION_EVENT_DISPLAY (event
);
951 Atom selection
= SELECTION_EVENT_SELECTION (event
);
952 Time changed_owner_time
= SELECTION_EVENT_TIME (event
);
954 Lisp_Object selection_symbol
, local_selection_data
;
955 Time local_selection_time
;
956 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
957 struct x_display_info
*t_dpyinfo
;
959 TRACE0 ("x_handle_selection_clear");
961 /* If the new selection owner is also Emacs,
962 don't clear the new selection. */
964 /* Check each display on the same terminal,
965 to see if this Emacs job now owns the selection
966 through that display. */
967 for (t_dpyinfo
= x_display_list
; t_dpyinfo
; t_dpyinfo
= t_dpyinfo
->next
)
968 if (t_dpyinfo
->terminal
->kboard
== dpyinfo
->terminal
->kboard
)
971 = XGetSelectionOwner (t_dpyinfo
->display
, selection
);
972 if (x_window_to_frame (t_dpyinfo
, owner_window
) != 0)
980 selection_symbol
= x_atom_to_symbol (display
, selection
);
982 local_selection_data
= assq_no_quit (selection_symbol
, Vselection_alist
);
984 /* Well, we already believe that we don't own it, so that's just fine. */
985 if (NILP (local_selection_data
)) return;
987 local_selection_time
= (Time
)
988 cons_to_long (XCAR (XCDR (XCDR (local_selection_data
))));
990 /* This SelectionClear is for a selection that we no longer own, so we can
991 disregard it. (That is, we have reasserted the selection since this
992 request was generated.) */
994 if (changed_owner_time
!= CurrentTime
995 && local_selection_time
> changed_owner_time
)
998 /* Otherwise, we're really honest and truly being told to drop it.
999 Don't use Fdelq as that may QUIT;. */
1001 if (EQ (local_selection_data
, Fcar (Vselection_alist
)))
1002 Vselection_alist
= Fcdr (Vselection_alist
);
1006 for (rest
= Vselection_alist
; CONSP (rest
); rest
= XCDR (rest
))
1007 if (EQ (local_selection_data
, Fcar (XCDR (rest
))))
1009 XSETCDR (rest
, Fcdr (XCDR (rest
)));
1014 /* Let random lisp code notice that the selection has been stolen. */
1018 rest
= Vx_lost_selection_functions
;
1019 if (!EQ (rest
, Qunbound
))
1021 for (; CONSP (rest
); rest
= Fcdr (rest
))
1022 call1 (Fcar (rest
), selection_symbol
);
1023 prepare_menu_bars ();
1024 redisplay_preserve_echo_area (20);
1030 x_handle_selection_event (struct input_event
*event
)
1032 TRACE0 ("x_handle_selection_event");
1034 if (event
->kind
== SELECTION_REQUEST_EVENT
)
1036 if (x_queue_selection_requests
)
1037 x_queue_event (event
);
1039 x_handle_selection_request (event
);
1042 x_handle_selection_clear (event
);
1046 /* Clear all selections that were made from frame F.
1047 We do this when about to delete a frame. */
1050 x_clear_frame_selections (FRAME_PTR f
)
1055 XSETFRAME (frame
, f
);
1057 /* Otherwise, we're really honest and truly being told to drop it.
1058 Don't use Fdelq as that may QUIT;. */
1060 /* Delete elements from the beginning of Vselection_alist. */
1061 while (!NILP (Vselection_alist
)
1062 && EQ (frame
, Fcar (Fcdr (Fcdr (Fcdr (Fcar (Vselection_alist
)))))))
1064 /* Let random Lisp code notice that the selection has been stolen. */
1065 Lisp_Object hooks
, selection_symbol
;
1067 hooks
= Vx_lost_selection_functions
;
1068 selection_symbol
= Fcar (Fcar (Vselection_alist
));
1070 if (!EQ (hooks
, Qunbound
))
1072 for (; CONSP (hooks
); hooks
= Fcdr (hooks
))
1073 call1 (Fcar (hooks
), selection_symbol
);
1074 #if 0 /* This can crash when deleting a frame
1075 from x_connection_closed. Anyway, it seems unnecessary;
1076 something else should cause a redisplay. */
1077 redisplay_preserve_echo_area (21);
1081 Vselection_alist
= Fcdr (Vselection_alist
);
1084 /* Delete elements after the beginning of Vselection_alist. */
1085 for (rest
= Vselection_alist
; CONSP (rest
); rest
= XCDR (rest
))
1086 if (EQ (frame
, Fcar (Fcdr (Fcdr (Fcdr (Fcar (XCDR (rest
))))))))
1088 /* Let random Lisp code notice that the selection has been stolen. */
1089 Lisp_Object hooks
, selection_symbol
;
1091 hooks
= Vx_lost_selection_functions
;
1092 selection_symbol
= Fcar (Fcar (XCDR (rest
)));
1094 if (!EQ (hooks
, Qunbound
))
1096 for (; CONSP (hooks
); hooks
= Fcdr (hooks
))
1097 call1 (Fcar (hooks
), selection_symbol
);
1098 #if 0 /* See above */
1099 redisplay_preserve_echo_area (22);
1102 XSETCDR (rest
, Fcdr (XCDR (rest
)));
1107 /* Nonzero if any properties for DISPLAY and WINDOW
1108 are on the list of what we are waiting for. */
1111 waiting_for_other_props_on_window (Display
*display
, Window window
)
1113 struct prop_location
*rest
= property_change_wait_list
;
1115 if (rest
->display
== display
&& rest
->window
== window
)
1122 /* Add an entry to the list of property changes we are waiting for.
1123 DISPLAY, WINDOW, PROPERTY, STATE describe what we will wait for.
1124 The return value is a number that uniquely identifies
1125 this awaited property change. */
1127 static struct prop_location
*
1128 expect_property_change (Display
*display
, Window window
, Atom property
, int state
)
1130 struct prop_location
*pl
= (struct prop_location
*) xmalloc (sizeof *pl
);
1131 pl
->identifier
= ++prop_location_identifier
;
1132 pl
->display
= display
;
1133 pl
->window
= window
;
1134 pl
->property
= property
;
1135 pl
->desired_state
= state
;
1136 pl
->next
= property_change_wait_list
;
1138 property_change_wait_list
= pl
;
1142 /* Delete an entry from the list of property changes we are waiting for.
1143 IDENTIFIER is the number that uniquely identifies the entry. */
1146 unexpect_property_change (struct prop_location
*location
)
1148 struct prop_location
*prev
= 0, *rest
= property_change_wait_list
;
1151 if (rest
== location
)
1154 prev
->next
= rest
->next
;
1156 property_change_wait_list
= rest
->next
;
1165 /* Remove the property change expectation element for IDENTIFIER. */
1168 wait_for_property_change_unwind (Lisp_Object loc
)
1170 struct prop_location
*location
= XSAVE_VALUE (loc
)->pointer
;
1172 unexpect_property_change (location
);
1173 if (location
== property_change_reply_object
)
1174 property_change_reply_object
= 0;
1178 /* Actually wait for a property change.
1179 IDENTIFIER should be the value that expect_property_change returned. */
1182 wait_for_property_change (struct prop_location
*location
)
1185 int count
= SPECPDL_INDEX ();
1187 if (property_change_reply_object
)
1190 /* Make sure to do unexpect_property_change if we quit or err. */
1191 record_unwind_protect (wait_for_property_change_unwind
,
1192 make_save_value (location
, 0));
1194 XSETCAR (property_change_reply
, Qnil
);
1195 property_change_reply_object
= location
;
1197 /* If the event we are waiting for arrives beyond here, it will set
1198 property_change_reply, because property_change_reply_object says so. */
1199 if (! location
->arrived
)
1201 secs
= x_selection_timeout
/ 1000;
1202 usecs
= (x_selection_timeout
% 1000) * 1000;
1203 TRACE2 (" Waiting %d secs, %d usecs", secs
, usecs
);
1204 wait_reading_process_output (secs
, usecs
, 0, 0,
1205 property_change_reply
, NULL
, 0);
1207 if (NILP (XCAR (property_change_reply
)))
1209 TRACE0 (" Timed out");
1210 error ("Timed out waiting for property-notify event");
1214 unbind_to (count
, Qnil
);
1217 /* Called from XTread_socket in response to a PropertyNotify event. */
1220 x_handle_property_notify (XPropertyEvent
*event
)
1222 struct prop_location
*prev
= 0, *rest
= property_change_wait_list
;
1227 && rest
->property
== event
->atom
1228 && rest
->window
== event
->window
1229 && rest
->display
== event
->display
1230 && rest
->desired_state
== event
->state
)
1232 TRACE2 ("Expected %s of property %s",
1233 (event
->state
== PropertyDelete
? "deletion" : "change"),
1234 XGetAtomName (event
->display
, event
->atom
));
1238 /* If this is the one wait_for_property_change is waiting for,
1239 tell it to wake up. */
1240 if (rest
== property_change_reply_object
)
1241 XSETCAR (property_change_reply
, Qt
);
1253 #if 0 /* #### MULTIPLE doesn't work yet */
1256 fetch_multiple_target (event
)
1257 XSelectionRequestEvent
*event
;
1259 Display
*display
= event
->display
;
1260 Window window
= event
->requestor
;
1261 Atom target
= event
->target
;
1262 Atom selection_atom
= event
->selection
;
1267 x_get_window_property_as_lisp_data (display
, window
, target
,
1268 QMULTIPLE
, selection_atom
));
1272 copy_multiple_data (obj
)
1279 return Fcons (XCAR (obj
), copy_multiple_data (XCDR (obj
)));
1282 vec
= Fmake_vector (size
= XVECTOR (obj
)->size
, Qnil
);
1283 for (i
= 0; i
< size
; i
++)
1285 Lisp_Object vec2
= XVECTOR (obj
)->contents
[i
];
1286 CHECK_VECTOR (vec2
);
1287 if (XVECTOR (vec2
)->size
!= 2)
1288 /* ??? Confusing error message */
1289 signal_error ("Vectors must be of length 2", vec2
);
1290 XVECTOR (vec
)->contents
[i
] = Fmake_vector (2, Qnil
);
1291 XVECTOR (XVECTOR (vec
)->contents
[i
])->contents
[0]
1292 = XVECTOR (vec2
)->contents
[0];
1293 XVECTOR (XVECTOR (vec
)->contents
[i
])->contents
[1]
1294 = XVECTOR (vec2
)->contents
[1];
1302 /* Variables for communication with x_handle_selection_notify. */
1303 static Atom reading_which_selection
;
1304 static Lisp_Object reading_selection_reply
;
1305 static Window reading_selection_window
;
1307 /* Do protocol to read selection-data from the server.
1308 Converts this to Lisp data and returns it. */
1311 x_get_foreign_selection (Lisp_Object selection_symbol
, Lisp_Object target_type
, Lisp_Object time_stamp
)
1313 struct frame
*sf
= SELECTED_FRAME ();
1314 Window requestor_window
;
1316 struct x_display_info
*dpyinfo
;
1317 Time requestor_time
= last_event_timestamp
;
1318 Atom target_property
;
1319 Atom selection_atom
;
1322 int count
= SPECPDL_INDEX ();
1325 if (! FRAME_X_P (sf
))
1328 requestor_window
= FRAME_X_WINDOW (sf
);
1329 display
= FRAME_X_DISPLAY (sf
);
1330 dpyinfo
= FRAME_X_DISPLAY_INFO (sf
);
1331 target_property
= dpyinfo
->Xatom_EMACS_TMP
;
1332 selection_atom
= symbol_to_x_atom (dpyinfo
, display
, selection_symbol
);
1334 if (CONSP (target_type
))
1335 type_atom
= symbol_to_x_atom (dpyinfo
, display
, XCAR (target_type
));
1337 type_atom
= symbol_to_x_atom (dpyinfo
, display
, target_type
);
1339 if (! NILP (time_stamp
))
1341 if (CONSP (time_stamp
))
1342 requestor_time
= (Time
) cons_to_long (time_stamp
);
1343 else if (INTEGERP (time_stamp
))
1344 requestor_time
= (Time
) XUINT (time_stamp
);
1345 else if (FLOATP (time_stamp
))
1346 requestor_time
= (Time
) XFLOAT_DATA (time_stamp
);
1348 error ("TIME_STAMP must be cons or number");
1353 /* The protected block contains wait_reading_process_output, which
1354 can run random lisp code (process handlers) or signal.
1355 Therefore, we put the x_uncatch_errors call in an unwind. */
1356 record_unwind_protect (x_catch_errors_unwind
, Qnil
);
1357 x_catch_errors (display
);
1359 TRACE2 ("Get selection %s, type %s",
1360 XGetAtomName (display
, type_atom
),
1361 XGetAtomName (display
, target_property
));
1363 XConvertSelection (display
, selection_atom
, type_atom
, target_property
,
1364 requestor_window
, requestor_time
);
1367 /* Prepare to block until the reply has been read. */
1368 reading_selection_window
= requestor_window
;
1369 reading_which_selection
= selection_atom
;
1370 XSETCAR (reading_selection_reply
, Qnil
);
1372 frame
= some_frame_on_display (dpyinfo
);
1374 /* If the display no longer has frames, we can't expect
1375 to get many more selection requests from it, so don't
1376 bother trying to queue them. */
1379 x_start_queuing_selection_requests ();
1381 record_unwind_protect (queue_selection_requests_unwind
,
1386 /* This allows quits. Also, don't wait forever. */
1387 secs
= x_selection_timeout
/ 1000;
1388 usecs
= (x_selection_timeout
% 1000) * 1000;
1389 TRACE1 (" Start waiting %d secs for SelectionNotify", secs
);
1390 wait_reading_process_output (secs
, usecs
, 0, 0,
1391 reading_selection_reply
, NULL
, 0);
1392 TRACE1 (" Got event = %d", !NILP (XCAR (reading_selection_reply
)));
1395 if (x_had_errors_p (display
))
1396 error ("Cannot get selection");
1397 /* This calls x_uncatch_errors. */
1398 unbind_to (count
, Qnil
);
1401 if (NILP (XCAR (reading_selection_reply
)))
1402 error ("Timed out waiting for reply from selection owner");
1403 if (EQ (XCAR (reading_selection_reply
), Qlambda
))
1406 /* Otherwise, the selection is waiting for us on the requested property. */
1408 x_get_window_property_as_lisp_data (display
, requestor_window
,
1409 target_property
, target_type
,
1413 /* Subroutines of x_get_window_property_as_lisp_data */
1415 /* Use xfree, not XFree, to free the data obtained with this function. */
1418 x_get_window_property (Display
*display
, Window window
, Atom property
,
1419 unsigned char **data_ret
, int *bytes_ret
,
1420 Atom
*actual_type_ret
, int *actual_format_ret
,
1421 unsigned long *actual_size_ret
, int delete_p
)
1424 unsigned long bytes_remaining
;
1426 unsigned char *tmp_data
= 0;
1428 int buffer_size
= SELECTION_QUANTUM (display
);
1430 if (buffer_size
> MAX_SELECTION_QUANTUM
)
1431 buffer_size
= MAX_SELECTION_QUANTUM
;
1435 /* First probe the thing to find out how big it is. */
1436 result
= XGetWindowProperty (display
, window
, property
,
1437 0L, 0L, False
, AnyPropertyType
,
1438 actual_type_ret
, actual_format_ret
,
1440 &bytes_remaining
, &tmp_data
);
1441 if (result
!= Success
)
1449 /* This was allocated by Xlib, so use XFree. */
1450 XFree ((char *) tmp_data
);
1452 if (*actual_type_ret
== None
|| *actual_format_ret
== 0)
1458 total_size
= bytes_remaining
+ 1;
1459 *data_ret
= (unsigned char *) xmalloc (total_size
);
1461 /* Now read, until we've gotten it all. */
1462 while (bytes_remaining
)
1464 #ifdef TRACE_SELECTION
1465 int last
= bytes_remaining
;
1468 = XGetWindowProperty (display
, window
, property
,
1469 (long)offset
/4, (long)buffer_size
/4,
1472 actual_type_ret
, actual_format_ret
,
1473 actual_size_ret
, &bytes_remaining
, &tmp_data
);
1475 TRACE2 ("Read %ld bytes from property %s",
1476 last
- bytes_remaining
,
1477 XGetAtomName (display
, property
));
1479 /* If this doesn't return Success at this point, it means that
1480 some clod deleted the selection while we were in the midst of
1481 reading it. Deal with that, I guess.... */
1482 if (result
!= Success
)
1485 /* The man page for XGetWindowProperty says:
1486 "If the returned format is 32, the returned data is represented
1487 as a long array and should be cast to that type to obtain the
1489 This applies even if long is more than 32 bits, the X library
1490 converts from 32 bit elements received from the X server to long
1491 and passes the long array to us. Thus, for that case memcpy can not
1492 be used. We convert to a 32 bit type here, because so much code
1495 The bytes and offsets passed to XGetWindowProperty refers to the
1496 property and those are indeed in 32 bit quantities if format is 32. */
1498 if (*actual_format_ret
== 32 && *actual_format_ret
< BITS_PER_LONG
)
1501 int *idata
= (int *) ((*data_ret
) + offset
);
1502 long *ldata
= (long *) tmp_data
;
1504 for (i
= 0; i
< *actual_size_ret
; ++i
)
1506 idata
[i
]= (int) ldata
[i
];
1512 *actual_size_ret
*= *actual_format_ret
/ 8;
1513 memcpy ((*data_ret
) + offset
, tmp_data
, *actual_size_ret
);
1514 offset
+= *actual_size_ret
;
1517 /* This was allocated by Xlib, so use XFree. */
1518 XFree ((char *) tmp_data
);
1523 *bytes_ret
= offset
;
1526 /* Use xfree, not XFree, to free the data obtained with this function. */
1529 receive_incremental_selection (Display
*display
, Window window
, Atom property
,
1530 Lisp_Object target_type
,
1531 unsigned int min_size_bytes
,
1532 unsigned char **data_ret
, int *size_bytes_ret
,
1533 Atom
*type_ret
, int *format_ret
,
1534 unsigned long *size_ret
)
1537 struct prop_location
*wait_object
;
1538 *size_bytes_ret
= min_size_bytes
;
1539 *data_ret
= (unsigned char *) xmalloc (*size_bytes_ret
);
1541 TRACE1 ("Read %d bytes incrementally", min_size_bytes
);
1543 /* At this point, we have read an INCR property.
1544 Delete the property to ack it.
1545 (But first, prepare to receive the next event in this handshake.)
1547 Now, we must loop, waiting for the sending window to put a value on
1548 that property, then reading the property, then deleting it to ack.
1549 We are done when the sender places a property of length 0.
1552 XSelectInput (display
, window
, STANDARD_EVENT_SET
| PropertyChangeMask
);
1553 TRACE1 (" Delete property %s",
1554 SDATA (SYMBOL_NAME (x_atom_to_symbol (display
, property
))));
1555 XDeleteProperty (display
, window
, property
);
1556 TRACE1 (" Expect new value of property %s",
1557 SDATA (SYMBOL_NAME (x_atom_to_symbol (display
, property
))));
1558 wait_object
= expect_property_change (display
, window
, property
,
1565 unsigned char *tmp_data
;
1568 TRACE0 (" Wait for property change");
1569 wait_for_property_change (wait_object
);
1571 /* expect it again immediately, because x_get_window_property may
1572 .. no it won't, I don't get it.
1573 .. Ok, I get it now, the Xt code that implements INCR is broken. */
1574 TRACE0 (" Get property value");
1575 x_get_window_property (display
, window
, property
,
1576 &tmp_data
, &tmp_size_bytes
,
1577 type_ret
, format_ret
, size_ret
, 1);
1579 TRACE1 (" Read increment of %d bytes", tmp_size_bytes
);
1581 if (tmp_size_bytes
== 0) /* we're done */
1583 TRACE0 ("Done reading incrementally");
1585 if (! waiting_for_other_props_on_window (display
, window
))
1586 XSelectInput (display
, window
, STANDARD_EVENT_SET
);
1587 /* Use xfree, not XFree, because x_get_window_property
1588 calls xmalloc itself. */
1594 TRACE1 (" ACK by deleting property %s",
1595 XGetAtomName (display
, property
));
1596 XDeleteProperty (display
, window
, property
);
1597 wait_object
= expect_property_change (display
, window
, property
,
1602 if (*size_bytes_ret
< offset
+ tmp_size_bytes
)
1604 *size_bytes_ret
= offset
+ tmp_size_bytes
;
1605 *data_ret
= (unsigned char *) xrealloc (*data_ret
, *size_bytes_ret
);
1608 memcpy ((*data_ret
) + offset
, tmp_data
, tmp_size_bytes
);
1609 offset
+= tmp_size_bytes
;
1611 /* Use xfree, not XFree, because x_get_window_property
1612 calls xmalloc itself. */
1618 /* Once a requested selection is "ready" (we got a SelectionNotify event),
1619 fetch value from property PROPERTY of X window WINDOW on display DISPLAY.
1620 TARGET_TYPE and SELECTION_ATOM are used in error message if this fails. */
1623 x_get_window_property_as_lisp_data (Display
*display
, Window window
,
1625 Lisp_Object target_type
,
1626 Atom selection_atom
)
1630 unsigned long actual_size
;
1631 unsigned char *data
= 0;
1634 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
1636 TRACE0 ("Reading selection data");
1638 x_get_window_property (display
, window
, property
, &data
, &bytes
,
1639 &actual_type
, &actual_format
, &actual_size
, 1);
1642 int there_is_a_selection_owner
;
1644 there_is_a_selection_owner
1645 = XGetSelectionOwner (display
, selection_atom
);
1647 if (there_is_a_selection_owner
)
1648 signal_error ("Selection owner couldn't convert",
1650 ? list2 (target_type
,
1651 x_atom_to_symbol (display
, actual_type
))
1654 signal_error ("No selection",
1655 x_atom_to_symbol (display
, selection_atom
));
1658 if (actual_type
== dpyinfo
->Xatom_INCR
)
1660 /* That wasn't really the data, just the beginning. */
1662 unsigned int min_size_bytes
= * ((unsigned int *) data
);
1664 /* Use xfree, not XFree, because x_get_window_property
1665 calls xmalloc itself. */
1666 xfree ((char *) data
);
1668 receive_incremental_selection (display
, window
, property
, target_type
,
1669 min_size_bytes
, &data
, &bytes
,
1670 &actual_type
, &actual_format
,
1675 TRACE1 (" Delete property %s", XGetAtomName (display
, property
));
1676 XDeleteProperty (display
, window
, property
);
1680 /* It's been read. Now convert it to a lisp object in some semi-rational
1682 val
= selection_data_to_lisp_data (display
, data
, bytes
,
1683 actual_type
, actual_format
);
1685 /* Use xfree, not XFree, because x_get_window_property
1686 calls xmalloc itself. */
1687 xfree ((char *) data
);
1691 /* These functions convert from the selection data read from the server into
1692 something that we can use from Lisp, and vice versa.
1694 Type: Format: Size: Lisp Type:
1695 ----- ------- ----- -----------
1698 ATOM 32 > 1 Vector of Symbols
1700 * 16 > 1 Vector of Integers
1701 * 32 1 if <=16 bits: Integer
1702 if > 16 bits: Cons of top16, bot16
1703 * 32 > 1 Vector of the above
1705 When converting a Lisp number to C, it is assumed to be of format 16 if
1706 it is an integer, and of format 32 if it is a cons of two integers.
1708 When converting a vector of numbers from Lisp to C, it is assumed to be
1709 of format 16 if every element in the vector is an integer, and is assumed
1710 to be of format 32 if any element is a cons of two integers.
1712 When converting an object to C, it may be of the form (SYMBOL . <data>)
1713 where SYMBOL is what we should claim that the type is. Format and
1714 representation are as above.
1716 Important: When format is 32, data should contain an array of int,
1717 not an array of long as the X library returns. This makes a difference
1718 when sizeof(long) != sizeof(int). */
1723 selection_data_to_lisp_data (Display
*display
, const unsigned char *data
,
1724 int size
, Atom type
, int format
)
1726 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
1728 if (type
== dpyinfo
->Xatom_NULL
)
1731 /* Convert any 8-bit data to a string, for compactness. */
1732 else if (format
== 8)
1734 Lisp_Object str
, lispy_type
;
1736 str
= make_unibyte_string ((char *) data
, size
);
1737 /* Indicate that this string is from foreign selection by a text
1738 property `foreign-selection' so that the caller of
1739 x-get-selection-internal (usually x-get-selection) can know
1740 that the string must be decode. */
1741 if (type
== dpyinfo
->Xatom_COMPOUND_TEXT
)
1742 lispy_type
= QCOMPOUND_TEXT
;
1743 else if (type
== dpyinfo
->Xatom_UTF8_STRING
)
1744 lispy_type
= QUTF8_STRING
;
1746 lispy_type
= QSTRING
;
1747 Fput_text_property (make_number (0), make_number (size
),
1748 Qforeign_selection
, lispy_type
, str
);
1751 /* Convert a single atom to a Lisp_Symbol. Convert a set of atoms to
1752 a vector of symbols.
1754 else if (type
== XA_ATOM
)
1757 /* On a 64 bit machine sizeof(Atom) == sizeof(long) == 8.
1758 But the callers of these function has made sure the data for
1759 format == 32 is an array of int. Thus, use int instead
1761 int *idata
= (int *) data
;
1763 if (size
== sizeof (int))
1764 return x_atom_to_symbol (display
, (Atom
) idata
[0]);
1767 Lisp_Object v
= Fmake_vector (make_number (size
/ sizeof (int)),
1769 for (i
= 0; i
< size
/ sizeof (int); i
++)
1770 Faset (v
, make_number (i
),
1771 x_atom_to_symbol (display
, (Atom
) idata
[i
]));
1776 /* Convert a single 16-bit number or a small 32-bit number to a Lisp_Int.
1777 If the number is 32 bits and won't fit in a Lisp_Int,
1778 convert it to a cons of integers, 16 bits in each half.
1780 else if (format
== 32 && size
== sizeof (int))
1781 return long_to_cons (((unsigned int *) data
) [0]);
1782 else if (format
== 16 && size
== sizeof (short))
1783 return make_number ((int) (((unsigned short *) data
) [0]));
1785 /* Convert any other kind of data to a vector of numbers, represented
1786 as above (as an integer, or a cons of two 16 bit integers.)
1788 else if (format
== 16)
1792 v
= Fmake_vector (make_number (size
/ 2), make_number (0));
1793 for (i
= 0; i
< size
/ 2; i
++)
1795 int j
= (int) ((unsigned short *) data
) [i
];
1796 Faset (v
, make_number (i
), make_number (j
));
1803 Lisp_Object v
= Fmake_vector (make_number (size
/ 4), make_number (0));
1804 for (i
= 0; i
< size
/ 4; i
++)
1806 unsigned int j
= ((unsigned int *) data
) [i
];
1807 Faset (v
, make_number (i
), long_to_cons (j
));
1814 /* Use xfree, not XFree, to free the data obtained with this function. */
1817 lisp_data_to_selection_data (Display
*display
, Lisp_Object obj
,
1818 unsigned char **data_ret
, Atom
*type_ret
,
1819 unsigned int *size_ret
,
1820 int *format_ret
, int *nofree_ret
)
1822 Lisp_Object type
= Qnil
;
1823 struct x_display_info
*dpyinfo
= x_display_info_for_display (display
);
1827 if (CONSP (obj
) && SYMBOLP (XCAR (obj
)))
1831 if (CONSP (obj
) && NILP (XCDR (obj
)))
1835 if (EQ (obj
, QNULL
) || (EQ (type
, QNULL
)))
1836 { /* This is not the same as declining */
1842 else if (STRINGP (obj
))
1844 if (SCHARS (obj
) < SBYTES (obj
))
1845 /* OBJ is a multibyte string containing a non-ASCII char. */
1846 signal_error ("Non-ASCII string must be encoded in advance", obj
);
1850 *size_ret
= SBYTES (obj
);
1851 *data_ret
= SDATA (obj
);
1854 else if (SYMBOLP (obj
))
1858 *data_ret
= (unsigned char *) xmalloc (sizeof (Atom
) + 1);
1859 (*data_ret
) [sizeof (Atom
)] = 0;
1860 (*(Atom
**) data_ret
) [0] = symbol_to_x_atom (dpyinfo
, display
, obj
);
1861 if (NILP (type
)) type
= QATOM
;
1863 else if (INTEGERP (obj
)
1864 && XINT (obj
) < 0xFFFF
1865 && XINT (obj
) > -0xFFFF)
1869 *data_ret
= (unsigned char *) xmalloc (sizeof (short) + 1);
1870 (*data_ret
) [sizeof (short)] = 0;
1871 (*(short **) data_ret
) [0] = (short) XINT (obj
);
1872 if (NILP (type
)) type
= QINTEGER
;
1874 else if (INTEGERP (obj
)
1875 || (CONSP (obj
) && INTEGERP (XCAR (obj
))
1876 && (INTEGERP (XCDR (obj
))
1877 || (CONSP (XCDR (obj
))
1878 && INTEGERP (XCAR (XCDR (obj
)))))))
1882 *data_ret
= (unsigned char *) xmalloc (sizeof (long) + 1);
1883 (*data_ret
) [sizeof (long)] = 0;
1884 (*(unsigned long **) data_ret
) [0] = cons_to_long (obj
);
1885 if (NILP (type
)) type
= QINTEGER
;
1887 else if (VECTORP (obj
))
1889 /* Lisp_Vectors may represent a set of ATOMs;
1890 a set of 16 or 32 bit INTEGERs;
1891 or a set of ATOM_PAIRs (represented as [[A1 A2] [A3 A4] ...]
1895 if (SYMBOLP (XVECTOR (obj
)->contents
[0]))
1896 /* This vector is an ATOM set */
1898 if (NILP (type
)) type
= QATOM
;
1899 *size_ret
= XVECTOR (obj
)->size
;
1901 *data_ret
= (unsigned char *) xmalloc ((*size_ret
) * sizeof (Atom
));
1902 for (i
= 0; i
< *size_ret
; i
++)
1903 if (SYMBOLP (XVECTOR (obj
)->contents
[i
]))
1904 (*(Atom
**) data_ret
) [i
]
1905 = symbol_to_x_atom (dpyinfo
, display
, XVECTOR (obj
)->contents
[i
]);
1907 signal_error ("All elements of selection vector must have same type", obj
);
1909 #if 0 /* #### MULTIPLE doesn't work yet */
1910 else if (VECTORP (XVECTOR (obj
)->contents
[0]))
1911 /* This vector is an ATOM_PAIR set */
1913 if (NILP (type
)) type
= QATOM_PAIR
;
1914 *size_ret
= XVECTOR (obj
)->size
;
1916 *data_ret
= (unsigned char *)
1917 xmalloc ((*size_ret
) * sizeof (Atom
) * 2);
1918 for (i
= 0; i
< *size_ret
; i
++)
1919 if (VECTORP (XVECTOR (obj
)->contents
[i
]))
1921 Lisp_Object pair
= XVECTOR (obj
)->contents
[i
];
1922 if (XVECTOR (pair
)->size
!= 2)
1924 "Elements of the vector must be vectors of exactly two elements",
1927 (*(Atom
**) data_ret
) [i
* 2]
1928 = symbol_to_x_atom (dpyinfo
, display
,
1929 XVECTOR (pair
)->contents
[0]);
1930 (*(Atom
**) data_ret
) [(i
* 2) + 1]
1931 = symbol_to_x_atom (dpyinfo
, display
,
1932 XVECTOR (pair
)->contents
[1]);
1935 signal_error ("All elements of the vector must be of the same type",
1941 /* This vector is an INTEGER set, or something like it */
1944 *size_ret
= XVECTOR (obj
)->size
;
1945 if (NILP (type
)) type
= QINTEGER
;
1947 for (i
= 0; i
< *size_ret
; i
++)
1948 if (CONSP (XVECTOR (obj
)->contents
[i
]))
1950 else if (!INTEGERP (XVECTOR (obj
)->contents
[i
]))
1951 signal_error (/* Qselection_error */
1952 "Elements of selection vector must be integers or conses of integers",
1955 /* Use sizeof(long) even if it is more than 32 bits. See comment
1956 in x_get_window_property and x_fill_property_data. */
1958 if (*format_ret
== 32) data_size
= sizeof(long);
1959 *data_ret
= (unsigned char *) xmalloc (*size_ret
* data_size
);
1960 for (i
= 0; i
< *size_ret
; i
++)
1961 if (*format_ret
== 32)
1962 (*((unsigned long **) data_ret
)) [i
]
1963 = cons_to_long (XVECTOR (obj
)->contents
[i
]);
1965 (*((unsigned short **) data_ret
)) [i
]
1966 = (unsigned short) cons_to_long (XVECTOR (obj
)->contents
[i
]);
1970 signal_error (/* Qselection_error */ "Unrecognized selection data", obj
);
1972 *type_ret
= symbol_to_x_atom (dpyinfo
, display
, type
);
1976 clean_local_selection_data (Lisp_Object obj
)
1979 && INTEGERP (XCAR (obj
))
1980 && CONSP (XCDR (obj
))
1981 && INTEGERP (XCAR (XCDR (obj
)))
1982 && NILP (XCDR (XCDR (obj
))))
1983 obj
= Fcons (XCAR (obj
), XCDR (obj
));
1986 && INTEGERP (XCAR (obj
))
1987 && INTEGERP (XCDR (obj
)))
1989 if (XINT (XCAR (obj
)) == 0)
1991 if (XINT (XCAR (obj
)) == -1)
1992 return make_number (- XINT (XCDR (obj
)));
1997 int size
= XVECTOR (obj
)->size
;
2000 return clean_local_selection_data (XVECTOR (obj
)->contents
[0]);
2001 copy
= Fmake_vector (make_number (size
), Qnil
);
2002 for (i
= 0; i
< size
; i
++)
2003 XVECTOR (copy
)->contents
[i
]
2004 = clean_local_selection_data (XVECTOR (obj
)->contents
[i
]);
2010 /* Called from XTread_socket to handle SelectionNotify events.
2011 If it's the selection we are waiting for, stop waiting
2012 by setting the car of reading_selection_reply to non-nil.
2013 We store t there if the reply is successful, lambda if not. */
2016 x_handle_selection_notify (XSelectionEvent
*event
)
2018 if (event
->requestor
!= reading_selection_window
)
2020 if (event
->selection
!= reading_which_selection
)
2023 TRACE0 ("Received SelectionNotify");
2024 XSETCAR (reading_selection_reply
,
2025 (event
->property
!= 0 ? Qt
: Qlambda
));
2029 DEFUN ("x-own-selection-internal", Fx_own_selection_internal
,
2030 Sx_own_selection_internal
, 2, 2, 0,
2031 doc
: /* Assert an X selection of the given TYPE with the given VALUE.
2032 TYPE is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.
2033 \(Those are literal upper-case symbol names, since that's what X expects.)
2034 VALUE is typically a string, or a cons of two markers, but may be
2035 anything that the functions on `selection-converter-alist' know about. */)
2036 (Lisp_Object selection_name
, Lisp_Object selection_value
)
2039 CHECK_SYMBOL (selection_name
);
2040 if (NILP (selection_value
)) error ("SELECTION-VALUE may not be nil");
2041 x_own_selection (selection_name
, selection_value
);
2042 return selection_value
;
2046 /* Request the selection value from the owner. If we are the owner,
2047 simply return our selection value. If we are not the owner, this
2048 will block until all of the data has arrived. */
2050 DEFUN ("x-get-selection-internal", Fx_get_selection_internal
,
2051 Sx_get_selection_internal
, 2, 3, 0,
2052 doc
: /* Return text selected from some X window.
2053 SELECTION is a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'.
2054 \(Those are literal upper-case symbol names, since that's what X expects.)
2055 TYPE is the type of data desired, typically `STRING'.
2056 TIME_STAMP is the time to use in the XConvertSelection call for foreign
2057 selections. If omitted, defaults to the time for the last event. */)
2058 (Lisp_Object selection_symbol
, Lisp_Object target_type
, Lisp_Object time_stamp
)
2060 Lisp_Object val
= Qnil
;
2061 struct gcpro gcpro1
, gcpro2
;
2062 GCPRO2 (target_type
, val
); /* we store newly consed data into these */
2064 CHECK_SYMBOL (selection_symbol
);
2066 #if 0 /* #### MULTIPLE doesn't work yet */
2067 if (CONSP (target_type
)
2068 && XCAR (target_type
) == QMULTIPLE
)
2070 CHECK_VECTOR (XCDR (target_type
));
2071 /* So we don't destructively modify this... */
2072 target_type
= copy_multiple_data (target_type
);
2076 CHECK_SYMBOL (target_type
);
2078 val
= x_get_local_selection (selection_symbol
, target_type
, 1);
2082 val
= x_get_foreign_selection (selection_symbol
, target_type
, time_stamp
);
2087 && SYMBOLP (XCAR (val
)))
2090 if (CONSP (val
) && NILP (XCDR (val
)))
2093 val
= clean_local_selection_data (val
);
2099 DEFUN ("x-disown-selection-internal", Fx_disown_selection_internal
,
2100 Sx_disown_selection_internal
, 1, 2, 0,
2101 doc
: /* If we own the selection SELECTION, disown it.
2102 Disowning it means there is no such selection. */)
2103 (Lisp_Object selection
, Lisp_Object time
)
2106 Atom selection_atom
;
2108 struct selection_input_event sie
;
2109 struct input_event ie
;
2112 struct x_display_info
*dpyinfo
;
2113 struct frame
*sf
= SELECTED_FRAME ();
2116 if (! FRAME_X_P (sf
))
2119 display
= FRAME_X_DISPLAY (sf
);
2120 dpyinfo
= FRAME_X_DISPLAY_INFO (sf
);
2121 CHECK_SYMBOL (selection
);
2123 timestamp
= last_event_timestamp
;
2125 timestamp
= cons_to_long (time
);
2127 if (NILP (assq_no_quit (selection
, Vselection_alist
)))
2128 return Qnil
; /* Don't disown the selection when we're not the owner. */
2130 selection_atom
= symbol_to_x_atom (dpyinfo
, display
, selection
);
2133 XSetSelectionOwner (display
, selection_atom
, None
, timestamp
);
2136 /* It doesn't seem to be guaranteed that a SelectionClear event will be
2137 generated for a window which owns the selection when that window sets
2138 the selection owner to None. The NCD server does, the MIT Sun4 server
2139 doesn't. So we synthesize one; this means we might get two, but
2140 that's ok, because the second one won't have any effect. */
2141 SELECTION_EVENT_DISPLAY (&event
.sie
) = display
;
2142 SELECTION_EVENT_SELECTION (&event
.sie
) = selection_atom
;
2143 SELECTION_EVENT_TIME (&event
.sie
) = timestamp
;
2144 x_handle_selection_clear (&event
.ie
);
2149 /* Get rid of all the selections in buffer BUFFER.
2150 This is used when we kill a buffer. */
2153 x_disown_buffer_selections (Lisp_Object buffer
)
2156 struct buffer
*buf
= XBUFFER (buffer
);
2158 for (tail
= Vselection_alist
; CONSP (tail
); tail
= XCDR (tail
))
2160 Lisp_Object elt
, value
;
2163 if (CONSP (value
) && MARKERP (XCAR (value
))
2164 && XMARKER (XCAR (value
))->buffer
== buf
)
2165 Fx_disown_selection_internal (XCAR (elt
), Qnil
);
2169 DEFUN ("x-selection-owner-p", Fx_selection_owner_p
, Sx_selection_owner_p
,
2171 doc
: /* Whether the current Emacs process owns the given X Selection.
2172 The arg should be the name of the selection in question, typically one of
2173 the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.
2174 \(Those are literal upper-case symbol names, since that's what X expects.)
2175 For convenience, the symbol nil is the same as `PRIMARY',
2176 and t is the same as `SECONDARY'. */)
2177 (Lisp_Object selection
)
2180 CHECK_SYMBOL (selection
);
2181 if (EQ (selection
, Qnil
)) selection
= QPRIMARY
;
2182 if (EQ (selection
, Qt
)) selection
= QSECONDARY
;
2184 if (NILP (Fassq (selection
, Vselection_alist
)))
2189 DEFUN ("x-selection-exists-p", Fx_selection_exists_p
, Sx_selection_exists_p
,
2191 doc
: /* Whether there is an owner for the given X Selection.
2192 The arg should be the name of the selection in question, typically one of
2193 the symbols `PRIMARY', `SECONDARY', or `CLIPBOARD'.
2194 \(Those are literal upper-case symbol names, since that's what X expects.)
2195 For convenience, the symbol nil is the same as `PRIMARY',
2196 and t is the same as `SECONDARY'. */)
2197 (Lisp_Object selection
)
2202 struct frame
*sf
= SELECTED_FRAME ();
2204 /* It should be safe to call this before we have an X frame. */
2205 if (! FRAME_X_P (sf
))
2208 dpy
= FRAME_X_DISPLAY (sf
);
2209 CHECK_SYMBOL (selection
);
2210 if (!NILP (Fx_selection_owner_p (selection
)))
2212 if (EQ (selection
, Qnil
)) selection
= QPRIMARY
;
2213 if (EQ (selection
, Qt
)) selection
= QSECONDARY
;
2214 atom
= symbol_to_x_atom (FRAME_X_DISPLAY_INFO (sf
), dpy
, selection
);
2218 owner
= XGetSelectionOwner (dpy
, atom
);
2220 return (owner
? Qt
: Qnil
);
2224 /***********************************************************************
2225 Drag and drop support
2226 ***********************************************************************/
2227 /* Check that lisp values are of correct type for x_fill_property_data.
2228 That is, number, string or a cons with two numbers (low and high 16
2229 bit parts of a 32 bit number). */
2232 x_check_property_data (Lisp_Object data
)
2237 for (iter
= data
; CONSP (iter
) && size
!= -1; iter
= XCDR (iter
), ++size
)
2239 Lisp_Object o
= XCAR (iter
);
2241 if (! NUMBERP (o
) && ! STRINGP (o
) && ! CONSP (o
))
2243 else if (CONSP (o
) &&
2244 (! NUMBERP (XCAR (o
)) || ! NUMBERP (XCDR (o
))))
2251 /* Convert lisp values to a C array. Values may be a number, a string
2252 which is taken as an X atom name and converted to the atom value, or
2253 a cons containing the two 16 bit parts of a 32 bit number.
2255 DPY is the display use to look up X atoms.
2256 DATA is a Lisp list of values to be converted.
2257 RET is the C array that contains the converted values. It is assumed
2258 it is big enough to hold all values.
2259 FORMAT is 8, 16 or 32 and denotes char/short/long for each C value to
2260 be stored in RET. Note that long is used for 32 even if long is more
2261 than 32 bits (see man pages for XChangeProperty, XGetWindowProperty and
2262 XClientMessageEvent). */
2265 x_fill_property_data (Display
*dpy
, Lisp_Object data
, void *ret
, int format
)
2268 long *d32
= (long *) ret
;
2269 short *d16
= (short *) ret
;
2270 char *d08
= (char *) ret
;
2273 for (iter
= data
; CONSP (iter
); iter
= XCDR (iter
))
2275 Lisp_Object o
= XCAR (iter
);
2278 val
= (long) XFASTINT (o
);
2279 else if (FLOATP (o
))
2280 val
= (long) XFLOAT_DATA (o
);
2282 val
= (long) cons_to_long (o
);
2283 else if (STRINGP (o
))
2286 val
= (long) XInternAtom (dpy
, (char *) SDATA (o
), False
);
2290 error ("Wrong type, must be string, number or cons");
2293 *d08
++ = (char) val
;
2294 else if (format
== 16)
2295 *d16
++ = (short) val
;
2301 /* Convert an array of C values to a Lisp list.
2302 F is the frame to be used to look up X atoms if the TYPE is XA_ATOM.
2303 DATA is a C array of values to be converted.
2304 TYPE is the type of the data. Only XA_ATOM is special, it converts
2305 each number in DATA to its corresponfing X atom as a symbol.
2306 FORMAT is 8, 16 or 32 and gives the size in bits for each C value to
2308 SIZE is the number of elements in DATA.
2310 Important: When format is 32, data should contain an array of int,
2311 not an array of long as the X library returns. This makes a difference
2312 when sizeof(long) != sizeof(int).
2314 Also see comment for selection_data_to_lisp_data above. */
2317 x_property_data_to_lisp (struct frame
*f
, const unsigned char *data
,
2318 Atom type
, int format
, long unsigned int size
)
2320 return selection_data_to_lisp_data (FRAME_X_DISPLAY (f
),
2321 data
, size
*format
/8, type
, format
);
2324 /* Get the mouse position in frame relative coordinates. */
2327 mouse_position_for_drop (FRAME_PTR f
, int *x
, int *y
)
2329 Window root
, dummy_window
;
2334 XQueryPointer (FRAME_X_DISPLAY (f
),
2335 DefaultRootWindow (FRAME_X_DISPLAY (f
)),
2337 /* The root window which contains the pointer. */
2340 /* Window pointer is on, not used */
2343 /* The position on that root window. */
2346 /* x/y in dummy_window coordinates, not used. */
2349 /* Modifier keys and pointer buttons, about which
2351 (unsigned int *) &dummy
);
2354 /* Absolute to relative. */
2355 *x
-= f
->left_pos
+ FRAME_OUTER_TO_INNER_DIFF_X (f
);
2356 *y
-= f
->top_pos
+ FRAME_OUTER_TO_INNER_DIFF_Y (f
);
2361 DEFUN ("x-get-atom-name", Fx_get_atom_name
,
2362 Sx_get_atom_name
, 1, 2, 0,
2363 doc
: /* Return the X atom name for VALUE as a string.
2364 VALUE may be a number or a cons where the car is the upper 16 bits and
2365 the cdr is the lower 16 bits of a 32 bit value.
2366 Use the display for FRAME or the current frame if FRAME is not given or nil.
2368 If the value is 0 or the atom is not known, return the empty string. */)
2369 (Lisp_Object value
, Lisp_Object frame
)
2371 struct frame
*f
= check_x_frame (frame
);
2374 Lisp_Object ret
= Qnil
;
2375 Display
*dpy
= FRAME_X_DISPLAY (f
);
2379 if (INTEGERP (value
))
2380 atom
= (Atom
) XUINT (value
);
2381 else if (FLOATP (value
))
2382 atom
= (Atom
) XFLOAT_DATA (value
);
2383 else if (CONSP (value
))
2384 atom
= (Atom
) cons_to_long (value
);
2386 error ("Wrong type, value must be number or cons");
2389 x_catch_errors (dpy
);
2390 name
= atom
? XGetAtomName (dpy
, atom
) : empty
;
2391 had_errors
= x_had_errors_p (dpy
);
2392 x_uncatch_errors ();
2395 ret
= make_string (name
, strlen (name
));
2397 if (atom
&& name
) XFree (name
);
2398 if (NILP (ret
)) ret
= empty_unibyte_string
;
2405 DEFUN ("x-register-dnd-atom", Fx_register_dnd_atom
,
2406 Sx_register_dnd_atom
, 1, 2, 0,
2407 doc
: /* Request that dnd events are made for ClientMessages with ATOM.
2408 ATOM can be a symbol or a string. The ATOM is interned on the display that
2409 FRAME is on. If FRAME is nil, the selected frame is used. */)
2410 (Lisp_Object atom
, Lisp_Object frame
)
2413 struct frame
*f
= check_x_frame (frame
);
2415 struct x_display_info
*dpyinfo
= FRAME_X_DISPLAY_INFO (f
);
2419 x_atom
= symbol_to_x_atom (dpyinfo
, FRAME_X_DISPLAY (f
), atom
);
2420 else if (STRINGP (atom
))
2423 x_atom
= XInternAtom (FRAME_X_DISPLAY (f
), (char *) SDATA (atom
), False
);
2427 error ("ATOM must be a symbol or a string");
2429 for (i
= 0; i
< dpyinfo
->x_dnd_atoms_length
; ++i
)
2430 if (dpyinfo
->x_dnd_atoms
[i
] == x_atom
)
2433 if (dpyinfo
->x_dnd_atoms_length
== dpyinfo
->x_dnd_atoms_size
)
2435 dpyinfo
->x_dnd_atoms_size
*= 2;
2436 dpyinfo
->x_dnd_atoms
= xrealloc (dpyinfo
->x_dnd_atoms
,
2437 sizeof (*dpyinfo
->x_dnd_atoms
)
2438 * dpyinfo
->x_dnd_atoms_size
);
2441 dpyinfo
->x_dnd_atoms
[dpyinfo
->x_dnd_atoms_length
++] = x_atom
;
2445 /* Convert an XClientMessageEvent to a Lisp event of type DRAG_N_DROP_EVENT. */
2448 x_handle_dnd_message (struct frame
*f
, XClientMessageEvent
*event
, struct x_display_info
*dpyinfo
, struct input_event
*bufp
)
2452 /* format 32 => size 5, format 16 => size 10, format 8 => size 20 */
2453 unsigned long size
= 160/event
->format
;
2455 unsigned char *data
= (unsigned char *) event
->data
.b
;
2459 for (i
= 0; i
< dpyinfo
->x_dnd_atoms_length
; ++i
)
2460 if (dpyinfo
->x_dnd_atoms
[i
] == event
->message_type
) break;
2462 if (i
== dpyinfo
->x_dnd_atoms_length
) return 0;
2464 XSETFRAME (frame
, f
);
2466 /* On a 64 bit machine, the event->data.l array members are 64 bits (long),
2467 but the x_property_data_to_lisp (or rather selection_data_to_lisp_data)
2468 function expects them to be of size int (i.e. 32). So to be able to
2469 use that function, put the data in the form it expects if format is 32. */
2471 if (event
->format
== 32 && event
->format
< BITS_PER_LONG
)
2474 for (i
= 0; i
< 5; ++i
) /* There are only 5 longs in a ClientMessage. */
2475 idata
[i
] = (int) event
->data
.l
[i
];
2476 data
= (unsigned char *) idata
;
2479 vec
= Fmake_vector (make_number (4), Qnil
);
2480 ASET (vec
, 0, SYMBOL_NAME (x_atom_to_symbol (FRAME_X_DISPLAY (f
),
2481 event
->message_type
)));
2482 ASET (vec
, 1, frame
);
2483 ASET (vec
, 2, make_number (event
->format
));
2484 ASET (vec
, 3, x_property_data_to_lisp (f
,
2486 event
->message_type
,
2490 mouse_position_for_drop (f
, &x
, &y
);
2491 bufp
->kind
= DRAG_N_DROP_EVENT
;
2492 bufp
->frame_or_window
= frame
;
2493 bufp
->timestamp
= CurrentTime
;
2494 bufp
->x
= make_number (x
);
2495 bufp
->y
= make_number (y
);
2497 bufp
->modifiers
= 0;
2502 DEFUN ("x-send-client-message", Fx_send_client_event
,
2503 Sx_send_client_message
, 6, 6, 0,
2504 doc
: /* Send a client message of MESSAGE-TYPE to window DEST on DISPLAY.
2506 For DISPLAY, specify either a frame or a display name (a string).
2507 If DISPLAY is nil, that stands for the selected frame's display.
2508 DEST may be a number, in which case it is a Window id. The value 0 may
2509 be used to send to the root window of the DISPLAY.
2510 If DEST is a cons, it is converted to a 32 bit number
2511 with the high 16 bits from the car and the lower 16 bit from the cdr. That
2512 number is then used as a window id.
2513 If DEST is a frame the event is sent to the outer window of that frame.
2514 A value of nil means the currently selected frame.
2515 If DEST is the string "PointerWindow" the event is sent to the window that
2516 contains the pointer. If DEST is the string "InputFocus" the event is
2517 sent to the window that has the input focus.
2518 FROM is the frame sending the event. Use nil for currently selected frame.
2519 MESSAGE-TYPE is the name of an Atom as a string.
2520 FORMAT must be one of 8, 16 or 32 and determines the size of the values in
2521 bits. VALUES is a list of numbers, cons and/or strings containing the values
2522 to send. If a value is a string, it is converted to an Atom and the value of
2523 the Atom is sent. If a value is a cons, it is converted to a 32 bit number
2524 with the high 16 bits from the car and the lower 16 bit from the cdr.
2525 If more values than fits into the event is given, the excessive values
2527 (Lisp_Object display
, Lisp_Object dest
, Lisp_Object from
, Lisp_Object message_type
, Lisp_Object format
, Lisp_Object values
)
2529 struct x_display_info
*dpyinfo
= check_x_display_info (display
);
2534 struct frame
*f
= check_x_frame (from
);
2537 CHECK_STRING (message_type
);
2538 CHECK_NUMBER (format
);
2539 CHECK_CONS (values
);
2541 if (x_check_property_data (values
) == -1)
2542 error ("Bad data in VALUES, must be number, cons or string");
2544 event
.xclient
.type
= ClientMessage
;
2545 event
.xclient
.format
= XFASTINT (format
);
2547 if (event
.xclient
.format
!= 8 && event
.xclient
.format
!= 16
2548 && event
.xclient
.format
!= 32)
2549 error ("FORMAT must be one of 8, 16 or 32");
2551 if (FRAMEP (dest
) || NILP (dest
))
2553 struct frame
*fdest
= check_x_frame (dest
);
2554 wdest
= FRAME_OUTER_WINDOW (fdest
);
2556 else if (STRINGP (dest
))
2558 if (strcmp (SDATA (dest
), "PointerWindow") == 0)
2559 wdest
= PointerWindow
;
2560 else if (strcmp (SDATA (dest
), "InputFocus") == 0)
2563 error ("DEST as a string must be one of PointerWindow or InputFocus");
2565 else if (INTEGERP (dest
))
2566 wdest
= (Window
) XFASTINT (dest
);
2567 else if (FLOATP (dest
))
2568 wdest
= (Window
) XFLOAT_DATA (dest
);
2569 else if (CONSP (dest
))
2571 if (! NUMBERP (XCAR (dest
)) || ! NUMBERP (XCDR (dest
)))
2572 error ("Both car and cdr for DEST must be numbers");
2574 wdest
= (Window
) cons_to_long (dest
);
2577 error ("DEST must be a frame, nil, string, number or cons");
2579 if (wdest
== 0) wdest
= dpyinfo
->root_window
;
2580 to_root
= wdest
== dpyinfo
->root_window
;
2582 for (cons
= values
, size
= 0; CONSP (cons
); cons
= XCDR (cons
), ++size
)
2587 event
.xclient
.message_type
2588 = XInternAtom (dpyinfo
->display
, SDATA (message_type
), False
);
2589 event
.xclient
.display
= dpyinfo
->display
;
2591 /* Some clients (metacity for example) expects sending window to be here
2592 when sending to the root window. */
2593 event
.xclient
.window
= to_root
? FRAME_OUTER_WINDOW (f
) : wdest
;
2596 memset (event
.xclient
.data
.b
, 0, sizeof (event
.xclient
.data
.b
));
2597 x_fill_property_data (dpyinfo
->display
, values
, event
.xclient
.data
.b
,
2598 event
.xclient
.format
);
2600 /* If event mask is 0 the event is sent to the client that created
2601 the destination window. But if we are sending to the root window,
2602 there is no such client. Then we set the event mask to 0xffff. The
2603 event then goes to clients selecting for events on the root window. */
2604 x_catch_errors (dpyinfo
->display
);
2606 int propagate
= to_root
? False
: True
;
2607 unsigned mask
= to_root
? 0xffff : 0;
2608 XSendEvent (dpyinfo
->display
, wdest
, propagate
, mask
, &event
);
2609 XFlush (dpyinfo
->display
);
2611 x_uncatch_errors ();
2619 syms_of_xselect (void)
2621 defsubr (&Sx_get_selection_internal
);
2622 defsubr (&Sx_own_selection_internal
);
2623 defsubr (&Sx_disown_selection_internal
);
2624 defsubr (&Sx_selection_owner_p
);
2625 defsubr (&Sx_selection_exists_p
);
2627 defsubr (&Sx_get_atom_name
);
2628 defsubr (&Sx_send_client_message
);
2629 defsubr (&Sx_register_dnd_atom
);
2631 reading_selection_reply
= Fcons (Qnil
, Qnil
);
2632 staticpro (&reading_selection_reply
);
2633 reading_selection_window
= 0;
2634 reading_which_selection
= 0;
2636 property_change_wait_list
= 0;
2637 prop_location_identifier
= 0;
2638 property_change_reply
= Fcons (Qnil
, Qnil
);
2639 staticpro (&property_change_reply
);
2641 Vselection_alist
= Qnil
;
2642 staticpro (&Vselection_alist
);
2644 DEFVAR_LISP ("selection-converter-alist", &Vselection_converter_alist
,
2645 doc
: /* An alist associating X Windows selection-types with functions.
2646 These functions are called to convert the selection, with three args:
2647 the name of the selection (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');
2648 a desired type to which the selection should be converted;
2649 and the local selection value (whatever was given to `x-own-selection').
2651 The function should return the value to send to the X server
2652 \(typically a string). A return value of nil
2653 means that the conversion could not be done.
2654 A return value which is the symbol `NULL'
2655 means that a side-effect was executed,
2656 and there is no meaningful selection value. */);
2657 Vselection_converter_alist
= Qnil
;
2659 DEFVAR_LISP ("x-lost-selection-functions", &Vx_lost_selection_functions
,
2660 doc
: /* A list of functions to be called when Emacs loses an X selection.
2661 \(This happens when some other X client makes its own selection
2662 or when a Lisp program explicitly clears the selection.)
2663 The functions are called with one argument, the selection type
2664 \(a symbol, typically `PRIMARY', `SECONDARY', or `CLIPBOARD'). */);
2665 Vx_lost_selection_functions
= Qnil
;
2667 DEFVAR_LISP ("x-sent-selection-functions", &Vx_sent_selection_functions
,
2668 doc
: /* A list of functions to be called when Emacs answers a selection request.
2669 The functions are called with four arguments:
2670 - the selection name (typically `PRIMARY', `SECONDARY', or `CLIPBOARD');
2671 - the selection-type which Emacs was asked to convert the
2672 selection into before sending (for example, `STRING' or `LENGTH');
2673 - a flag indicating success or failure for responding to the request.
2674 We might have failed (and declined the request) for any number of reasons,
2675 including being asked for a selection that we no longer own, or being asked
2676 to convert into a type that we don't know about or that is inappropriate.
2677 This hook doesn't let you change the behavior of Emacs's selection replies,
2678 it merely informs you that they have happened. */);
2679 Vx_sent_selection_functions
= Qnil
;
2681 DEFVAR_INT ("x-selection-timeout", &x_selection_timeout
,
2682 doc
: /* Number of milliseconds to wait for a selection reply.
2683 If the selection owner doesn't reply in this time, we give up.
2684 A value of 0 means wait as long as necessary. This is initialized from the
2685 \"*selectionTimeout\" resource. */);
2686 x_selection_timeout
= 0;
2688 /* QPRIMARY is defined in keyboard.c. */
2689 QSECONDARY
= intern_c_string ("SECONDARY"); staticpro (&QSECONDARY
);
2690 QSTRING
= intern_c_string ("STRING"); staticpro (&QSTRING
);
2691 QINTEGER
= intern_c_string ("INTEGER"); staticpro (&QINTEGER
);
2692 QCLIPBOARD
= intern_c_string ("CLIPBOARD"); staticpro (&QCLIPBOARD
);
2693 QTIMESTAMP
= intern_c_string ("TIMESTAMP"); staticpro (&QTIMESTAMP
);
2694 QTEXT
= intern_c_string ("TEXT"); staticpro (&QTEXT
);
2695 QCOMPOUND_TEXT
= intern_c_string ("COMPOUND_TEXT"); staticpro (&QCOMPOUND_TEXT
);
2696 QUTF8_STRING
= intern_c_string ("UTF8_STRING"); staticpro (&QUTF8_STRING
);
2697 QDELETE
= intern_c_string ("DELETE"); staticpro (&QDELETE
);
2698 QMULTIPLE
= intern_c_string ("MULTIPLE"); staticpro (&QMULTIPLE
);
2699 QINCR
= intern_c_string ("INCR"); staticpro (&QINCR
);
2700 QEMACS_TMP
= intern_c_string ("_EMACS_TMP_"); staticpro (&QEMACS_TMP
);
2701 QTARGETS
= intern_c_string ("TARGETS"); staticpro (&QTARGETS
);
2702 QATOM
= intern_c_string ("ATOM"); staticpro (&QATOM
);
2703 QATOM_PAIR
= intern_c_string ("ATOM_PAIR"); staticpro (&QATOM_PAIR
);
2704 QNULL
= intern_c_string ("NULL"); staticpro (&QNULL
);
2705 Qcompound_text_with_extensions
= intern_c_string ("compound-text-with-extensions");
2706 staticpro (&Qcompound_text_with_extensions
);
2708 Qforeign_selection
= intern_c_string ("foreign-selection");
2709 staticpro (&Qforeign_selection
);
2712 /* arch-tag: 7c293b0f-9918-4f69-8ac7-03e142307236
2713 (do not change this comment) */