39.19.4 ボタンの操作

ボタンのプロパティの取得やセットを行う関数が存在します。これらは何を行うかを判断するためにボタンが呼び出す関数からよく使用される関数です。

buttonパラメーターが指定された場合にはオーバーレイ(オーバーレイボタンの場合)、またはバッファー位置やマーカー(テキストプロパティボタンの場合)いずれかという、特定のボタンを参照するオブジェクトを意味します。そのようなオブジェクトはボタンが関数を呼び出す際に1つ目の引数として渡されます。

Function: button-start button

buttonが開始される位置をリターンする。

Function: button-end button

buttonが終了する位置をリターンする。

Function: button-get button prop

ボタンbuttonのpropという名前のプロパティを取得する。

Function: button-put button prop val

buttonのpropプロパティにvalをセットする。

Function: button-activate button &optional use-mouse-action

buttonのactionプロパティを呼び出す(単一の引数buttonを渡してプロパティの値である関数を呼び出す)。use-mouse-actionが非nilなら、actionのかわりにそのボタンのmouse-actionプロパティの呼び出しを試みる。ボタンがmouse-actionプロパティをもたなければ通常どおりactionを使用する。

Function: button-label button

buttonのテキストラベルをリターンする。

Function: button-type button

buttonのボタンタイプをリターンする。

Function: button-has-type-p button type

buttonがボタンタイプtype、またはtypeのsubtypeのいずれかをもつならtをリターンする。

Function: button-at pos

カレントバッファー内の位置posにあるボタン、またはnilをリターンする。posにあるボタンがテキストプロパティボタンならリターン値はposを指すマーカー。

Function: button-type-put type prop val

ボタンタイプtypeのpropプロパティにvalをセットする。

Function: button-type-get type prop

ボタンタイプtypeのpropという名前のプロパティを取得する。

Function: button-type-subtype-p type supertype

ボタンタイプtypeがsupertypeのsubtypeならtをリターンする。