Add declarations for builds without X.
[emacs.git] / lisp / term / w32-win.el
blobcd000ea53dbde4a8a5a0e67f7de82bbe369a32fb
1 ;;; w32-win.el --- parse switches controlling interface with W32 window system
3 ;; Copyright (C) 1993, 1994, 2001, 2002, 2003, 2004,
4 ;; 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
6 ;; Author: Kevin Gallo
7 ;; Keywords: terminals
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation, either version 3 of the License, or
14 ;; (at your option) any later version.
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
24 ;;; Commentary:
26 ;; w32-win.el: this file is loaded from ../lisp/startup.el when it recognizes
27 ;; that W32 windows are to be used. Command line switches are parsed and those
28 ;; pertaining to W32 are processed and removed from the command line. The
29 ;; W32 display is opened and hooks are set for popping up the initial window.
31 ;; startup.el will then examine startup files, and eventually call the hooks
32 ;; which create the first window (s).
34 ;;; Code:
37 ;; These are the standard X switches from the Xt Initialize.c file of
38 ;; Release 4.
40 ;; Command line Resource Manager string
42 ;; +rv *reverseVideo
43 ;; +synchronous *synchronous
44 ;; -background *background
45 ;; -bd *borderColor
46 ;; -bg *background
47 ;; -bordercolor *borderColor
48 ;; -borderwidth .borderWidth
49 ;; -bw .borderWidth
50 ;; -display .display
51 ;; -fg *foreground
52 ;; -fn *font
53 ;; -font *font
54 ;; -foreground *foreground
55 ;; -geometry .geometry
56 ;; -i .iconType
57 ;; -itype .iconType
58 ;; -iconic .iconic
59 ;; -name .name
60 ;; -reverse *reverseVideo
61 ;; -rv *reverseVideo
62 ;; -selectionTimeout .selectionTimeout
63 ;; -synchronous *synchronous
64 ;; -xrm
66 ;; An alist of X options and the function which handles them. See
67 ;; ../startup.el.
69 ;; (if (not (eq window-system 'w32))
70 ;; (error "%s: Loading w32-win.el but not compiled for w32" (invocation-name)))
72 (require 'frame)
73 (require 'mouse)
74 (require 'scroll-bar)
75 (require 'faces)
76 (require 'select)
77 (require 'menu-bar)
78 (require 'dnd)
79 (require 'w32-vars)
81 ;; Keep an obsolete alias for w32-focus-frame and w32-select-font in case
82 ;; they are used by code outside Emacs.
83 (define-obsolete-function-alias 'w32-focus-frame 'x-focus-frame "23.1")
84 (define-obsolete-function-alias 'w32-select-font 'x-select-font "23.1")
86 (defvar xlfd-regexp-registry-subnum)
87 (defvar w32-color-map) ;; defined in w32fns.c
89 (declare-function w32-send-sys-command "w32fns.c")
90 (declare-function set-message-beep "w32console.c")
92 ;; Conditional on new-fontset so bootstrapping works on non-GUI compiles
93 (if (fboundp 'new-fontset)
94 (require 'fontset))
96 ;; The following definition is used for debugging scroll bar events.
97 ;(defun w32-handle-scroll-bar-event (event) (interactive "e") (princ event))
99 (defun w32-drag-n-drop-debug (event)
100 "Print the drag-n-drop EVENT in a readable form."
101 (interactive "e")
102 (princ event))
104 (defun w32-drag-n-drop (event)
105 "Edit the files listed in the drag-n-drop EVENT.
106 Switch to a buffer editing the last file dropped."
107 (interactive "e")
108 (save-excursion
109 ;; Make sure the drop target has positive co-ords
110 ;; before setting the selected frame - otherwise it
111 ;; won't work. <skx@tardis.ed.ac.uk>
112 (let* ((window (posn-window (event-start event)))
113 (coords (posn-x-y (event-start event)))
114 (x (car coords))
115 (y (cdr coords)))
116 (if (and (> x 0) (> y 0))
117 (set-frame-selected-window nil window))
118 (mapc (lambda (file-name)
119 (let ((f (subst-char-in-string ?\\ ?/ file-name))
120 (coding (or file-name-coding-system
121 default-file-name-coding-system)))
122 (setq file-name
123 (mapconcat 'url-hexify-string
124 (split-string (encode-coding-string f coding)
125 "/")
126 "/")))
127 (dnd-handle-one-url window 'private
128 (concat "file:" file-name)))
129 (car (cdr (cdr event)))))
130 (raise-frame)))
132 (defun w32-drag-n-drop-other-frame (event)
133 "Edit the files listed in the drag-n-drop EVENT, in other frames.
134 May create new frames, or reuse existing ones. The frame editing
135 the last file dropped is selected."
136 (interactive "e")
137 (mapcar 'find-file-other-frame (car (cdr (cdr event)))))
139 ;; Bind the drag-n-drop event.
140 (global-set-key [drag-n-drop] 'w32-drag-n-drop)
141 (global-set-key [C-drag-n-drop] 'w32-drag-n-drop-other-frame)
143 ;; Keyboard layout/language change events
144 ;; For now ignore language-change events; in the future
145 ;; we should switch the Emacs Input Method to match the
146 ;; new layout/language selected by the user.
147 (global-set-key [language-change] 'ignore)
149 (defvar x-resource-name)
150 (defvar x-colors)
153 (defun xw-defined-colors (&optional frame)
154 "Internal function called by `defined-colors', which see."
155 (or frame (setq frame (selected-frame)))
156 (let ((defined-colors nil))
157 (dolist (this-color (or (mapcar 'car w32-color-map) x-colors))
158 (and (color-supported-p this-color frame t)
159 (setq defined-colors (cons this-color defined-colors))))
160 defined-colors))
162 ;;;; Function keys
164 ;;; make f10 activate the real menubar rather than the mini-buffer menu
165 ;;; navigation feature.
166 (defun w32-menu-bar-open (&optional frame)
167 "Start key navigation of the menu bar in FRAME.
169 This initially activates the first menu-bar item, and you can then navigate
170 with the arrow keys, select a menu entry with the Return key or cancel with
171 the Escape key. If FRAME has no menu bar, this function does nothing.
173 If FRAME is nil or not given, use the selected frame.
174 If FRAME does not have the menu bar enabled, display a text menu using
175 `tmm-menubar'."
176 (interactive "i")
177 (if menu-bar-mode
178 (w32-send-sys-command ?\xf100 frame)
179 (with-selected-frame (or frame (selected-frame))
180 (tmm-menubar))))
183 ;; W32 systems have different fonts than commonly found on X, so
184 ;; we define our own standard fontset here.
185 (defvar w32-standard-fontset-spec
186 "-*-Courier New-normal-r-*-*-13-*-*-*-c-*-fontset-standard"
187 "String of fontset spec of the standard fontset.
188 This defines a fontset consisting of the Courier New variations for
189 European languages which are distributed with Windows as
190 \"Multilanguage Support\".
192 See the documentation of `create-fontset-from-fontset-spec' for the format.")
194 (defun x-win-suspend-error ()
195 "Report an error when a suspend is attempted."
196 (error "Suspending an Emacs running under W32 makes no sense"))
198 (defvar image-library-alist)
200 ;;; Set default known names for image libraries
201 (setq image-library-alist
202 '((xpm "libxpm.dll" "xpm4.dll" "libXpm-nox4.dll")
203 (png "libpng12d.dll" "libpng12.dll" "libpng.dll"
204 ;; these are libpng 1.2.8 from GTK+
205 "libpng13d.dll" "libpng13.dll")
206 (jpeg "jpeg62.dll" "libjpeg.dll" "jpeg-62.dll" "jpeg.dll")
207 (tiff "libtiff3.dll" "libtiff.dll")
208 (gif "giflib4.dll" "libungif4.dll" "libungif.dll")
209 (svg "librsvg-2-2.dll")
210 (gdk-pixbuf "libgdk_pixbuf-2.0-0.dll")
211 (glib "libglib-2.0-0.dll")))
213 ;;; multi-tty support
214 (defvar w32-initialized nil
215 "Non-nil if the w32 window system has been initialized.")
217 (declare-function x-open-connection "w32fns.c"
218 (display &optional xrm-string must-succeed))
220 (declare-function setup-default-fontset "fontset" ())
221 (declare-function set-fontset-font "fontset.c"
222 (name target font-spec &optional frame add))
223 (declare-function setup-default-fontset "fontset" ())
224 (declare-function create-fontset-from-fontset-spec "fontset"
225 (fontset-spec &optional style-variant noerror))
226 (declare-function create-fontset-from-x-resource "fontset" ())
227 (declare-function x-get-resource "frame.c"
228 (attribute class &optional component subclass))
229 (declare-function x-handle-args "common-win" (args))
230 (declare-function x-parse-geometry "frame.c" (string))
231 (defvar x-command-line-resources)
233 (defun w32-initialize-window-system ()
234 "Initialize Emacs for W32 GUI frames."
236 ;; Do the actual Windows setup here; the above code just defines
237 ;; functions and variables that we use now.
239 (setq command-line-args (x-handle-args command-line-args))
241 ;; Make sure we have a valid resource name.
242 (or (stringp x-resource-name)
243 (setq x-resource-name
244 ;; Change any . or * characters in x-resource-name to hyphens,
245 ;; so as not to choke when we use it in X resource queries.
246 (replace-regexp-in-string "[.*]" "-" (invocation-name))))
248 (x-open-connection "" x-command-line-resources
249 ;; Exit with a fatal error if this fails and we
250 ;; are the initial display
251 (eq initial-window-system 'w32))
253 ;; Setup the default fontset.
254 (setup-default-fontset)
256 ;; Enable Japanese fonts on Windows to be used by default.
257 (set-fontset-font t (make-char 'katakana-jisx0201)
258 '("*" . "JISX0208-SJIS"))
259 (set-fontset-font t (make-char 'latin-jisx0201)
260 '("*" . "JISX0208-SJIS"))
261 (set-fontset-font t (make-char 'japanese-jisx0208)
262 '("*" . "JISX0208-SJIS"))
263 (set-fontset-font t (make-char 'japanese-jisx0208-1978)
264 '("*" . "JISX0208-SJIS"))
266 ;; Create the standard fontset.
267 (create-fontset-from-fontset-spec w32-standard-fontset-spec t)
268 ;; Create fontset specified in X resources "Fontset-N" (N is 0, 1,...).
269 (create-fontset-from-x-resource)
271 ;; Apply a geometry resource to the initial frame. Put it at the end
272 ;; of the alist, so that anything specified on the command line takes
273 ;; precedence.
274 (let* ((res-geometry (x-get-resource "geometry" "Geometry"))
275 parsed)
276 (if res-geometry
277 (progn
278 (setq parsed (x-parse-geometry res-geometry))
279 ;; If the resource specifies a position,
280 ;; call the position and size "user-specified".
281 (if (or (assq 'top parsed) (assq 'left parsed))
282 (setq parsed (cons '(user-position . t)
283 (cons '(user-size . t) parsed))))
284 ;; All geometry parms apply to the initial frame.
285 (setq initial-frame-alist (append initial-frame-alist parsed))
286 ;; The size parms apply to all frames.
287 (if (and (assq 'height parsed)
288 (not (assq 'height default-frame-alist)))
289 (setq default-frame-alist
290 (cons (cons 'height (cdr (assq 'height parsed)))
291 default-frame-alist))
292 (if (and (assq 'width parsed)
293 (not (assq 'width default-frame-alist)))
294 (setq default-frame-alist
295 (cons (cons 'width (cdr (assq 'width parsed)))
296 default-frame-alist)))))))
298 ;; Check the reverseVideo resource.
299 (let ((case-fold-search t))
300 (let ((rv (x-get-resource "reverseVideo" "ReverseVideo")))
301 (if (and rv (string-match "^\\(true\\|yes\\|on\\)$" rv))
302 (setq default-frame-alist
303 (cons '(reverse . t) default-frame-alist)))))
305 ;; Don't let Emacs suspend under w32 gui
306 (add-hook 'suspend-hook 'x-win-suspend-error)
308 ;; Turn off window-splitting optimization; w32 is usually fast enough
309 ;; that this is only annoying.
310 (setq split-window-keep-point t)
312 ;; Turn on support for mouse wheels
313 (mouse-wheel-mode 1)
315 ;; W32 expects the menu bar cut and paste commands to use the clipboard.
316 (menu-bar-enable-clipboard)
318 ;; Don't show the frame name; that's redundant.
319 (setq-default mode-line-frame-identification " ")
321 ;; Set to a system sound if you want a fancy bell.
322 (set-message-beep 'ok)
323 (setq w32-initialized t))
325 (add-to-list 'handle-args-function-alist '(w32 . x-handle-args))
326 (add-to-list 'frame-creation-function-alist '(w32 . x-create-frame-with-faces))
327 (add-to-list 'window-system-initialization-alist '(w32 . w32-initialize-window-system))
329 (provide 'w32-win)
331 ;; arch-tag: 69fb1701-28c2-4890-b351-3d1fe4b4f166
332 ;;; w32-win.el ends here