Mercurial > emacs
changeset 59505:19b4e3d63aed
(Button Properties, Button Buffer Commands):
Clarify mouse-1 and follow-link functionality.
| author | Kim F. Storm <storm@cua.dk> |
|---|---|
| date | Wed, 12 Jan 2005 15:33:00 +0000 |
| parents | 66f927c186ac |
| children | 3da5314608ab |
| files | lispref/display.texi |
| diffstat | 1 files changed, 10 insertions(+), 7 deletions(-) [+] |
line wrap: on
line diff
--- a/lispref/display.texi Wed Jan 12 15:32:47 2005 +0000 +++ b/lispref/display.texi Wed Jan 12 15:33:00 2005 +0000 @@ -4049,9 +4049,8 @@ @kindex keymap @r{(button property)} The button's keymap, defining bindings active within the button region. By default this is the usual button region keymap, stored -in the variable @code{button-map}, which defines @key{RET}, -@key{mouse-1} (if @var{mouse-1-click-follows-link} is set), -and @key{mouse-2} to invoke the button. +in the variable @code{button-map}, which defines @key{RET} and +@key{mouse-2} to invoke the button. @item type @kindex type @r{(button property)} @@ -4066,8 +4065,9 @@ @item follow-link @kindex follow-link @r{(button property)} -The follow-link property, defining how a @key{mouse-1} click behaves -on this button, @xref{Enabling Mouse-1 to Follow Links}. +The follow-link property, defining how a @key{Mouse-1} click behaves +on this button, @xref{Links and Mouse-1}. + @item button @kindex button @r{(button property)} All buttons have a non-@code{nil} @code{button} property, which may be useful @@ -4239,8 +4239,7 @@ buttons in an Emacs buffer. @code{push-button} is the command that a user uses to actually `push' -a button, and is bound by default in the button itself to @key{RET}, -to @key{mouse-1} (if @var{mouse-1-click-follows-link} is set), +a button, and is bound by default in the button itself to @key{RET} and to @key{mouse-2} using a region-specific keymap. Commands that are useful outside the buttons itself, such as @code{forward-button} and @code{backward-button} are additionally @@ -4248,6 +4247,10 @@ which uses buttons may want to use @code{button-buffer-map} as a parent keymap for its keymap. +If the button has a non-@code{nil} @code{follow-link} property, and +@var{mouse-1-click-follows-link} is set, a @key{Mouse-1} click will +also activate the @code{push-button} command. + @deffn Command push-button &optional pos use-mouse-action @tindex push-button Perform the action specified by a button at location @var{pos}.