procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

(Windows Keyboard): Add descriptions of w32-register-hot-key

Browse source 
and w32-unregister-hot-key.
This commit is contained in:
Juanma Barranquero 2008-05-29 08:17:20 +00:00
parent 58d6a142ec
commit 71ce5fd0c9
2 changed files with 35 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
doc/emacs/ChangeLog
View file

@ -1,3 +1,8 @@
2008-05-29 Drew Adams <drew.adams@oracle.com>
* msdog.texi (Windows Keyboard): Add descriptions of
w32-register-hot-key and w32-unregister-hot-key.
2008-05-21 Tom Tromey <tromey@redhat.com>
* custom.texi (Directory Variables): Grammar fix. Link to Safe File
@ -10,8 +15,7 @@
2008-05-16 Eric S. Raymond <esr@snark.thyrsus.com>
* vc2-xtra.texi: Mofify an example so it reflects what vc.el
now does.
* vc2-xtra.texi: Modify an example so it reflects what vc.el now does.
2008-05-15 Eric S. Raymond <esr@snark.thyrsus.com>
@ -111,8 +115,8 @@
the default behavior with Transient Mark mode off.
(Position Info): Fix typo.
* display.texi (Standard Faces): Reference the Mark node. Remove
discussion of the region face, which is discussed there.
* display.texi (Standard Faces): Reference the Mark node.
Remove discussion of the region face, which is discussed there.
* emacs.texi (Top): Update node listings.

27
doc/emacs/msdog.texi
View file

@ -403,6 +403,33 @@ Windows-specific variables in this category.
key. If you wish it to produce the @code{Alt} modifier instead, set
the variable @code{w32-alt-is-meta} to a @code{nil} value.
@findex w32-register-hot-key
@findex w32-unregister-hot-key
Although the @key{ALT} key is mapped by default to the Emacs
@key{META} key, MS Windows preempts its use by Emacs for certain key
combinations, such as @kbd{Alt-@key{TAB}}. You can use function
@code{w32-register-hot-key} to allow a key sequence to be seen by Emacs
instead of being grabbed by Windows. This registers the key sequence as
a Windows hot key.
The argument to @code{w32-register-hot-key} must be a one element key
definition in vector form that would be acceptable to `define-key'. The
@code{meta} modifier is interpreted as @key{ALT} if `w32-alt-is-meta' is
@code{t}, and @code{hyper} is always interpreted as the Windows modifier
keys. The return value is the hotkey-id if registered, otherwise
@code{nil}.
@kindex M-TAB @r{(MS-Windows)}
@cindex @kbd{M-@key{TAB}} vs @kbd{Alt-@key{TAB}} (MS-Windows)
@cindex @kbd{Alt-@key{TAB}} vs @kbd{M-@key{TAB}} (MS-Windows)
For example, @code{(w32-register-hot-key [M-tab])} lets you use
@kbd{M-TAB} normally in Emacs. This is effective at all levels, so, for
instance, you can use @kbd{M-TAB} at top level to complete the word or
symbol at point, and you can use it during incremental search to
complete the current search string against previously sought strings.
The function @code{w32-unregister-hot-key} reverses the effect of
@code{w32-register-hot-key}.
@vindex w32-capslock-is-shiftlock
By default, the @key{CapsLock} key only affects normal character
keys (it converts lower-case characters to their upper-case