GNU Emacs Lisp Reference Manual - ローカルキーマップとグローバルキーマップ

Go to the first, previous, next, last section, table of contents.

ローカルキーマップとグローバルキーマップ

グローバルキーマップは、 (カレントなバッファによらない) single-character キーの意味を定義します。変数 global-map がこのキーマップを持ちます。

各バッファは、別にキーマップ(そのローカルキーマップ)を持つことがあります。これは、 (そのモードにおいて再定義され、すでにあるものの上に置かれる) single- character キーの定義を持ちます。各バッファは、(ある時点において)どのローカルキーマップがインストールされているかを記録します。 "(キーが入力された時)どのコマンドを実行するか" を決めるのに、ローカルキーマップとグローバルキーマップの両方が用いられます。

同じメジャーモードを用いる(各)バッファは(通常) 同じキーマップを用いるため、キーマップはあたかも(その)モードにローカルであるかのように思われるかもしれませんが、(訳注：実際は)そうではありません。 Lisp モード、C モード、及びその他のメジャーモードで用いられるローカルキーマップは、それが用いられない時も (常に)存在しています。それらは lisp-mode-map, c-mode-map という変数の値になっています。あまり頻繁に用いられないメジャーモードでは、そのローカルキーマップは(しばしば)そのセッションでそのモードを最初に用いる時構成されるようになっています。 (後で)このモードを用いるバッファが作られると、それらは(全て) この同じキーマップを用います。標準のキーマップのリストは補足を参照して下さい。

ミニバッファに対してもローカルキーマップは存在します。それらは様々な completion や exit のコマンドを持っています。

minibuffer-local-map は(completion を行なわない)通常の入力に用います。
minibuffer-local-ns-map は、(SPC が RET のように exit する点を除いて)同じものです。これは(主に) Mocklisp とのコンパチビリティーのために用います。
minibuffer-local-completion-map は permissive completion のためのものです。
minibuffer-local-must-match-map は strict completion と cautious completion のためのものです。
repeat-complex-command-map は C-x ESC で用いるためのものです。

Function: current-local-map

この関数は、(カレントバッファの)ローカルキーマップを返します。存在しない場合、nil を返します。

  (current-local-map)
  => (keymap
       (27 keymap
         (83 . center-paragraph)
         (115 . center-line))
       (9 . tab-to-tab-stop))

Function: current-global-map

この関数は、カレントのグローバルキーマップを返します。

  (current-global-map)
  => [set-mark-command beginning-of-line ... delete-backward-char]

Function: use-global-map keymap

この関数は、 keymap をカレントなグローバルキーマップにします。 keymap はフルキーマップ (長さ 128 のベクトル) でなくてはいけません。 nil を返します。

グローバルキーマップを変更することは、(非常に)異常なことです (少数の標準モードがこれを行ないます)。

Function: use-local-map keymap

この関数は、 keymap を(新しく)カレントなローカルキーマップにします。 keymap が nil の場合、(訳注：カレントな) ローカルキーマップは存在しなくなります。 nil を返します。ほとんどのメジャーモードはこの関数を用います。

Function: key-binding keys

この関数は、 (カレントなキーマップでの) keys の定義を返します。キーの各文字に対し、まず(最初に)ローカルマップを見てローカルマップが定義を持たない場合、(次に)グローバルマップを見ます。 (これらのキーマップにおいて) keys が未定義の場合、nil を返します。

keys が(キーシーケンスを表わす)ストリングでない場合、エラーになります。

  (key-binding "\C-x\C-f")
  => find-file

Function: local-key-binding keys

この関数は、カレントなローカルキーマップ(のみ)での、 keys に対する定義を返します。

Function: global-key-binding keys

この関数は、カレントなグローバルキーマップ(のみ)での、コマンド keys に対する定義を返します。

Function: where-is-internal command &optional keymap firstonly

この関数は、 keymap とグローバルキーマップで(今現在) command を起動するキーシーケンスのリストを返します。 keymap が与えられない場合、これはグローバルキーマップ(のみ)でキーの検索を行ないます。

firstonly が non-nil の場合、 (可能な)キーシーケンス(の全て)を示すリストではなく、見つかった最初のキーシーケンスを示すストリングを返します。この関数は where-is (<未定義>[GNU Emacs User Manual]、ページ <未定義> 参照)で用いられます。

  (where-is-internal 'forward-char)
  => ("^F")

Go to the first, previous, next, last section, table of contents.