Appendix H 標準的なフック

以下はEmacsで適切なタイミングで呼び出す関数を提供するためのいくつかのフック関数のリストです。

これらの変数のほとんどは‘-hook’で終わる名前をもちます。これらはノーマルフック(normal hooks)と呼ばれておりrun-hooksにより実行されます。そのようなフックの値は関数のリストです。これらの関数は引数なしで呼び出されて値は完全に無視されます。そのようなフック上に新たに関数を配置するためにはadd-hookを呼び出す方法を推奨します。フック使用についての詳細はHooksを参照してください。

‘-functions’で終わる名前の変数は通常はアブノーマルフック(abnormal hooks)です(古いコードの中には非推奨の‘-hooks’サフィクスを使用するものもある)。これらの値は関数のリストですが関数は特殊な方法で呼び出されます(引数を渡されたりリターン値が使用される)。‘-function’で終わる名前の変数は値として単一の関数をもちます。

以下のリストはすべてを網羅したリストではなく、より一般的なフックだけをカバーしています。たとえばメジャーモードはそれぞれ‘modename-mode-hook’という名前のフックを定義します。メジャーモードは自身が行う最後のこととしてrun-mode-hooksでこのノーマルフックを実行します。Mode Hooksを参照してください。ほとんどのマイナーモードにもフックがあります。

特別な機能によりファイルがロードされたときに評価する式を指定できます(Hooks for Loadingを参照)。この機能は正確にはフックではありませんが同様のことを行います。

activate-mark-hook

deactivate-mark-hook

The Markを参照のこと。

after-change-functions

before-change-functions

first-change-hook

Change Hooksを参照のこと。

after-change-major-mode-hook

change-major-mode-after-body-hook

Mode Hooksを参照のこと。

after-init-hook

before-init-hook

emacs-startup-hook

window-setup-hook

Init Fileを参照のこと。

after-insert-file-functions

write-region-annotate-functions

write-region-post-annotation-function

Format Conversionを参照のこと。

after-make-frame-functions

before-make-frame-hook

Creating Framesを参照のこと。

after-save-hook

before-save-hook

write-contents-functions

write-file-functions

Saving Buffersを参照のこと。

after-setting-font-hook

フレームのフォント変更後に実行されるフック。

auto-save-hook

See Auto-Savingを参照のこと。

before-hack-local-variables-hook

hack-local-variables-hook

File Local Variablesを参照のこと。

buffer-access-fontify-functions

Lazy Propertiesを参照のこと。

buffer-list-update-hook

バッファーリスト変更時に実行されるフック(Buffer Listを参照)。

buffer-quit-function

カレントバッファーをquitするために呼び出されるフック。

change-major-mode-hook

Creating Buffer-Localを参照のこと。

command-line-functions

Command-Line Argumentsを参照のこと。

delayed-warnings-hook

コマンドループはpost-command-hook(以下参照)の直後にこれを実行する。

focus-in-hook

focus-out-hook

Input Focusを参照のこと。

delete-frame-functions

Deleting Framesを参照のこと。

delete-terminal-functions

Multiple Terminalsを参照のこと。

pop-up-frame-function

split-window-preferred-function

Choosing Window Optionsを参照のこと。

echo-area-clear-hook

Echo Area Customizationを参照のこと。

find-file-hook

find-file-not-found-functions

Visiting Functionsを参照のこと。

font-lock-extend-after-change-region-function

Region to Refontifyを参照のこと。

font-lock-extend-region-functions

Multiline Font Lockを参照のこと。

font-lock-fontify-buffer-function

font-lock-fontify-region-function

font-lock-mark-block-function

font-lock-unfontify-buffer-function

font-lock-unfontify-region-function

Other Font Lock Variablesを参照のこと。

fontification-functions

Automatic Face Assignmentを参照のこと。

frame-auto-hide-function

Quitting Windowsを参照のこと。

kill-buffer-hook

kill-buffer-query-functions

Killing Buffersを参照のこと。

kill-emacs-hook

kill-emacs-query-functions

Killing Emacsを参照のこと。

menu-bar-update-hook

Menu Barを参照のこと。

minibuffer-setup-hook

minibuffer-exit-hook

Minibuffer Miscを参照のこと。

mouse-leave-buffer-hook

マウスコマンドでのウィンドウ切り替え時に実行されるフック。

mouse-position-function

Mouse Positionを参照のこと。

prefix-command-echo-keystrokes-functions

(C-uのような)プレフィクスコマンドにより実行されるアブノーマルフックであり、カレントのプレフィクス状態を記述する文字列をリターンすること。たとえばC-uは‘C-u-’や‘C-u 1 2 3-’を生成する。フック関数はそれぞれ引数なしで呼び出されてカレントのプレフィクス状態を記述する文字列、プレフィクス状態がなければnilをリターンすること。Prefix Command Argumentsを参照のこと。

prefix-command-preserve-state-hook

プレフィクスコマンドが次のコマンドにカレントのプレフィクスコマンドを渡すことによりプレフィクスを確保する必要はある際にフックが実行される。たとえばC-uはユーザーがC-u -やC-uの後に数字をタイプした際には、その状態を次のコマンドに渡す必要がある。

pre-redisplay-functions

フックはそれぞれのウィンドウで再表示の直前に実行される。Forcing Redisplayを参照のこと。

post-command-hook

pre-command-hook

Command Overviewを参照のこと。

post-gc-hook

Garbage Collectionを参照のこと。

post-self-insert-hook

Keymaps and Minor Modesを参照のこと。

suspend-hook

suspend-resume-hook

suspend-tty-functions

resume-tty-functions

Suspending Emacsを参照のこと。

syntax-begin-function

syntax-propertize-extend-region-functions

syntax-propertize-function

font-lock-syntactic-face-function

Syntactic Font LockとSyntax Propertiesを参照のこと。

temp-buffer-setup-hook

temp-buffer-show-function

temp-buffer-show-hook

Temporary Displaysを参照のこと。

tty-setup-hook

Terminal-Specificを参照のこと。

window-configuration-change-hook

window-scroll-functions

window-size-change-functions

Window Hooksを参照のこと。

window-text-change-functions

ウィンドウのテキスト変更時の再表示で呼び出す関数。