42.26 ツールチップ

ツールチップ(Tooltips)はマウスポインターのカレント位置に関連するヘルプ的なヒント(別名“tips”)の表示に使用される特別なフレームです(フレームを参照)。Emacsはテキストのアクティブ範囲(特殊な意味をもつプロパティを参照)、およびメニューアイテム(拡張メニューアイテムを参照)やツールバーのボタン(ツールバーを参照)のような種々のUI要素に関するヘルプ文字列の表示にツールチップを使用します。

Function: tooltip-mode

Tooltipモードはツールチップの表示を有効にするマイナーモード。このモードをオフにするとツールチップはエコーエリアに表示される。テキストモード(別名“TTY”)のフレームでは、ツールチップは常にエコーエリアに表示される。

GTK+ツールキットかHaikuのウィンドウシステムのサポート付きでEmacsがビルドされた際にはデフォルトではツールキット機能を使用してツールチップを表示して、ツールチップの外観はツールキットのセッティングにより制御されます。ツールキットが提供するツールチップは変数use-system-tooltipsの値をnilに変更して無効にできます。このセクションの残りではEmacs自身が提供する非ツールキットのツールチップを制御する方法を説明します。

ツールチップは独自のパラメーターをもつツールチップフレームと呼ばれる特別なフレームに表示されます(フレームのパラメーターを参照)。他のフレームとは異なり、ツールチップフレームのデフォルトパラメターは特別な変数に格納されています。

User Option: tooltip-frame-parameters

このカスタマイズ可能なオプションはツールチップ表示に使用するデフォルトのフレームパラメーターを保持する。フォントとカラーに関するパラメーターは無視して、tooltipフェイスの対応する属性をかわりに使用する。lefttopのパラメーターが含まれていれば、ツールチップを表示すべきフレームに相対的な絶対座標として使用する(Tooltips in The GNU Emacs Manualに記された変数を使用すればマウスに相対的なツールチップをカスタマイズできる)。lefttopのパラメーターが与えられた場合にはマウスに相対的なオフセットをオーバーラードすることに注意。

tooltipフェイスはツールチップ内に表示されるテキストの見栄えを決定します。デフォルトのフレームフォントより一般的にはサイズの小さい可変ピッチフォントの使用が必要になります。

Variable: tooltip-functions

これはEmacsがツールチップの表示を必要とする際に呼び出す関数のリストであるようなアブノーマルフック。関数はそれぞれ最後のマウス移動イベントであるeventを単一の引数として呼び出される。このリスト上の関数が実際にツールチップを表示するなら非nilをリターンして、残りの関数は呼び出されない。この変数のデフォルト値はtooltip-help-tipsという1つの関数。

tooltip-functionsのリストに配置する関数を独自に記述する場合には、ツールチップの表示をトリガーしたマウスイベントのバッファーを知る必要があるかもしれません。以下はこの情報を提供する関数です。

Function: tooltip-event-buffer event

この関数はeventが発生したバッファーをリターンする。テキストがツールチップをトリガーしたバッファーを取得するために、これをtooltip-functionsの関数の引数で呼び出す。イベントはバッファーではないところ(たとえばツールバー)で発生したかもしれず、そのような場合にはこの関数はnilをリターンする。

ツールチップ表示に関する他の側面は、いくつかのカスタマイズ可能なセッティングにより制御されます。Tooltips in The GNU Emacs Manualを参照してください。

This page has generated for branch:work/emacs-30_69b16e5c63840479270d32f58daea923fe725b90, commit:5e3f74b56ff47b5bcef2526c70f53f749bbd45f6 to check Japanese translation.