df2bebd8a36dd277559a83ada98f8ce3eac7a5cc
[clg] / gtk / gtkselection.lisp
1 ;; Common Lisp bindings for GTK+ v2.x
2 ;; Copyright 2005-2006 Espen S. Johnsen <espen@users.sf.net>
3 ;;
4 ;; Permission is hereby granted, free of charge, to any person obtaining
5 ;; a copy of this software and associated documentation files (the
6 ;; "Software"), to deal in the Software without restriction, including
7 ;; without limitation the rights to use, copy, modify, merge, publish,
8 ;; distribute, sublicense, and/or sell copies of the Software, and to
9 ;; permit persons to whom the Software is furnished to do so, subject to
10 ;; the following conditions:
11 ;;
12 ;; The above copyright notice and this permission notice shall be
13 ;; included in all copies or substantial portions of the Software.
14 ;;
15 ;; THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16 ;; EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17 ;; MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
18 ;; IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
19 ;; CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
20 ;; TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
21 ;; SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
22
23 ;; $Id: gtkselection.lisp,v 1.14 2008-01-02 16:01:17 espen Exp $
24
25
26 (in-package "GTK")
27
28
29 ;;;; Selection
30
31 (defbinding %target-list-ref () pointer
32 (location pointer))
33
34 (defbinding %target-list-unref () nil
35 (location pointer))
36
37 (defbinding %target-list-new () pointer
38 (targets (vector (inlined target-entry)))
39 ((length targets) int))
40
41 (defmethod allocate-foreign ((target-list target-list) &key targets)
42 (%target-list-new targets))
43
44 (defbinding target-list-add (target-list target &optional flags info) nil
45 (target-list target-list)
46 ((gdk:atom-intern target) gdk:atom)
47 (flags target-flags)
48 ((or info 0) unsigned-int))
49
50 (defbinding target-list-add-table (target-list targets) nil
51 (target-list target-list)
52 ((etypecase targets
53 ((or vector list) targets)
54 (target-entry (vector targets)))
55 (vector (inlined target-entry)))
56 ((etypecase targets
57 ((or vector list) (length targets))
58 (target-entry 1))
59 int))
60
61 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
62 (progn
63 (defbinding target-list-add-text-targets (target-list &optional info writable-p) nil
64 (target-list target-list)
65 ((or info 0) unsigned-int)
66 (writable-p boolean))
67
68 (defbinding target-list-add-image-targets (target-list &optional info writable-p) nil
69 (target-list target-list)
70 ((or info 0) unsigned-int)
71 (writable-p boolean))
72
73 (defbinding target-list-add-uri-targets (target-list &optional info writable-p) nil
74 (target-list target-list)
75 ((or info 0) unsigned-int)
76 (writable-p boolean)))
77
78 (defbinding target-list-remove (target-list target) nil
79 (target-list target-list)
80 ((gdk:atom-intern target) gdk:atom))
81
82 (defbinding target-list-find (target-list target) boolean
83 (target-list target-list)
84 ((gdk:atom-intern target) gdk:atom)
85 (info unsigned-int :out))
86
87 (defbinding target-table-new-from-list () (vector (inlined target-entry) n-targets)
88 (target-list target-list)
89 (n-targets int :out))
90
91 (defun ensure-target-table (targets)
92 (etypecase targets
93 (target-list (target-table-new-from-list targets))
94 ((or vector list) targets)))
95
96 (defbinding (selection-set-owner "gtk_selection_owner_set_for_display")
97 (widget selection time &optional (display (gdk:display-get-default)))
98 boolean
99 (display gdk:display)
100 (widget widget)
101 ((gdk:atom-intern selection) gdk:atom)
102 (time (unsigned 32)))
103
104 (defbinding selection-add-target (widget selection target info) nil
105 (widget widget)
106 ((gdk:atom-intern selection) gdk:atom)
107 ((gdk:atom-intern target) gdk:atom)
108 (info unsigned-int))
109
110 (defbinding selection-add-targets (widget selection targets) nil
111 (widget widget)
112 ((gdk:atom-intern selection) gdk:atom)
113 ((etypecase targets
114 ((or vector list) targets)
115 (target-entry (vector targets)))
116 (vector (inlined target-entry)))
117 ((etypecase targets
118 ((or vector list) (length targets))
119 (target-entry 1))
120 int))
121
122 (defbinding selection-clear-targets (widget selection) nil
123 (widget widget)
124 ((gdk:atom-intern selection) gdk:atom))
125
126 (defbinding selection-convert (widget selection target time) boolean
127 (widget widget)
128 ((gdk:atom-intern selection) gdk:atom)
129 ((gdk:atom-intern target) gdk:atom)
130 (time unsigned-int))
131
132 (defbinding selection-data-set (selection-data type format data length) boolean
133 (selection-data selection-data)
134 ((gdk:atom-intern type) gdk:atom)
135 (format int)
136 (data pointer)
137 (length int))
138
139 (defbinding selection-data-set-text () boolean
140 (selection-data selection-data)
141 (text string)
142 (-1 integer))
143
144 (defbinding selection-data-get-text () string
145 (selection-data selection-data))
146
147 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
148 (progn
149 (defbinding selection-data-set-pixbuf () boolean
150 (selection-data selection-data)
151 (puxbuf gdk:pixbuf))
152
153 (defbinding selection-data-get-pixbuf () gdk:pixbuf
154 (selection-data selection-data))
155
156 (defbinding selection-data-set-uris () boolean
157 (selection-data selection-data)
158 (uris (null-terminated-vector string)))
159
160 (defbinding selection-data-get-uris () (null-terminated-vector string)
161 (selection-data selection-data)))
162
163 (defbinding %selection-data-get-targets () boolean
164 (selection-data selection-data)
165 (targets (vector gdk:atom n-targets) :out)
166 (n-targets int :out))
167
168 (defun selection-data-get-targets (selection-data)
169 (multiple-value-bind (valid-p targets)
170 (%selection-data-get-targets selection-data)
171 (when valid-p
172 (map-into targets #'gdk:atom-name targets))))
173
174 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
175 (defbinding selection-data-targets-include-image-p (selection-data &optional writable-p) boolean
176 (selection-data selection-data)
177 (writable-p boolean))
178
179 (defbinding selection-data-targets-include-text-p () boolean
180 (selection-data selection-data))
181
182 (defbinding selection-remove-all () boolean
183 (widget widget))
184
185
186 ;;; Clipboard -- untestet
187
188 (defbinding (clipboard-get "gtk_clipboard_get_for_display")
189 (selection &optional (display (gdk:display-get-default))) clipboard
190 (display gdk:display)
191 ((gdk:atom-intern selection) gdk:atom))
192
193 (define-callback %clipboard-get-callback nil
194 ((clipboard pointer) (selection-data selection-data)
195 (info unsigned-int) (callback-ids unsigned-int))
196 (declare (ignore clipboard))
197 (funcall (car (find-user-data callback-ids)) selection-data info))
198
199 (define-callback %clipboard-clear-callback nil
200 ((clipboard pointer) (callback-ids unsigned-int))
201 (declare (ignore clipboard))
202 (funcall (cdr (find-user-data callback-ids))))
203
204 ;; Deprecated, use clipboard-set-contents
205 (defbinding clipboard-set-with-data (clipboard targets get-func clear-func) boolean
206 (clipboard clipboard)
207 (targets (vector (inlined target-entry)))
208 ((length targets) unsigned-int)
209 (%clipboard-get-callback callback)
210 (%clipboard-clear-callback callback)
211 ((register-user-data (cons get-func clear-func)) unsigned-int))
212
213 (defun clipboard-set-contents (clipboard targets get-func &optional clear-func)
214 (clipboard-set-with-data clipboard (ensure-target-table targets)
215 get-func (or clear-func #'(lambda ()))))
216
217 (defbinding clipboard-clear () nil
218 (clipboard clipboard))
219
220 (defbinding clipboard-set-text () nil
221 (clipboard clipboard)
222 (text string)
223 ((length text) int))
224
225 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
226 (defbinding clipboard-set-image () nil
227 (clipboard clipboard)
228 (pixbuf gdk:pixbuf))
229
230 (defgeneric clipboard-set (clipboard object))
231
232 (defmethod clipboard-set ((clipboard clipboard) (text string))
233 (clipboard-set-text clipboard text))
234
235 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
236 (defmethod clipboard-set ((clipboard clipboard) (image gdk:pixbuf))
237 (clipboard-set-image clipboard image))
238
239 (define-callback-marshal %clipboard-receive-callback nil
240 ((:ignore clipboard) selection-data))
241
242 (defbinding clipboard-request-contents (clipboard target callback) nil
243 (clipboard clipboard)
244 ((gdk:atom-intern target) gdk:atom)
245 (%clipboard-receive-callback callback)
246 ((register-callback-function callback) unsigned-int))
247
248 (define-callback-marshal %clipboard-text-receive-callback nil
249 ((:ignore clipboard) (text string)))
250
251
252 (defbinding clipboard-request-text (clipboard callback) nil
253 (clipboard clipboard)
254 (%clipboard-text-receive-callback callback)
255 ((register-callback-function callback) unsigned-int))
256
257 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
258 (progn
259 (define-callback-marshal %clipboard-image-receive-callback nil
260 ((:ignore clipboard) (image gdk:pixbuf)))
261
262 (defbinding clipboard-request-image (clipboard callback) nil
263 (clipboard clipboard)
264 (%clipboard-image-receive-callback callback)
265 ((register-callback-function callback) unsigned-int)))
266
267
268 (define-callback %clipboard-targets-receive-callback nil
269 ((clipboard pointer) (atoms (vector gdk:atom n-atoms))
270 (n-atoms unsigned-int) (callback-id unsigned-int))
271 (declare (ignore clipboard))
272 (funcall (find-user-data callback-id) (map-into atoms #'gdk:atom-name atoms)))
273
274 (defbinding clipboard-request-targets (clipboard callback) nil
275 (clipboard clipboard)
276 (%clipboard-targets-receive-callback callback)
277 ((register-callback-function callback) unsigned-int))
278
279 (defbinding clipboard-wait-for-contents (clipboard target) selection-data
280 (clipboard clipboard)
281 ((gdk:atom-intern target) gdk:atom))
282
283 (defbinding clipboard-wait-for-text () string
284 (clipboard clipboard))
285
286 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
287 (defbinding clipboard-wait-for-image () (referenced gdk:pixbuf)
288 (clipboard clipboard))
289
290 (defbinding clipboard-wait-is-text-available-p () boolean
291 (clipboard clipboard))
292
293 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
294 (defbinding clipboard-wait-is-image-available-p () boolean
295 (clipboard clipboard))
296
297 (defbinding %clipboard-wait-for-targets () boolean
298 (clipboard clipboard)
299 (targets (vector gdk:atom n-targets) :out)
300 (n-targets unsigned-int :out))
301
302 (defun clipboard-wait-for-targets (clipboard)
303 (multiple-value-bind (valid-p targets)
304 (%clipboard-wait-for-targets clipboard)
305 (when valid-p
306 (map-into targets #'gdk:atom-name targets))))
307
308 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
309 (defbinding clipboard-wait-is-target-available-p (clipboard target) boolean
310 (clipboard clipboard)
311 ((gdk:atom-intern target) gdk:atom))
312
313 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
314 (defbinding clipboard-set-can-store (clipboard targets) nil
315 (clipboard clipboard)
316 ((map 'vector #'gdk:atom-intern targets) (vector gdk:atom))
317 ((length targets) int))
318
319 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
320 (defbinding clipboard-store () nil
321 (clipboard clipboard))
322
323
324 ;;;; Drag and Drop
325
326 (defbinding drag-dest-set (widget flags targets actions) nil
327 (widget widget)
328 (flags dest-defaults)
329 ((etypecase targets
330 ((or vector list) targets)
331 (target-entry (vector targets)))
332 (vector (inlined target-entry)))
333 ((etypecase targets
334 ((or vector list) (length targets))
335 (target-entry 1))
336 int)
337 (actions gdk:drag-action))
338
339 (defbinding drag-dest-set-proxy () nil
340 (widget widget)
341 (window gdk:window)
342 (protocol gdk:drag-protocol)
343 (use-coordinates-p boolean))
344
345 (defbinding drag-dest-unset () nil
346 (widget widget))
347
348 (defbinding drag-dest-find-target () gdk:atom
349 (widget widget)
350 (context gdk:drag-context)
351 (targets target-list))
352
353 (defbinding drag-dest-get-target-list () target-list
354 (widget widget))
355
356 (defbinding drag-dest-set-target-list () nil
357 (widget widget)
358 (targets target-list))
359
360 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
361 (progn
362 (defbinding drag-dest-add-text-targets () nil
363 (widget widget))
364
365 (defbinding drag-dest-add-image-targets () nil
366 (widget widget))
367
368 (defbinding drag-dest-add-uri-targets () nil
369 (widget widget)))
370
371 (defbinding drag-finish () nil
372 (context gdk:drag-context)
373 (success boolean)
374 (delete boolean)
375 (time unsigned-int))
376
377 (defbinding drag-get-data () nil
378 (widget widget)
379 (context gdk:drag-context)
380 (target gdk:atom)
381 (time unsigned-int))
382
383 (defbinding drag-get-source-widget () widget
384 (context gdk:drag-context))
385
386 (defbinding drag-highlight () nil
387 (widget widget))
388
389 (defbinding drag-unhighlight () nil
390 (widget widget))
391
392 (defbinding drag-begin () gdk:drag-context
393 (widget widget)
394 (targets target-list)
395 (actions gdk:drag-action)
396 (button int)
397 (event gdk:event))
398
399 (defbinding %drag-set-icon-widget () nil
400 (context gdk:drag-context)
401 (widget widget)
402 (hot-x int)
403 (hot-y int))
404
405 (defbinding %drag-set-icon-pixmap () nil
406 (context gdk:drag-context)
407 (pixmap gdk:pixmap)
408 (mask gdk:bitmap)
409 (hot-x int)
410 (hot-y int))
411
412 (defbinding %drag-set-icon-pixbuf () nil
413 (context gdk:drag-context)
414 (pixbuf gdk:pixbuf)
415 (hot-x int)
416 (hot-y int))
417
418 (defbinding %drag-set-icon-stock () nil
419 (context gdk:drag-context)
420 (stock-id string)
421 (hot-x int)
422 (hot-y int))
423
424 (defbinding %drag-set-icon-default () nil
425 (context gdk:drag-context))
426
427 (defun drag-set-icon (context icon &optional (hot-x 0) (hot-y 0))
428 (etypecase icon
429 (widget (%drag-set-icon-widget context icon hot-x hot-y))
430 (gdk:pixbuf (%drag-set-icon-pixbuf context icon hot-x hot-y))
431 (string (%drag-set-icon-stock context icon hot-x hot-y))
432 (vector (multiple-value-bind (pixmap mask) (gdk:pixmap-create icon)
433 (%drag-set-icon-pixmap context pixmap mask hot-x hot-y)))
434 (pathname (let ((pixbuf (gdk:pixbuf-load icon)))
435 (%drag-set-icon-pixbuf context pixbuf hot-x hot-y)))
436 (null (%drag-set-icon-default context))))
437
438 (defbinding drag-check-threshold-p () boolean
439 (widget widget)
440 (start-x int)
441 (start-y int)
442 (current-x int)
443 (current-y int))
444
445 (defbinding drag-source-set (widget start-button-mask targets actions) nil
446 (widget widget)
447 (start-button-mask gdk:modifier-type)
448 ((etypecase targets
449 ((or vector list) targets)
450 (target-entry (vector targets)))
451 (vector (inlined target-entry)))
452 ((etypecase targets
453 ((or vector list) (length targets))
454 (target-entry 1))
455 int)
456 (actions gdk:drag-action))
457
458 (defbinding %drag-source-set-icon-pixbuf () nil
459 (widget widget)
460 (pixbuf gdk:pixbuf))
461
462 (defbinding %drag-source-set-icon-stock () nil
463 (widget widget)
464 (pixbuf gdk:pixbuf))
465
466 (defun drag-source-set-icon (widget icon)
467 (etypecase icon
468 (gdk:pixbuf (%drag-source-set-icon-pixbuf widget icon))
469 (string (%drag-source-set-icon-stock widget icon))
470 ; (vector )
471 (pathname (let ((pixbuf (gdk:pixbuf-load icon)))
472 (%drag-source-set-icon-pixbuf widget pixbuf)))))
473
474 (defbinding drag-source-unset () nil
475 (widget widget))
476
477 (defbinding drag-source-set-target-list () nil
478 (widget widget)
479 (targets (or null target-list)))
480
481 (defbinding drag-source-get-target-list () target-list
482 (widget widget))
483
484 #?(pkg-exists-p "gtk+-2.0" :atleast-version "2.6.0")
485 (progn
486 (defbinding drag-source-add-text-targets () nil
487 (widget widget))
488
489 (defbinding drag-source-add-image-targets () nil
490 (widget widget))
491
492 (defbinding drag-source-add-uri-targets () nil
493 (widget widget)))