Changed `events.TAB_CLICKED` to emit button clicked as well as modifier keys.

This allows users to close buffers on middle-click for example.

2 files changed, 9 insertions, 1 deletions

diff --git a/core/events.lua b/core/events.lua
index edd7258b..768f41e0 100644
--- a/core/events.lua
+++ b/core/events.lua
@@ -243,9 +243,17 @@ local M = {}
 --   Emitted when the user clicks on a buffer tab.
 --   When connecting to this event, connect with an index of 1 if the handler
 --   needs to run before Textadept switches between buffers.
+--   Note that Textadept always displays a context menu on right-click.
 --   Arguments:
 --
+--   * _`button`_: The mouse button number that was clicked, either `1` (left
+--     button), `2` (middle button), `3` (right button), `4` (wheel up), or `5`
+--    (wheel down).
 --   * _`index`_: The numeric index of the clicked tab.
+--   * _`shift`_: The "Shift" modifier key is held down.
+--   * _`ctrl`_: The "Control" modifier key is held down.
+--   * _`alt`_: The "Alt"/"Option" modifier key is held down.
+--   * _`meta`_: The "Command" modifier key on Mac OSX is held down.
 -- @field UPDATE_UI (string)
 --   Emitted after the view is visually updated.
 --   Arguments:
diff --git a/core/ui.lua b/core/ui.lua
index ae01d69f..b0cce5d7 100644
--- a/core/ui.lua
+++ b/core/ui.lua
@@ -278,7 +278,7 @@ events_connect(events.VIEW_NEW, function() events.emit(events.UPDATE_UI) end)
 
 -- Switches between buffers when a tab is clicked.
 events_connect(events.TAB_CLICKED,
-               function(index) view:goto_buffer(_BUFFERS[index]) end)
+               function(button, index) view:goto_buffer(_BUFFERS[index]) end)
 
 -- Sets the title of the Textadept window to the buffer's filename.
 local function set_title()