-;; Common Lisp bindings for GTK+ v2.0
-;; Copyright (C) 1999-2001 Espen S. Johnsen <esj@stud.cs.uit.no>
+;; Common Lisp bindings for GTK+ v2.x
+;; Copyright 1999-2005 Espen S. Johnsen <espen@users.sf.net>
;;
-;; This library is free software; you can redistribute it and/or
-;; modify it under the terms of the GNU Lesser General Public
-;; License as published by the Free Software Foundation; either
-;; version 2 of the License, or (at your option) any later version.
+;; Permission is hereby granted, free of charge, to any person obtaining
+;; a copy of this software and associated documentation files (the
+;; "Software"), to deal in the Software without restriction, including
+;; without limitation the rights to use, copy, modify, merge, publish,
+;; distribute, sublicense, and/or sell copies of the Software, and to
+;; permit persons to whom the Software is furnished to do so, subject to
+;; the following conditions:
;;
-;; This library is distributed in the hope that it will be useful,
-;; but WITHOUT ANY WARRANTY; without even the implied warranty of
-;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-;; Lesser General Public License for more details.
+;; The above copyright notice and this permission notice shall be
+;; included in all copies or substantial portions of the Software.
;;
-;; You should have received a copy of the GNU Lesser General Public
-;; License along with this library; if not, write to the Free Software
-;; Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+;; THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+;; EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+;; MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+;; IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+;; CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+;; TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+;; SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-;; $Id: gtk.lisp,v 1.38 2005-02-27 12:37:01 espen Exp $
+;; $Id: gtk.lisp,v 1.58 2006-02-27 12:26:47 espen Exp $
(in-package "GTK")
(format nil "Gtk+ v~A.~A" major minor)
(format nil "Gtk+ v~A.~A.~A" major minor micro))))
-(defbinding get-default-language () (copy-of pango:language))
+(defun clg-version ()
+ "clg 0.92")
;;;; Initalization
-(defbinding (gtk-init "gtk_parse_args") () nil
+(defbinding (gtk-init "gtk_parse_args") () boolean
"Initializes the library without opening the display."
(nil null)
(nil null))
(defun clg-init (&optional display)
"Initializes the system and starts the event handling"
+ #+sbcl(when (and
+ (find-package "SWANK")
+ (eq (symbol-value (find-symbol "*COMMUNICATION-STYLE*" "SWANK")) :spawn))
+ (error "When running clg in Slime the communication style :spawn can not be used. See the README file and <http://common-lisp.net/project/slime/doc/html/slime_45.html> for more information."))
+
(unless (gdk:display-get-default)
(gdk:gdk-init)
- (gtk-init)
+ (unless (gtk-init)
+ (error "Initialization of GTK+ failed."))
(prog1
(gdk:display-open display)
(add-fd-handler (gdk:display-connection-number) :input #'main-iterate-all)
(defbinding grab-remove () nil
(widget widget))
+(defbinding get-default-language () (copy-of pango:language))
+
;;; About dialog
#+gtk2.6
(progn
- (def-callback-marshal %about-dialog-activate-link-func
- (nil (dialog about-dialog) (link (copy-of string))))
+ (define-callback-marshal %about-dialog-activate-link-callback nil
+ (about-dialog (link string)))
(defbinding about-dialog-set-email-hook (function) nil
- ((callback %about-dialog-activate-link-func) pointer)
+ (%about-dialog-activate-link-callback callback)
((register-callback-function function) unsigned-int)
- ((callback user-data-destroy-func) pointer))
+ (user-data-destroy-callback callback))
(defbinding about-dialog-set-url-hook (function) nil
- ((callback %about-dialog-activate-link-func) pointer)
+ (%about-dialog-activate-link-callback callback)
((register-callback-function function) unsigned-int)
- ((callback user-data-destroy-func) pointer)))
+ (user-data-destroy-callback callback)))
;;; Acccel group
(gclosure gclosure))
(defun accel-group-connect (group accelerator function &optional flags)
- (multiple-value-bind (key modifiers) (accelerator-parse accelerator)
+ (multiple-value-bind (key modifiers) (parse-accelerator accelerator)
(let ((gclosure (make-callback-closure function)))
(%accel-group-connect group key modifiers flags gclosure)
gclosure)))
(etypecase accelerator
(gclosure (%accel-group-disconnect group accelerator))
(string
- (multiple-value-bind (key modifiers) (accelerator-parse accelerator)
+ (multiple-value-bind (key modifiers) (parse-accelerator accelerator)
(%accel-group-disconnect-key group key modifiers)))))
+(defbinding %accel-group-query () (copy-of (vector (inlined accel-group-entry) n))
+ (accel-group accel-group)
+ (key unsigned-int)
+ (modifiers gdk:modifier-type)
+ (n int :out))
+
+(defun accel-group-query (accel-group accelerator)
+ (multiple-value-bind (key modifiers) (parse-accelerator accelerator)
+ (%accel-group-query accel-group key modifiers)))
+
+(defbinding %accel-group-activate () boolean
+ (accel-group accel-group)
+ (acceleratable gobject)
+ (key unsigned-int)
+ (modifiers gdk:modifier-type))
+
+(defun accel-group-activate (accel-group acceleratable accelerator)
+ (multiple-value-bind (key modifiers) (parse-accelerator accelerator)
+ (%accel-group-activate accel-group acceleratable key modifiers)))
+
(defbinding accel-group-lock () nil
(accel-group accel-group))
(defbinding accel-group-unlock () nil
(accel-group accel-group))
+(defbinding accel-group-from-accel-closure () accel-group
+ (closure gclosure))
+
(defbinding %accel-groups-activate () boolean
(object gobject)
(key unsigned-int)
(modifiers gdk:modifier-type))
(defun accel-groups-activate (object accelerator)
- (multiple-value-bind (key modifiers) (accelerator-parse accelerator)
+ (multiple-value-bind (key modifiers) (parse-accelerator accelerator)
(%accel-groups-activate object key modifiers)))
(defbinding accel-groups-from-object () (gslist accel-groups)
(key unsigned-int :out)
(modifiers gdk:modifier-type :out))
-(defun accelerator-parse (accelerator)
+(defgeneric parse-accelerator (accelerator))
+
+(defmethod parse-accelerator ((accelerator string))
(multiple-value-bind (key modifiers) (%accelerator-parse accelerator)
(if (zerop key)
(error "Invalid accelerator: ~A" accelerator)
(values key modifiers))))
+(defmethod parse-accelerator ((accelerator cons))
+ (destructuring-bind (key modifiers) accelerator
+ (values
+ (etypecase key
+ (integer key)
+ (string
+ (or
+ (gdk:keyval-from-name key)
+ (error "Invalid key name: ~A" key)))
+ (character (parse-accelerator key)))
+ modifiers)))
+
+(defmethod parse-accelerator ((key integer))
+ key)
+
+(defmethod parse-accelerator ((key character))
+ (or
+ (gdk:keyval-from-name (string key))
+ (error "Invalid key name: ~A" key)))
+
+
(defbinding accelerator-name () string
(key unsigned-int)
(modifiers gdk:modifier-type))
;;; Acccel label
+(defbinding accel-label-get-accel-width () unsigned-int
+ (accel-label accel-label))
+
(defbinding accel-label-refetch () boolean
(accel-label accel-label))
;;; Accel map
+(defbinding (accel-map-init "_gtk_accel_map_init") () nil)
+
(defbinding %accel-map-add-entry () nil
(path string)
(key unsigned-int)
(modifiers gdk:modifier-type))
(defun accel-map-add-entry (path accelerator)
- (multiple-value-bind (key modifiers) (accelerator-parse accelerator)
+ (multiple-value-bind (key modifiers) (parse-accelerator accelerator)
(%accel-map-add-entry path key modifiers)))
-(defbinding accel-map-lookup-entry () boolean
+(defbinding %accel-map-lookup-entry () boolean
(path string)
- (key pointer)) ;accel-key))
+ ((make-instance 'accel-key) accel-key :return))
+
+(defun accel-map-lookup-entry (path)
+ (multiple-value-bind (found-p accel-key) (%accel-map-lookup-entry path)
+ (when found-p
+ (values
+ (slot-value accel-key 'key)
+ (slot-value accel-key 'modifiers)
+ (slot-value accel-key 'flags)))))
(defbinding %accel-map-change-entry () boolean
(path string)
(replace boolean))
(defun accel-map-change-entry (path accelerator &optional replace)
- (multiple-value-bind (key modifiers) (accelerator-parse accelerator)
+ (multiple-value-bind (key modifiers) (parse-accelerator accelerator)
(%accel-map-change-entry path key modifiers replace)))
(defbinding accel-map-load () nil
(defbinding accel-map-save () nil
(filename pathname))
+(define-callback-marshal %accel-map-foreach-callback nil
+ ((accel-path string) (key unsigned-int)
+ (modifiers gdk:modifier-type) (changed boolean)) :callback-id :first)
+
+(defbinding %accel-map-foreach (callback-id) nil
+ (callback-id unsigned-int)
+ (%accel-map-foreach-callback callback))
+
+(defbinding %accel-map-foreach-unfiltered (callback-id) nil
+ (callback-id unsigned-int)
+ (%accel-map-foreach-callback callback))
+
+(defun accel-map-foreach (function &optional (filter-p t))
+ (with-callback-function (id function)
+ (if filter-p
+ (%accel-map-foreach id)
+ (%accel-map-foreach-unfiltered id))))
+
+(defbinding accel-map-add-filter () nil
+ (filter string))
+
(defbinding accel-map-get () accel-map)
(defbinding accel-map-lock-path () nil
-;;; Accessible
+;;; Accessibility
(defbinding accessible-connect-widget-destroyed () nil
(accessible accessible))
#+gtk2.6
(defbinding (dialog-set-alternative-button-order
- "gtk_dialog_set_alternative_button_order_from_array")
- (dialog new-order)
+ "gtk_dialog_set_alternative_button_order_from_array")
+ (dialog new-order) nil
(dialog dialog)
((length new-order) int)
((map 'vector #'(lambda (response)
new-order) (vector int)))
+#+gtk2.8
+(progn
+ (defbinding %dialog-get-response-for-widget () int
+ (dialog dialog)
+ (widget widget))
+
+ (defun dialog-get-response-for-widget (dialog widget)
+ (dialog-find-response dialog (dialog-get-response-for-widget dialog widget))))
+
+
(defmethod container-add ((dialog dialog) (child widget) &rest args)
(apply #'container-add (dialog-vbox dialog) child args))
;;; Entry Completion
-(def-callback-marshal %entry-completion-match-func
- (boolean entry-completion string (copy-of tree-iter)))
+(define-callback-marshal %entry-completion-match-callback boolean
+ (entry-completion string tree-iter))
(defbinding entry-completion-set-match-func (completion function) nil
(completion entry-completion)
- ((callback %entry-completion-match-func) pointer)
+ (%entry-completion-match-callback callback)
((register-callback-function function) unsigned-int)
- ((callback user-data-destroy-func) pointer))
+ (user-data-destroy-callback callback))
(defbinding entry-completion-complete () nil
(completion entry-completion))
(defbinding file-filter-add-pixbuf-formats () nil
(filter file-filter))
-(def-callback-marshal %file-filter-func (boolean file-filter-info))
+(define-callback-marshal %file-filter-callback boolean (file-filter-info))
(defbinding file-filter-add-custom (filter needed function) nil
(filter file-filter)
(needed file-filter-flags)
- ((callback %file-filter-func) pointer)
+ (%file-filter-callback callback)
((register-callback-function function) unsigned-int)
- ((callback user-data-destroy-func) pointer))
+ (user-data-destroy-callback callback))
(defbinding file-filter-get-needed () file-filter-flags
(filter file-filter))
((or list vector) (make-instance 'image :pixmap source))
(gdk:pixmap (make-instance 'image :pixmap source :mask mask))))
+#+gtk2.8
+(defbinding image-clear () nil
+ (image image))
+
+
;;; Image menu item
;;; Label
+(defmethod shared-initialize ((label label) names &key pattern)
+ (declare (ignore names))
+ (call-next-method)
+ (when pattern
+ (setf (label-pattern label) pattern)))
+
(defbinding label-get-layout-offsets () nil
(label label)
(x int :out)
"Add BUTTON1 to the group which BUTTON2 belongs to."
(%radio-button-set-group button1 (%radio-button-get-group button2)))
+(defun %add-activate-callback (widget signal function object after)
+ (if object
+ (signal-connect widget signal
+ #'(lambda (object)
+ (when (slot-value widget 'active)
+ (funcall function object (slot-value widget 'value))))
+ :object object :after after)
+ (signal-connect widget signal
+ #'(lambda ()
+ (when (slot-value widget 'active)
+ (funcall function (slot-value widget 'value))))
+ :after after)))
+
+(defmethod activate-radio-widget ((button radio-button))
+ (signal-emit button 'clicked))
+
+(defmethod add-activate-callback ((button radio-button) function &key object after)
+ (%add-activate-callback button 'clicked function object after))
+
(defmethod initialize-instance ((button radio-button) &key group)
(prog1
(call-next-method)
;;; Message dialog
-(defmethod initialize-instance ((dialog message-dialog) &rest initargs
- &key (type :info) (buttons :close) ; or :ok?
- flags message parent)
- (remf initargs :parent)
- (setf
- (slot-value dialog 'location)
- (%message-dialog-new parent flags type buttons nil))
- (message-dialog-set-markup dialog message)
- (apply #'call-next-method dialog initargs))
+(defmethod allocate-foreign ((dialog message-dialog) &key (message-type :info)
+ (buttons :close) flags transient-parent)
+ (%message-dialog-new transient-parent flags message-type buttons))
-(defbinding %message-dialog-new () pointer
- (parent (or null window))
- (flags dialog-flags)
- (type message-type)
- (buttons buttons-type)
- (message (or null string)))
+(defmethod shared-initialize ((dialog message-dialog) names
+ &key text #+gtk 2.6 secondary-text)
+ (declare (ignore names))
+ (when text
+ (message-dialog-set-markup dialog text))
+ #+gtk2.6
+ (when secondary-text
+ (message-dialog-format-secondary-markup dialog secondary-text))
+ (call-next-method))
+
-(defbinding %message-dialog-new-with-markup () pointer
+(defbinding %message-dialog-new () pointer
(parent (or null window))
(flags dialog-flags)
(type message-type)
(buttons buttons-type)
- (message string))
+ (nil null))
(defbinding message-dialog-set-markup () nil
(message-dialog message-dialog)
(radio-menu-item radio-menu-item)
(group pointer))
+(defmethod activate-radio-widget ((item radio-menu-item))
+ (menu-item-activate item))
+
(defmethod add-to-radio-group ((item1 radio-menu-item) (item2 radio-menu-item))
"Add ITEM1 to the group which ITEM2 belongs to."
(%radio-menu-item-set-group item1 (%radio-menu-item-get-group item2)))
+(defmethod add-activate-callback ((item radio-menu-item) function &key object after)
+ (%add-activate-callback item 'activate function object after))
+
(defmethod initialize-instance ((item radio-menu-item) &key group)
(prog1
(call-next-method)
(radio-tool-button radio-tool-button)
(group pointer))
+(defmethod activate-radio-widget ((button radio-tool-button))
+ (signal-emit button 'clicked))
+
(defmethod add-to-radio-group ((button1 radio-tool-button) (button2 radio-tool-button))
"Add BUTTON1 to the group which BUTTON2 belongs to."
(%radio-tool-button-set-group button1 (%radio-tool-button-get-group button2)))
-
-(defmethod add-activate-callback ((widget widget) function &key object after)
- (if object
- (signal-connect widget 'clicked
- #'(lambda (object)
- (when (slot-value widget 'active)
- (funcall function object (slot-value widget 'value))))
- :object object :after after)
- (signal-connect widget 'clicked
- #'(lambda ()
- (when (slot-value widget 'active)
- (funcall function (slot-value widget 'value))))
- :after after)))
+(defmethod add-activate-callback ((button radio-tool-button) function &key object after)
+ (%add-activate-callback button 'clicked function object after))
(defmethod initialize-instance ((button radio-tool-button) &key group)
(prog1
(initial-add window #'window-add-accel-group
initargs :accel-group :accel-groups)))
+#-debug-ref-counting
+(defmethod print-object ((window window) stream)
+ (if (and
+ (proxy-valid-p window)
+ (slot-boundp window 'title)
+ (not (zerop (length (window-title window)))))
+ (print-unreadable-object (window stream :type t :identity nil)
+ (format stream "~S at 0x~X"
+ (window-title window) (sap-int (foreign-location window))))
+ (call-next-method)))
(defbinding window-set-wmclass () nil
(window window)
(window window)
(event gdk:key-event))
+#-gtk2.8
(defbinding window-present () nil
(window window))
+#+gtk2.8
+(progn
+ (defbinding %window-present () nil
+ (window window))
+
+ (defbinding %window-present-with-time () nil
+ (window window)
+ (timespamp unsigned-int))
+
+ (defun window-present (window &optional timestamp)
+ (if timestamp
+ (%window-present-with-time window timestamp)
+ (%window-present window))))
+
(defbinding window-iconify () nil
(window window))
(window window)
(left int :out) (top int :out) (rigth int :out) (bottom int :out))
-(defbinding %window-get-icon-list () (glist gdk:pixbuf)
+(defbinding %window-get-icon-list () (glist (copy-of gdk:pixbuf))
(window window))
(defbinding window-get-position () nil
(scrolled-window scrolled-window)
(child widget))
-(defmethod initialize-instance ((window scrolled-window) &rest initargs
- &key policy)
- (if policy
- (apply #'call-next-method window
- :vscrollbar-policy policy :hscrollbar-policy policy initargs)
- (call-next-method)))
+(defmethod shared-initialize ((window scrolled-window) names &key policy)
+ (declare (ignore names))
+ (when policy
+ (setf (slot-value window 'hscrollbar-policy) policy)
+ (setf (slot-value window 'vscrollbar-policy) policy))
+ (call-next-method))
;;; Statusbar
(defbinding notebook-reorder-child (notebook child position) nil
(notebook notebook)
(child widget)
- ((%notebook-position notebook position) int))
+ ((%ensure-notebook-position notebook position) int))
(defbinding notebook-popup-enable () nil
(notebook notebook))
(defbinding notebook-query-tab-label-packing (notebook page) nil
(notebook notebook)
- ((%notebook-child notebook page) widget)
+ ((%ensure-notebook-child notebook page) widget)
(expand boolean :out)
(fill boolean :out)
(pack-type pack-type :out))
(defbinding notebook-set-tab-label-packing
(notebook page expand fill pack-type) nil
(notebook notebook)
- ((%notebook-child notebook page) widget)
+ ((%ensure-notebook-child notebook page) widget)
(expand boolean)
(fill boolean)
(pack-type pack-type))
(top-attach unsigned-int)
(bottom-attach unsigned-int))
-(def-callback-marshal %menu-position-func (nil (menu menu) (x int) (y int) (push-in boolean)))
+(define-callback-marshal %menu-position-callback nil
+ (menu (x int) (y int) (push-in boolean)))
(defbinding %menu-popup () nil
(menu menu)
(parent-menu-shell (or null menu-shell))
(parent-menu-item (or null menu-item))
- (callback-func (or null pointer))
+ (callback (or null callback))
(callback-id unsigned-int)
(button unsigned-int)
(activate-time (unsigned 32)))
(with-callback-function (id callback)
(%menu-popup
menu parent-menu-shell parent-menu-item
- (callback %menu-position-func) id button activate-time))
+ %menu-position-callback id button activate-time))
(%menu-popup
menu parent-menu-shell parent-menu-item nil 0 button activate-time)))
(%menu-set-active menu (%menu-position menu child))
child)
-(defcallback %menu-detach-func (nil (widget widget) (menu menu))
+(define-callback %menu-detach-callback nil ((widget widget) (menu menu))
(funcall (object-data menu 'detach-func) widget menu))
-(defbinding %menu-attach-to-widget () nil
+(defbinding %menu-attach-to-widget (menu widget) nil
(menu menu)
(widget widget)
- ((callback %menu-detach-func) pointer))
+ (%menu-detach-callback callback))
(defun menu-attach-to-widget (menu widget function)
(setf (object-data menu 'detach-func) function)
(location pointer))
(defun stock-lookup (stock-id)
- (let ((location
- (allocate-memory (proxy-instance-size (find-class 'stock-item)))))
- (unwind-protect
- (when (%stock-lookup stock-id location)
- (ensure-proxy-instance 'stock-item (%stock-item-copy location)))
- (deallocate-memory location))))
+ (with-allocated-memory (stock-item (foreign-size (find-class 'stock-item)))
+ (when (%stock-lookup stock-id stock-item)
+ (ensure-proxy-instance 'stock-item (%stock-item-copy stock-item)))))
+#+gtk2.8
+(progn
+ (define-callback-marshal %stock-translate-callback string ((path string)))
+
+ (defbinding (stock-set-translate-function "gtk_stock_set_translate_func")
+ (domain function) nil
+ (domain string)
+ (%stock-translate-callback callback)
+ ((register-callback-function function) unsigned-int)
+ (user-data-destroy-callback callback)))
+
+
;;; Tooltips
(current-widget widget :out))
-;;; Rc
+;;; Resource Files
-(defbinding rc-add-default-file (filename) nil
- ((namestring (truename filename)) string))
+(defbinding rc-get-style () style
+ (widget widget))
+
+(defbinding rc-get-style-by-paths (&key path class-path class) style
+ (path (or null string))
+ (class-path (or null string))
+ (class gtype))
-(defbinding rc-parse (filename) nil
- ((namestring (truename filename)) string))
+(defbinding rc-parse () nil
+ (filename pathname))
(defbinding rc-parse-string () nil
(rc-string string))
-(defbinding rc-reparse-all () nil)
+(defbinding %rc-reparse-all () boolean)
-(defbinding rc-get-style () style
- (widget widget))
+(defbinding %rc-reparse-all-for-settings () boolean
+ (settings settings)
+ (force-load-p boolean))
+
+(defun rc-reparse-all (&optional setting force-load-p)
+ (if setting
+ (%rc-reparse-all-for-settings setting force-load-p)
+ (%rc-reparse-all)))
+
+(defbinding rc-reset-styles () nil
+ (settings settings))
+
+(defbinding rc-add-default-file () nil
+ (filename pathname))
+
+(defbinding rc-get-default-files ()
+ (copy-of (null-terminated-vector (copy-of string))))
+
+(defbinding rc-get-module-dir () string)
+
+(defbinding rc-get-im-module-path () string)
+
+(defbinding rc-get-im-module-file () string)
+
+(defbinding rc-get-theme-dir () string)
+
+
+;;; Settings
+
+(defbinding (settings-get "gtk_settings_get_for_screen")
+ (&optional (screen (gdk:display-get-default-screen))) settings
+ (screen gdk:screen))
+
+
+;;; Plug and Socket
+
+(defbinding socket-add-id () nil
+ (socket socket)
+ (id gdk:native-window))
+
+(defbinding %plug-new () pointer
+ (id gdk:native-window))
+
+(defmethod allocate-foreign ((plug plug) &key id)
+ (%plug-new (or id 0)))
~mdw / clg / blobdiff