Previous: Manipulating Buttons, Up: Buttons [Contents][Index]
Emacsバッファー内にボタンの配置や操作を行うコマンドや関数が存在します。
push-buttonはユーザーが実際にボタンを押下(push)するために使用するコマンドであり、そのボタンのオーバーレイプロパティかテキストプロパティを使用することにより、そのボタンのRETとmouse-2にデフォルトでバインドされます。ボタン自身の外部で有用なforward-buttonやbackward-buttonのようなコマンドは、button-buffer-mapに格納されたキーマップ内で追加で利用可能です。ボタンを使用するモードはそのキーマップの親キーマップとしてbutton-buffer-mapの使用を望むかもしれません。かわりにbutton-modeをオンに切り替えれば、ほぼ同様の効果を得ることができます。これはマイナーモードキーマップとしてbutton-buffer-mapをインストールするだけのマイナーモードです。
ボタンが非nilのfollow-linkプロパティをもち、かつmouse-1-click-follows-linkがセットされている場合には、素早いmouse-1クリックによりpush-buttonコマンドもアクティブになるでしょう。Clickable Textを参照してください。
位置posにあるボタンが指定するアクションを行う。posはバッファー位置、またはマウスイベントのいずれか。use-mouse-actionが非nil、またはposがマウスイベントならactionのかわりにそのボタンのmouse-actionプロパティの呼び出しを試みて、ボタンにmouse-actionプロパティがなければ通常のようにactionを使用する。push-buttonがマウスイベントの結果としてインタラクティブに呼び出されたときはそのマウスイベントの位置、それ以外ではポイントの位置がposのデフォルトになる。posにボタンがなければ何もせずにnilをリターンして、それ以外ならtをリターンする。
次のn番目、nが負なら前のn番目のボタンに移動する。nが0ならポイント位置にある任意のボタンの開始に移動する。wrapが非nilならバッファーの先頭または終端を超えてもう一方の端へ移動を継続する。display-messageが非nilならボタンのhelp-echo文字列が表示される。非nilのskipプロパティをもつボタンはすべてスキップされる。見つかったボタンをリターンするか、ボタンが見つからなければエラーをシグナルする。no-errorが非nilなら、エラーをシグナルするかわりにnilをリターンする。
前のn番目、nが負なら次のn番目のボタンに移動する。nが0ならポイント位置にある任意のボタンの開始に移動する。wrapが非nilならバッファーの先頭または終端を超えて、もう一方の端へ移動を継続する。display-messageが非nilならボタンのhelp-echo文字列が表示される。非nilのskipプロパティをもつボタンはすべてスキップされる。見つかったボタンをリターンするか、ボタンが見つからなければエラーをシグナルする。no-errorが非nilなら、エラーをシグナルするかわりにnilをリターンする。
カレントバッファー内の位置posの次(next-buttonの場合)、または前(previous-buttonの場合)のボタンをリターンする。count-currentが非nilなら、次のボタンから検索を開始するかわりにposにある任意のボタンを考慮する。